手册

守护进程代理配置

Table of contents

如果您的组织使用代理服务器连接互联网，您可能需要配置 Docker 守护进程以使用代理服务器。守护进程使用代理服务器访问存储在 Docker Hub 和其他注册表中的镜像，以及连接 Docker 集群中的其他节点。

本文档介绍如何为 Docker 守护进程配置代理。有关为 Docker CLI 配置代理设置的说明，请参阅配置 Docker CLI 使用代理服务器。

Important

daemon.json 中指定的代理配置会被 Docker Desktop 忽略。如果您使用 Docker Desktop，可以使用 Docker Desktop 设置配置代理。

有两种方式可以配置这些设置：

通过配置文件或 CLI 标志配置守护进程
在系统上设置环境变量

直接配置守护进程优先于环境变量。

守护进程配置

您可以在 daemon.json 文件中配置守护进程的代理行为，或者使用 dockerd 命令的 --http-proxy 或 --https-proxy 标志。建议使用 daemon.json 进行配置。

{
  "proxies": {
    "http-proxy": "http://proxy.example.com:3128",
    "https-proxy": "https://proxy.example.com:3129",
    "no-proxy": "*.test.example.com,.example.org,127.0.0.0/8"
  }
}

更改配置文件后，重启守护进程以使代理配置生效：

$ sudo systemctl restart docker

环境变量

Docker 守护进程在启动环境中检查以下环境变量，以配置 HTTP 或 HTTPS 代理行为：

HTTP_PROXY
http_proxy
HTTPS_PROXY
https_proxy
NO_PROXY
no_proxy

systemd 单元文件

如果您将 Docker 守护进程作为 systemd 服务运行，可以创建一个 systemd drop-in 文件，为 docker 服务设置变量。

Rootless 模式注意事项

在 rootless 模式下运行 Docker 时，systemd 配置文件的位置不同。在 rootless 模式下运行时，Docker 作为用户模式的 systemd 服务启动，使用存储在每个用户主目录中的文件，位于 ~/.config/systemd/<user>/docker.service.d/。此外，systemctl 必须在不使用 sudo 的情况下执行，并使用 --user 标志。如果您以 rootless 模式运行 Docker，请选择 "Rootless 模式" 选项卡。

为 docker 服务创建一个 systemd drop-in 目录：

$ sudo mkdir -p /etc/systemd/system/docker.service.d

创建一个名为 /etc/systemd/system/docker.service.d/http-proxy.conf 的文件，添加 HTTP_PROXY 环境变量：
[Service] Environment="HTTP_PROXY=http://proxy.example.com:3128"
如果您使用 HTTPS 代理服务器，请设置 HTTPS_PROXY 环境变量：
[Service] Environment="HTTPS_PROXY=https://proxy.example.com:3129"
可以设置多个环境变量；要同时设置非 HTTPS 和 HTTPS 代理：
[Service] Environment="HTTP_PROXY=http://proxy.example.com:3128" Environment="HTTPS_PROXY=https://proxy.example.com:3129"
Note
代理值中的特殊字符，如 #?!()[]{}，必须使用 %% 进行双重转义。例如：
[Service] Environment="HTTP_PROXY=http://domain%%5Cuser:complex%%23pass@proxy.example.com:3128/"
如果您有需要直接联系的内部 Docker 注册表，不通过代理，可以通过 NO_PROXY 环境变量指定它们。

NO_PROXY 变量指定一个包含逗号分隔值的字符串，用于指定应排除在代理之外的主机。您可以指定以下选项来排除主机：
- IP 地址前缀（1.2.3.4）
- 域名，或特殊 DNS 标签（*）
- 域名匹配该名称及其所有子域名。以 "." 开头的域名仅匹配子域名。例如，给定域名 foo.example.com 和 example.com：
  - example.com 匹配 example.com 和 foo.example.com
  - .example.com 仅匹配 foo.example.com
- 单个星号（*）表示不应进行代理
- IP 地址前缀（1.2.3.4:80）和域名（foo.example.com:80）接受字面端口号
示例：
[Service] Environment="HTTP_PROXY=http://proxy.example.com:3128" Environment="HTTPS_PROXY=https://proxy.example.com:3129" Environment="NO_PROXY=localhost,127.0.0.1,docker-registry.example.com,.corp"

刷新更改并重启 Docker

$ sudo systemctl daemon-reload
$ sudo systemctl restart docker

验证配置已加载且与您所做的更改匹配，例如：

$ sudo systemctl show --property=Environment docker

Environment=HTTP_PROXY=http://proxy.example.com:3128 HTTPS_PROXY=https://proxy.example.com:3129 NO_PROXY=localhost,127.0.0.1,docker-registry.example.com,.corp

为 docker 服务创建一个 systemd drop-in 目录：

$ mkdir -p ~/.config/systemd/user/docker.service.d

创建一个名为 ~/.config/systemd/user/docker.service.d/http-proxy.conf 的文件，添加 HTTP_PROXY 环境变量：
[Service] Environment="HTTP_PROXY=http://proxy.example.com:3128"
如果您使用 HTTPS 代理服务器，请设置 HTTPS_PROXY 环境变量：
[Service] Environment="HTTPS_PROXY=https://proxy.example.com:3129"
可以设置多个环境变量；要同时设置非 HTTPS 和 HTTPS 代理：
[Service] Environment="HTTP_PROXY=http://proxy.example.com:3128" Environment="HTTPS_PROXY=https://proxy.example.com:3129"
Note
代理值中的特殊字符，如 #?!()[]{}，必须使用 %% 进行双重转义。例如：
[Service] Environment="HTTP_PROXY=http://domain%%5Cuser:complex%%23pass@proxy.example.com:3128/"
如果您有需要直接联系的内部 Docker 注册表，不通过代理，可以通过 NO_PROXY 环境变量指定它们。

NO_PROXY 变量指定一个包含逗号分隔值的字符串，用于指定应排除在代理之外的主机。您可以指定以下选项来排除主机：
- IP 地址前缀（1.2.3.4）
- 域名，或特殊 DNS 标签（*）
- 域名匹配该名称及其所有子域名。以 "." 开头的域名仅匹配子域名。例如，给定域名 foo.example.com 和 example.com：
  - example.com 匹配 example.com 和 foo.example.com
  - .example.com 仅匹配 foo.example.com
- 单个星号（*）表示不应进行代理
- IP 地址前缀（1.2.3.4:80）和域名（foo.example.com:80）接受字面端口号
示例：
[Service] Environment="HTTP_PROXY=http://proxy.example.com:3128" Environment="HTTPS_PROXY=https://proxy.example.com:3129" Environment="NO_PROXY=localhost,127.0.0.1,docker-registry.example.com,.corp"

刷新更改并重启 Docker

$ systemctl --user daemon-reload
$ systemctl --user restart docker

验证配置已加载且与您所做的更改匹配，例如：

$ systemctl --user show --property=Environment docker

Environment=HTTP_PROXY=http://proxy.example.com:3128 HTTPS_PROXY=https://proxy.example.com:3129 NO_PROXY=localhost,127.0.0.1,docker-registry.example.com,.corp