端口参考
AISIX AI 网关监听端口在启动配置中设置。快速上手和自托管示例使用下列端口,以避免代理、Admin API 和 etcd 端点相互冲突。
| 端口 | 用途方 | 作用 | 暴 露范围 |
|---|---|---|---|
3000 | 代理监听端口 | 接收面向调用方的 AI API 请求,例如 /v1/chat/completions 和 /v1/models。 | 仅暴露给预期调用方,或暴露给网关前置的入口层。 |
3001 | Admin 监听端口 | 接收自托管 Admin API 请求,用于创建和更新动态资源,也可提供健康检查和 OpenAPI 路由。 | 保持在 loopback、私有子网或仅限管理员访问的网络中。 |
9090 | 专用指标监听端口 | 通过 observability.metrics.prometheus.addr 配置的 Prometheus 抓取监听端口。自托管和托管网关镜像启用 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。
只有当 Prometheus 需要从独立于 Admin API 的监听端口抓取指标时,才需要设置 observability.metrics.prometheus.addr:
observability:
metrics:
prometheus:
enabled: true
path: "/metrics"
addr: "0.0.0.0:9090"