容器与云原生 / 系统课时
管理 Docker Context
管理 Docker Context
当一台电脑需要同时操作本地 Docker 和远程 Docker 节点时,反复修改环境变量很容易连错目标。Docker Context 把连接端点和相关配置保存成命名上下文,让同一套 docker 命令可以安全地查看、切换和临时指定不同节点。
学习目标
- 理解 Docker Context 保存的连接信息以及它解决的问题
- 能创建、查看并切换到远程 Docker Context
- 能在切换前后验证命令实际连接的是哪个 Docker 节点
Context 保存的是什么
一个 Context 可以包含 Docker endpoint、TLS 相关信息和元数据。CLI 每次执行命令时,会根据当前选择的 Context 决定连接哪个 Docker daemon,因此“命令相同、目标不同”成为可管理的显式状态。

图中的关键点是:Context 只是 CLI 的连接配置。切换 Context 不会把镜像、容器或卷从一个节点搬到另一个节点;每个 Docker daemon 仍维护自己的资源。
创建并切换远程节点
下面示例假设远程 Linux 主机已经运行 Docker Engine,并且本机可以通过 SSH 登录,远程用户也有权限访问 Docker daemon。执行前把 <USER> 和 <IP> 替换为实际 SSH 用户名和主机地址,并确保尚未存在名为 edge 的 Context。
docker context create edge --docker "host=ssh://<USER>@<IP>"
docker context use edge
docker context show
docker info --format 'ServerVersion={{.ServerVersion}}'
docker context use default
docker context show预期输出
<VALUE>
<VALUE>
edge
ServerVersion=<VALUE>
<VALUE>
default不同 Docker CLI 版本对创建成功和切换成功的提示文字可能略有差异,因此对应位置用 <VALUE> 表示。真正需要核对的是 docker context show:切换后应显示 edge,切回后应显示 default。
查看 Context 与临时指定目标
日常管理时,可以用 docker context ls 查看所有 Context,用 docker context inspect edge 检查某个 Context 的 endpoint。若只想让单条命令访问远程节点,不必改变全局当前 Context,可使用 docker --context edge ps。
这种临时指定方式适合做发布前检查或脚本中的一次性操作,因为命令执行完后,当前 Context 不会改变。交互式排查则更适合先执行 docker context use <NAME>,再连续运行多条诊断命令。
避免环境变量覆盖选择
排查“明明切到了 edge,却仍然连到别处”时,要检查当前 shell 是否设置过 DOCKER_HOST 或 DOCKER_CONTEXT。这些变量会影响 CLI 选择连接目标,容易让 Context 的显式切换结果变得难以判断。
连接失败时按链路排查
远程 Context 失败时先检查 SSH 是否能独立登录,再检查远程用户是否有 Docker 权限,最后检查 Context endpoint 是否写对。permission denied 往往是远程 Docker socket 权限问题,连接被拒绝或 SSH 超时则应先处理网络与 SSH 服务。
当 Context 数量较多时,给名称加入明确的环境或用途,例如 dev-local、staging-edge、prod-a,比使用 server1、server2 更不容易误操作。真正执行高风险命令前,再用 docker context show 做一次目标确认。