使用代理服务器配置 Docker CLI

目录

本页面介绍如何配置 Docker CLI，使其通过环境变量在容器中使用代理。

本页面不介绍如何为 Docker Desktop 配置代理。有关说明，请参阅配置 Docker Desktop 使用 HTTP/HTTPS 代理。

如果您在没有 Docker Desktop 的情况下运行 Docker Engine，请参阅配置 Docker 守护进程使用代理，了解如何为 Docker 守护进程 (dockerd) 本身配置代理服务器。

如果您的容器需要使用 HTTP、HTTPS 或 FTP 代理服务器，您可以通过不同方式进行配置

注意

遗憾的是，目前没有标准定义 Web 客户端应如何处理代理环境变量，也没有定义这些变量的格式。

如果您对这些变量的历史感兴趣，请查看 GitLab 团队关于此主题的博客文章：我们需要谈谈：能否标准化 NO_PROXY？。

配置 Docker 客户端

您可以使用位于 ~/.docker/config.json 的 JSON 配置文件为 Docker 客户端添加代理配置。构建和容器会使用此文件中指定的配置。

{
 "proxies": {
   "default": {
     "httpProxy": "http://proxy.example.com:3128",
     "httpsProxy": "https://proxy.example.com:3129",
     "noProxy": "*.test.example.com,.example.org,127.0.0.0/8"
   }
 }
}

警告

代理设置可能包含敏感信息。例如，某些代理服务器要求在 URL 中包含身份验证信息，或者其地址可能暴露您公司环境的 IP 地址或主机名。

环境变量以纯文本形式存储在容器配置中，因此可以通过远程 API 检查，或在使用 docker commit 时提交到镜像中。

保存文件后配置即生效，无需重启 Docker。但配置仅适用于新的容器和构建，不影响现有容器。

下表描述了可用的配置参数。

属性描述
httpProxy设置 HTTP_PROXY 和 http_proxy 环境变量和构建参数。
httpsProxy设置 HTTPS_PROXY 和 https_proxy 环境变量和构建参数。
ftpProxy设置 FTP_PROXY 和 ftp_proxy 环境变量和构建参数。
noProxy设置 NO_PROXY 和 no_proxy 环境变量和构建参数。
allProxy设置 ALL_PROXY 和 all_proxy 环境变量和构建参数。

这些设置仅用于配置容器的代理环境变量，不作为 Docker CLI 或 Docker Engine 本身的代理设置。有关配置 CLI 和守护进程的代理设置，请参阅环境变量以及配置 Docker 守护进程使用代理服务器部分。

使用代理配置运行容器

当您启动容器时，其代理相关的环境变量会设置为反映您在 ~/.docker/config.json 中的代理配置。

例如，假设代理配置类似于前面章节所示的示例，您运行的容器的环境变量设置如下

$ docker run --rm alpine sh -c 'env | grep -i  _PROXY'
https_proxy=http://proxy.example.com:3129
HTTPS_PROXY=http://proxy.example.com:3129
http_proxy=http://proxy.example.com:3128
HTTP_PROXY=http://proxy.example.com:3128
no_proxy=*.test.example.com,.example.org,127.0.0.0/8
NO_PROXY=*.test.example.com,.example.org,127.0.0.0/8

使用代理配置进行构建

当您执行构建时，代理相关的构建参数会根据您的 Docker 客户端配置文件中的代理设置自动预填充。

假设代理配置类似于前面章节所示的示例，构建期间的环境变量设置如下

$ docker build \
  --no-cache \
  --progress=plain \
  - <<EOF
FROM alpine
RUN env | grep -i _PROXY
EOF

#5 [2/2] RUN env | grep -i _PROXY
#5 0.100 HTTPS_PROXY=https://proxy.example.com:3129
#5 0.100 no_proxy=*.test.example.com,.example.org,127.0.0.0/8
#5 0.100 NO_PROXY=*.test.example.com,.example.org,127.0.0.0/8
#5 0.100 https_proxy=https://proxy.example.com:3129
#5 0.100 http_proxy=http://proxy.example.com:3128
#5 0.100 HTTP_PROXY=http://proxy.example.com:3128
#5 DONE 0.1s

为每个守护进程配置代理设置

~/.docker/config.json 中 proxies 下的 default 键配置了客户端连接的所有守护进程的代理设置。要为单个守护进程配置代理，请使用守护进程的地址而不是 default 键。

以下示例配置了默认代理配置，以及针对地址为 tcp://docker-daemon1.example.com 的 Docker 守护进程的 no-proxy 覆盖设置

{
 "proxies": {
   "default": {
     "httpProxy": "http://proxy.example.com:3128",
     "httpsProxy": "https://proxy.example.com:3129",
     "noProxy": "*.test.example.com,.example.org,127.0.0.0/8"
   },
   "tcp://docker-daemon1.example.com": {
     "noProxy": "*.internal.example.net"
   }
 }
}

使用 CLI 设置代理

除了配置 Docker 客户端之外，您还可以在执行 docker build 和 docker run 命令时在命令行上指定代理配置。

命令行上的代理配置使用 --build-arg 标志用于构建，以及 --env 标志用于您想要通过代理运行容器时。

$ docker build --build-arg HTTP_PROXY="http://proxy.example.com:3128" .
$ docker run --env HTTP_PROXY="http://proxy.example.com:3128" redis

有关可与 docker build 命令一起使用的所有代理相关构建参数列表，请参阅预定义 ARGs。这些代理值仅在构建容器中可用。它们不包含在构建输出中。

将代理作为构建的环境变量

不要使用 ENV Dockerfile 指令来指定构建的代理设置。请改用构建参数。

为代理使用环境变量会将配置嵌入到镜像中。如果代理是内部代理，则对于从该镜像创建的容器可能无法访问。

将代理设置嵌入到镜像中也存在安全风险，因为值可能包含敏感信息。

页面选项