与 HashiCorp Consul 集成
HashiCorp Consul 维护一个记录服务实例及其健康状态的服务目录。通过服务发现,APISIX 可以监视在 Consul 服务名称下注册的健康实例,并将其用作动态上游节点。
本指南将启动一个 Consul 服务器和两个示例服务,为这两个服务注册健康检查,并配置 APISIX 发现健康实例并在它们之间进行负载均衡。
信息
本教程在同一 Docker 网络中运行 APISIX、Consul 和示例服务。生产部署应使用 APISIX 实例可以访问的地址。
如果所有服务都在 Kubernetes 中运行,通常不需要 Consul,因为 Kubernetes 可以通过 Service 和 DNS 提供服务发现。

前置条件
- 安装 Docker。
- 安装 cURL 和 jq,用于发送请求和检查 Consul 响应。
- 按照快速入门教程,使用 Docker 启动 APISIX。
- 如果需要使用 ADC 配置 APISIX,请安装 ADC。
- 如果使用 Admin API 示例且启用了身份验证,请将管理员角色的密钥导出为
ADMIN_API_KEY。请在deployment.admin.admin_key下配置该密钥。Docker 快速入门为了便于本地评估而禁用了身份验证;生产环境中请保持启用。
启动 Consul
在 APISIX 快速入门网络中启动一个 Consul 服务器。端口 8500 绑定到环回接口,以供本地访问 API:
docker run \
--name consul \
-d \
-p 127.0.0.1:8500:8500 \
--network apisix-quickstart-net \
hashicorp/consul:2.0.3 \
consul agent \
-server \
-bootstrap-expect=1 \
-node=consul-server \
-client 0.0.0.0 \
-log-level info \
-data-dir=/consul/data
Consul Agent 会监听容器内的所有接口,使 APISIX 能够访问它;发布到主机的端口则仅限环回接口访问。