docker客户端本身不支持自动多节点切换，需通过docker_host变量手动指定目标守护进程地址；swarm模式下应连接任一manager节点，故障时由集群自动接管，无需客户端切换。
客户端与守护进程通信时，不需要“配置客户端多节点切换”——这个说法本身存在概念混淆。docker 客户端（docker 命令）默认连接的是本地 docker 守护进程（dockerd），它不内置集群路由或自动切换能力。所谓“多节点切换”，实际是**手动或脚本化地指定不同宿主机的守护进程地址**，本质是更换客户端的通信目标，而非客户端自身具备高可用切换逻辑。
明确通信机制：客户端靠 DOCKER_HOST 控制连接目标
Docker 客户端通过 DOCKER_HOST 环境变量决定连接哪个守护进程，默认值是 unix:///var/run/docker.sock（本地 Unix 套接字）。要连远程节点，只需临时或持久设置该变量：
- 连 manager1：
export DOCKER_HOST=tcp://192.168.1.10:2377 - 连 manager2：
export DOCKER_HOST=tcp://192.168.1.11:2377 - 切回本地：
unset DOCKER_HOST或设为unix:///var/run/docker.sock
注意：远程连接需在目标节点的 dockerd 启动时显式监听 TCP（如 --host tcp://0.0.0.0:2377），且开放防火墙端口；生产环境强烈建议启用 TLS 认证，避免裸 TCP 暴露。
Swarm 场景下：客户端只连一个 manager，不需手动切换
在 Docker Swarm 集群中，所有 manager 节点都维护完整集群状态（Raft 共识），客户端只需连接任意一个健康 manager 即可执行集群操作（如 docker service ls、docker stack deploy）。Swarm 内部自动同步状态，你无需、也不应该在多个 manager 间轮询或故障切换客户端连接。
MiniMax 图片理解 + 网络搜索 MCP 工具。适配 Docker 环境（极空间等），支持图片 OCR 识别、图像内容理解、网络搜索。API Key 安全存储在本地 credentials 文件，不暴露在代码中。
- manager 故障时，其他 manager 自动接管，客户端只要重试命令即可（例如用
docker node ls确认新 leader） - 若当前连接的 manager 宕机，客户端会报错（如 “Cannot connect to the Docker daemon”），此时手动改
DOCKER_HOST指向另一个 manager 是可行的应急手段，但不是常规流程
真正需要“自动切换”的场景：用代理或负载均衡器
如果希望客户端无感访问 Swarm 集群（比如 CI/CD 流水线固定连一个地址），可在前端加一层 TCP 负载均衡器（如 HAProxy、Nginx TCP mode 或云厂商 NLB），后端指向全部 manager 节点的 2377 端口：
- 配置健康检查，自动剔除离线 manager
- 客户端始终连负载均衡器 VIP，无需感知后端变化
- 注意：TLS 终止位置需统一（要么 LB 终止并重加 TLS 到 dockerd，要么直通 TLS 连接）
替代方案：用 docker context 管理多环境
比反复修改 DOCKER_HOST 更规范的方式是使用 docker context：
- 创建上下文：
docker context create mgr1 --docker "host=tcp://192.168.1.10:2377" - 切换上下文：
docker context use mgr1 - 列出所有上下文：
docker context ls
每个 context 可独立配置 TLS 证书、平台、命名空间等，适合开发、测试、生产多环境隔离，也便于脚本调用（docker --context mgr1 service ls）。
