端口参考

AISIX AI 网关监听端口在启动配置中设置。快速上手和自托管示例使用下列端口，以避免代理、Admin API 和 etcd 端点相互冲突。

端口	用途方	作用	暴露范围
`3000`	代理监听端口	接收面向调用方的 AI API 请求，例如 `/v1/chat/completions` 和 `/v1/models`。	仅暴露给预期调用方，或暴露给网关前置的入口层。
`3001`	Admin 监听端口	接收自托管 Admin API 请求，用于创建和更新动态资源，也可提供健康检查和 OpenAPI 路由。	保持在 loopback、私有子网或仅限管理员访问的网络中。
`9090`	指标/状态监听端口	提供已配置的 Prometheus 抓取路径，以及 `/status/models` 等运维状态路由。自托管和托管网关镜像启用 Prometheus 指标时默认绑定该端口。	仅对 Prometheus 和监控系统开放。此监听器上的状态路由不需要应用身份认证。
`2379`	etcd 客户端监听端口	存储自托管部署的动态网关配置。	仅对 AISIX 和管理网关配置的系统开放。

配置监听端口

使用 proxy.addr 设置代理监听端口：

proxy:
  addr: "0.0.0.0:3000"

使用 admin.addr 设置自托管 Admin 监听端口：

admin:
  addr: "127.0.0.1:3001"

启动配置必须包含代理监听地址。Admin 监听端口默认是 127.0.0.1:0，因此自托管部署如果需要使用 Admin API，必须设置 admin.addr。

如需修改专用指标/状态监听器地址，请设置 observability.metrics.prometheus.addr。启用 Prometheus 指标时，该监听器会运行并默认使用 0.0.0.0:9090。Admin API 永远不会提供 /metrics 或运维 /status/* 路由：

observability:
  metrics:
    prometheus:
      enabled: true
      path: "/metrics"
      addr: "0.0.0.0:9090"

指标/状态监听器还会提供 /status/config、/status/ready 和 /status/models。这些运维路由不受 Admin Key 保护。请将监听器绑定到私有接口，或通过网络策略或防火墙规则限制访问。

配置监听端口​

配置监听端口