Docker Context是Docker提供的环境配置管理机制，通过打包主机地址、TLS设置、平台等配置为可命名上下文，支持用docker context use一键切换本地、远程或Swarm集群等环境，无需修改DOCKER_HOST或重写命令。

Docker Context 是 Docker 提供的环境配置管理机制，能让你在不修改 DOCKER_HOST 或重写命令的情况下，快速切换本地、远程或 Swarm 集群等不同运行环境。它本质是把主机地址、TLS 设置、平台、命名空间等配置打包成一个可命名的上下文，再通过 docker context use 一键激活。

创建远程宿主机 Context

前提：目标远程宿主机已开启 Docker daemon 的 TCP 远程访问（推荐配合 TLS 认证），并确保本地有对应的 client 证书（ca.pem、cert.pem、key.pem）。

使用 docker context create 命令创建：

Docker Encyclopedia

Docker 文档优先工作流：针对 Docker 特定问题、故障排除、命令规划、镜像/构建、容器/运行时操作及 Compose 等

下载

• 基本语法（含 TLS）：
  docker context create my-remote-host \
--docker host=ssh://user@192.168.1.100 \
--docker ca-path=/path/to/ca.pem \
--docker cert-path=/path/to/cert.pem \
--docker key-path=/path/to/key.pem
• 若使用 SSH 连接（Docker 20.10+ 推荐，更安全免 TLS 配置）：
  docker context create my-ssh-host --docker host=ssh://user@192.168.1.100
• 验证是否创建成功：
  docker context ls —— 查看所有上下文，新创建的会显示在列表中，当前激活项带 * 标记

切换与验证当前 Context

切换只需一条命令，无需重启终端或改环境变量：

• docker context use my-remote-host —— 激活指定上下文
• docker context use default —— 切回本地默认环境
• 验证是否生效：
  docker info | grep "Name\|Server Version\|Operating System" —— 输出应反映远程宿主机信息
  docker ps —— 列出的是远程主机上的容器，不是本机

批量管理多个远程 Context（适合运维/多集群场景）

可将常用 Context 导出为 JSON 文件，便于备份、分发或 CI/CD 中复用：

• docker context export my-remote-host > my-remote-host.json
• docker context import prod-cluster ./prod-cluster.json
• 脚本化切换（例如日常开发 vs 测试环境）：
  写个简单 shell 函数放入 ~/.bashrc：
  dc-prod() { docker context use prod-cluster && echo "→ Using production cluster"; }
dc-dev() { docker context use dev-vm && echo "→ Using dev VM"; }

常见问题与注意点

• SSH 方式需确保本地有对应 SSH key 且远程用户在 docker 用户组中，否则执行 docker 命令会权限拒绝
• TLS 方式务必校验证书路径正确，且 ca.pem 必须由签发 cert.pem 的 CA 生成，否则连接失败
• Context 不影响镜像缓存或构建上下文路径——docker build 仍从本地读取文件，只是 build 结果推送到当前 Context 对应的 daemon
• Kubernetes 用户注意：Docker Desktop 的 Kubernetes 集成只作用于 default Context，切换后需手动启用或改用 kind/minikube 独立管理