Docker CLI连接参数优先级为：命令行参数＞环境变量＞配置文件＞默认值。关键环境变量包括DOCKER_HOST、DOCKER_CONTEXT、DOCKER_TLS_VERIFY等，需合理组合使用并注意生效范围与验证方法。
Docker CLI 通过环境变量控制连接行为，优先级高于配置文件但低于命令行参数。正确理解生效顺序能避免连接失败或误连到错误的 Docker 守护进程。
环境变量优先级：从高到低
当多个配置源同时存在时，Docker CLI 按以下顺序决定最终使用的连接参数（覆盖逻辑）：
-
命令行参数（如
-H tcp://192.168.1.100:2375或--context my-remote）——最高优先级，直接生效 -
环境变量（如
DOCKER_HOST、DOCKER_CONTEXT、DOCKER_TLS_VERIFY等）——次高，全局影响当前 shell 会话 -
本地配置文件（
~/.docker/config.json中的currentContext和上下文定义）——默认回退来源 -
内置默认值（Unix socket
unix:///var/run/docker.sock，无 TLS）——仅当以上全未设置时使用
关键环境变量及其作用
常用变量需成对或组合使用，单独设置可能无效：
-
DOCKER_HOST：指定守护进程地址，格式如tcp://192.168.1.100:2376、ssh://user@host或unix:///var/run/docker.sock -
DOCKER_CONTEXT：指向~/.docker/contexts下预定义的上下文名称，会自动加载对应 TLS 路径、主机、命名空间等 -
DOCKER_TLS_VERIFY：设为1表示启用 TLS 验证；配合DOCKER_CERT_PATH使用 -
DOCKER_CERT_PATH：TLS 证书目录路径（含ca.pem、cert.pem、key.pem），默认为~/.docker -
DOCKER_DEFAULT_PLATFORM：设置默认构建平台（如linux/amd64），影响docker build和docker run
配置方式与生效范围
环境变量需在运行 docker 命令前完成设置，不同方式适用场景不同：
-
临时单次生效：在命令前直接赋值，如
DOCKER_HOST=tcp://10.0.0.5:2376 docker ps -
当前终端会话生效：执行
export DOCKER_HOST=...（Linux/macOS）或$env:DOCKER_HOST="..."（PowerShell） -
永久生效（用户级）：将
export行加入~/.bashrc、~/.zshrc或~/.profile，然后source加载 -
永久生效（系统级）：写入
/etc/environment（Debian/Ubuntu）或/etc/profile.d/docker.sh（需可执行权限）
验证与排错建议
配置后务必验证是否按预期生效：
- 运行
docker context ls查看当前激活上下文及来源（标注*的为当前上下文） - 执行
docker info | grep -i "name\|server version\|https"确认连接目标和 TLS 状态 - 若报错
Cannot connect to the Docker daemon，先检查DOCKER_HOST地址是否可达、端口是否开放、证书路径是否存在且权限正确 - 冲突提示如
Conflicting options: --tlsverify and --tlscacert多因环境变量与命令行混用导致，建议统一用上下文管理远程连接
不复杂但容易忽略：环境变量一旦导出，会影响该 shell 中所有后续 docker 命令；切换环境时记得清理或改用 docker context use 更安全可控。
