跳到主要内容
版本：3.10.x

API7 网关数据面配置参考

API7 网关数据面（DP）处理所有传入流量，并应用控制面定义的策略。本页提供数据面配置参考。

概述​

数据面配置通常通过 config.yaml 文件进行管理，该文件会覆盖 config-default.yaml 中的默认设置。

核心配置​

配置核心工作进程和文件限制。

apisix:
  worker_processes: auto # 自动设置为 CPU 核心数
  worker_rlimit_nofile: 1024000 # 每个 worker 进程可打开的最大文件数

监听端口​

配置不同类型流量的端口。

apisix:
  node_listen:
    - port: 9080 # 默认 HTTP 端口
    - port: 9443 # 默认 HTTPS 端口

代理缓存配置​

启用并配置缓存以提高性能并减少上游负载。

apisix:
  proxy_cache:
    cache_ttl: 10s
    zones:
      - name: disk_cache_one
        memory_size: 50m
        disk_size: 1g
        disk_path: "/tmp/disk_cache_one"
        cache_levels: "1:2"

路由模式​

指定用于将传入请求与路由进行匹配的路由模式。

apisix:
  router:
    http: radixtree_uri # 默认路由模式

TLS 设置​

为传入的 HTTPS 请求配置 TLS 行为。

apisix:
  ssl:
    ssl_protocols: "TLSv1.2 TLSv1.3"
    ssl_ciphers: "ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256"

状态 API 端点​

公开存活和就绪端点。存在 status 配置块即会启用监听器；该配置块没有 enabled 字段。

apisix:
  status:
    ip: 127.0.0.1
    port: 7085

网关启动后，/status 端点返回 200。当所有已配置的 DP Manager 端点都不可用时，/status/ready 端点返回 503。如果探针在网关容器或宿主机外部运行，请将 ip 从 127.0.0.1 改为探针可访问的地址。

自定义插件路径​

将自定义插件加载到 API7 网关中。

apisix:
  extra_lua_path: "/usr/local/apisix/plugins/?.lua"

环境变量​

使用环境变量动态配置数据面节点。

# 在 config.yaml 中使用 ${VAR_NAME} 语法
apisix:
  node_listen:
    - port: ${GATEWAY_PORT}

后续步骤​