Consul 官方镜像文档

镜像概述

Consul 是 HashiCorp 开发的开源服务网格解决方案，提供服务发现、配置管理、分布式一致性和服务网格能力。本镜像为官方维护的公共镜像，封装了 Consul 服务端/客户端程序，可快速部署用于构建弹性微服务架构和分布式系统。

核心功能与特性

核心功能

• 服务发现：自动注册和发现服务实例，支持DNS和HTTP两种查询方式
• 健康检查：内置多种健康检查机制（HTTP、TCP、gRPC、脚本等），确保服务可用性
• 分布式KV存储：提供高可用键值对存储，用于配置管理、特征标记等场景
• 多数据中心支持：原生支持跨数据中心部署，实现全球服务发现
• 服务网格：通过Sidecar代理实现流量管理、熔断和故障注入

关键特性

• 高可用架构：基于Raft共识算法的分布式集群，支持自动故障转移
• 安全强化：内置TLS加密、ACL访问控制、JWT认证等安全机制
• 可扩展性：水平扩展的服务端集群，支持动态添加/移除节点
• Web UI：内置可视化管理界面，直观监控服务状态和集群健康度

使用场景

• 微服务架构：作为服务注册中心，解决服务间发现与通信问题
• 配置中心：集中管理分布式系统的动态配置，支持配置热更新
• 服务监控：通过健康检查实时监控服务状态，触发告警或自动恢复
• 多区域部署：跨数据中心服务发现，构建全球分布式系统
• DevOps自动化：集成CI/CD流程，实现服务部署与配置的自动化管理

使用方法

基本使用

1. 拉取镜像

docker pull consul

2. 开发模式启动（快速测试）

docker run -d \
  --name consul-dev \
  -p 8500:8500 \  # HTTP API/UI端口
  -p 8600:8600/udp \  # DNS端口
  consul agent -dev -client=0.0.0.0

说明：-dev 模式为单节点开发环境，数据存储在内存中（重启丢失），-client=0.0.0.0 允许外部访问

3. 访问Web UI

启动后通过 http://localhost:8500 访问Consul Web管理界面，可查看服务列表、健康状态和KV存储数据。

生产环境部署

单节点持久化部署

docker run -d \
  --name consul-server \
  -p 8300:8300 \  # 服务器内部通信端口
  -p 8301:8301/tcp \  # Serf LAN端口（TCP）
  -p 8301:8301/udp \  # Serf LAN端口（UDP）
  -p 8302:8302/tcp \  # Serf WAN端口（TCP）
  -p 8302:8302/udp \  # Serf WAN端口（UDP）
  -p 8500:8500 \  # HTTP API/UI端口
  -p 8600:8600/udp \  # DNS端口
  -v /data/consul:/consul/data \  # 持久化数据卷
  consul agent \
    -server \  # 以服务器模式启动
    -bootstrap-expect=1 \  # 单节点集群（生产建议3-5节点）
    -data-dir=/consul/data \  # 数据存储目录
    -bind=0.0.0.0 \  # 绑定地址（容器内所有网卡）
    -client=0.0.0.0 \  # 允许外部访问API的客户端地址
    -ui  # 启用Web UI

多节点集群部署（3节点示例）

# 节点1（引导节点）
docker run -d \
  --name consul-server-1 \
  --net=host \  # 使用主机网络（简化节点通信，生产建议自定义网络）
  -v /data/consul/node1:/consul/data \
  consul agent \
    -server \
    -bootstrap-expect=3 \
    -data-dir=/consul/data \
    -bind=<节点1IP> \
    -client=0.0.0.0 \
    -ui

# 节点2（加入集群）
docker run -d \
  --name consul-server-2 \
  --net=host \
  -v /data/consul/node2:/consul/data \
  consul agent \
    -server \
    -data-dir=/consul/data \
    -bind=<节点2IP> \
    -client=0.0.0.0 \
    -join=<节点1IP>

# 节点3（加入集群）
docker run -d \
  --name consul-server-3 \
  --net=host \
  -v /data/consul/node3:/consul/data \
  consul agent \
    -server \
    -data-dir=/consul/data \
    -bind=<节点3IP> \
    -client=0.0.0.0 \
    -join=<节点1IP>

Docker Compose配置示例

version: '3.8'
services:
  consul:
    image: consul:latest
    container_name: consul-server
    ports:
      - "8500:8500"   # HTTP API/UI
      - "8600:8600/udp" # DNS
      - "8300:8300"   # Server RPC
      - "8301:8301/tcp" # Serf LAN (TCP)
      - "8301:8301/udp" # Serf LAN (UDP)
    volumes:
      - consul-data:/consul/data
    command: agent -server -bootstrap-expect=1 -data-dir=/consul/data -bind=0.0.0.0 -client=0.0.0.0 -ui
    restart: unless-stopped

volumes:
  consul-data:

常用配置参数

注意事项

• 生产环境禁止使用-dev模式：开发模式数据不持久化，且安全机制未启用
• 数据持久化：必须挂载数据卷（-v）以防止容器重启后数据丢失
• 集群规模：生产环境建议3-5个服务器节点（Raft共识算法要求奇数节点）
• 安全配置：启用TLS加密（-tls-config-file）和ACL访问控制（-acl-file）
• 资源限制：根据集群规模配置CPU/内存资源（建议最低2核4GB）

参考链接

• Consul官方文档
• Docker Hub镜像页