跳到主要内容

端口参考

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

端口用途方作用暴露范围
3000代理监听端口接收面向调用方的 AI API 请求,例如 /v1/chat/completions/v1/models仅暴露给预期调用方,或暴露给网关前置的入口层。
3001Admin 监听端口接收自托管 Admin API 请求,用于创建和更新动态资源,也可提供健康检查和 OpenAPI 路由。保持在 loopback、私有子网或仅限管理员访问的网络中。
9090专用指标监听端口通过 observability.metrics.prometheus.addr 配置的 Prometheus 抓取监听端口。自托管和托管网关镜像启用 Prometheus 指标时默认绑定该端口。仅对 Prometheus 或监控网络开放。
2379etcd 客户端监听端口存储自托管部署的动态网关配置。仅对 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"