Docker Context 怎么切换远程守护进程

Docker CLI 不必靠反复修改 DOCKER_HOST 才能连接不同守护进程。把本机和远程 Engine 分别保存成 Docker Context 后，日常用 docker context use remote-prod 切换，切回本机只需选择 default。真正要避免的是“切换成功了，却没有确认后续命令到底发给谁”。

官方地址：https://docs.docker.com/engine/manage-resources/contexts/

1. 先确认当前 CLI 指向哪里

打开“终端 → Docker CLI”入口，先不要急着创建远端目标。运行下面两条命令，确认客户端支持 context，并记录当前星号所在行：

# 列出客户端已保存的连接目标，星号表示当前默认目标。
docker context ls

# 查看客户端与当前 Engine 的基本信息，先建立本机基线。
docker version

新安装环境通常只有 default，endpoint 常见为 unix:///var/run/docker.sock。如果当前星号已经在某个远程 context，先记下名称，避免把后面的“创建”和“切换”混为一件事。

2. 创建 SSH 远程 context：先把目标保存下来

在“终端 → Docker CLI → Contexts 管理”路径中，使用下面的命令创建一个有辨识度的名称。这里的主机名和用户只是示例，换成你已经能通过 SSH 登录的目标：

# 用 SSH endpoint 保存远端 Docker Engine，不直接开启未加密 TCP 访问。
docker context create remote-prod \
  --description="Remote engine over SSH" \
  --docker "host=ssh://deploy@engine.example.com"

# 查看刚创建的 endpoint、描述和元数据。
docker context inspect remote-prod

创建成功只说明配置被保存，不代表当前 CLI 已经切换。远端登录用户还必须有权限访问 Docker socket；若这里返回 SSH 拒绝或 socket permission denied，先修复 SSH 用户、主机名和远端权限，再进行下一步。

3. 切换后用三个信号确认远程守护进程

在“终端 → Docker CLI → Contexts → 选择 remote-prod”路径执行切换：

# 把当前 Docker CLI 默认目标切到远程 Engine。
docker context use remote-prod

# 星号应移动到 remote-prod，确认默认选择确实改变。
docker context ls

# 查看远端 Server 信息，再列出远端容器作为第二、第三个信号。
docker info
docker ps

验收顺序建议固定为“星号 → Server → 容器”。只看到 Current context is now 还不够：星号证明选择状态，docker info 证明 Engine 响应，docker ps 则帮助你确认看到的是远端容器集合。

4. 单次任务用覆盖参数，减少误操作

如果只是临时查看远端，不想改变默认 context，可在“终端 → Docker CLI → 单次命令”路径使用全局 --context：

# 只把这一条命令发到远程目标，不改变默认 context。
docker --context remote-prod ps

# 用环境变量临时指定当前 shell 的目标；结束后主动清除。
export DOCKER_CONTEXT=remote-prod
docker info
unset DOCKER_CONTEXT

判断优先级时记住：命令行的 --context 适合一次性覆盖，DOCKER_CONTEXT 会覆盖 docker context use 设置的默认值。脚本里最好显式写 --context，让目标随脚本可见，避免依赖操作者当前 shell 的隐藏环境变量。

5. 切回本机与常见失败排查

远程操作结束后，在“终端 → Docker CLI → Contexts → Local default”路径执行：

# 任务结束显式切回本机，避免下一条命令误操作远端。
docker context use default

# 再次确认 default 带星号，并检查本机 Docker Engine 是否响应。
docker context ls
docker info

排查可以按四层进行：第一层用 ssh deploy@engine.example.com 确认网络和登录；第二层检查 context 名称是否拼写一致；第三层核对远端用户是否能访问 Docker socket；第四层检查当前 shell 是否仍设置了 DOCKER_CONTEXT。如果 docker context ls 显示 default 带星号但命令仍打到远端，优先检查环境变量和命令中的 --context。

常见问题

创建 context 后为什么还在操作本机？

docker context create 只保存目标，不会自动切换。执行 docker context use remote-prod，再用星号和 docker info 验证。

远端必须开放 2375 端口吗？

不需要。SSH context 通过 SSH 访问远端 Docker socket；是否能使用取决于 SSH 登录和 socket 权限。不要为了省步骤把未加密 Docker TCP 端口直接暴露到公网。

怎么只让脚本使用远程 context？

给每条命令加 --context remote-prod，比依赖全局默认值或隐式环境变量更容易审查和复现。

切回 default 仍然连接不上怎么办？

先确认 default 带星号，再检查本机 Docker Engine 是否启动；同时运行 env | grep DOCKER_CONTEXT，排除残留环境变量覆盖。