Docker 设置代理的三种方法（2025年06月03日亲测可用）

熊明才

89109人浏览 · 2024-12-19 17:54:56

熊明才 · 2024-12-19 17:54:56 发布

Docker 设置代理的三种方法

在 Docker 中设置代理是非常常见的需求，尤其是在某些需要通过代理访问外部资源的网络环境下。本文将介绍三种配置 Docker 使用代理的常见方法：通过 daemon.json 配置镜像加速器、通过 daemon.json 配置 HTTP/HTTPS 代理、以及通过 docker.service 配置代理。

方式零就是不配置代理，使用网友大佬开发的代理脚本（2025年02月08日更新）

妈妈再也不用担心下载不到docker Hub 上的镜像了：

bash -c "$(curl -sSLf https://xy.ggbond.org/xy/docker_pull.sh)" -s 参数1：完整镜像名 参数2：代理文件路径（可选项）

说明：
代理文件路径是指存放docker_mirrors.txt文件的目录，如果不填写默认创建/etc/xiaoya目录，并自动在该目录生成docker_mirrors.txt文件。
docker_mirrors.txt文件每行一个代理镜像点，越排在上方的优先级越高，脚本会自动将上一次成功下载的代理点排序在第一位。
如果要手动添加与使用自定义的代理镜像点，只需要在第一行填上地址即可。

示例：

bash -c "$(curl -sSLf https://xy.ggbond.org/xy/docker_pull.sh)" -s grafana/loki:2.8.0 /tmp/

方式一配置 `daemon.json` 镜像加速器（适合入门对下载速度无要求）

通过修改 Docker 的配置文件 daemon.json 来配置镜像加速器，可以加速 Docker 镜像的拉取速度，尤其是在国内环境下。操作步骤如下：

编辑 /etc/docker/daemon.json 文件：
```
sudo vim /etc/docker/daemon.json
```

添加镜像加速器配置：

{
  "registry-mirrors": [
    "https://hub-mirror.c.163.com",
    "https://mirror.ccs.tencentyun.com",
    "https://docker.mirrors.ustc.edu.cn",
    "https://ueo0uggy.mirror.aliyuncs.com",
    "https://docker.m.daocloud.io",
    "https://cf-workers-docker-io-apl.pages.dev"
  ]
}

使用 jq 命来行工具验证配置格式是否符合json 格式（可选）

sudo apt install jq -y
 jq '.' /etc/docker/daemon.json

保存并退出编辑器，然后重启 Docker 服务：
```
sudo systemctl restart docker
```

您可以通过 docker info 命令查看当前 Docker 配置，包括是否成功加载了镜像加速器。

sudo docker info | grep -i -C 5 'Registry Mirrors'

如果配置成功，您会看到类似以下的输出：

 Debug Mode: false
 Experimental: false
 Insecure Registries:
  ::1/128
  127.0.0.0/8
 Registry Mirrors:
  https://hub-mirror.c.163.com/
  https://docker.mirrors.ustc.edu.cn/
  https://ueo0uggy.mirror.aliyuncs.com/
  https://docker.m.daocloud.io/
  https://cf-workers-docker-io-apl.pages.dev/

这表示镜像加速器已经成功配置并生效。

拉取镜像进行测试

另一种验证方法是通过拉取一个镜像来检查是否使用了镜像加速器。您可以尝试拉取一个常见的 Docker 镜像，例如 hello-world：

sudo docker pull hello-world

如果您配置了国内的镜像加速器，并且能够快速完成镜像拉取，那么镜像加速器已经生效。如果拉取速度较慢，可能说明加速器没有生效，您可以再次检查配置或网络环境。

方式二配置 `daemon.json` HTTP/HTTPS 代理

在使用方式二和方式三前，请确保代理环境已正确设置：
验证代理环境如下命令

# root @ DESKTOP-1LUA3MJ in ~ [15:26:32] 
$ export http_proxy="http://127.0.0.1:7890"
$ export https_proxy="http:/127.0.0.1:7890"

# root @ DESKTOP-1LUA3MJ in ~ [15:26:34]
$ curl -I http://www.google.com  # 检查代理是否生效，200/301响应表示成功
HTTP/1.1 200 OK
Transfer-Encoding: chunked  
Cache-Control: private
Connection: keep-alive

如果需要通过代理访问 Docker 镜像或其他网络资源，可以通过修改 daemon.json 配置 HTTP 和 HTTPS 代理。以下是配置步骤：

编辑 /etc/docker/daemon.json 文件：
```
sudo vim /etc/docker/daemon.json
```

配置 HTTP 和 HTTPS 代理：

{
  "proxies": {
    "http-proxy": "http://127.0.0.1:7890",
    "https-proxy": "http://127.0.0.1:7890"
  }
}

保存并退出编辑器，重启 Docker 服务：
```
sudo systemctl restart docker
```

验证代理配置是否生效：

sudo docker info | grep -A 1 ' HTTP Proxy'

输出结果应显示：

WARNING: bridge-nf-call-iptables is disabled
HTTP Proxy: http://127.0.0.1:7890
HTTPS Proxy: http://127.0.0.1:7890
WARNING: bridge-nf-call-ip6tables is disabled

方式三配置 `docker.service` 代理（进阶使用，使用效果同方法二）

另一种配置代理的方法是直接在 Docker 服务的启动配置中设置代理。通过编辑 docker.service 文件来配置 HTTP 和 HTTPS 代理。

配置步骤：

查找 docker.service 文件的位置：

sudo systemctl status docker

输出中的 Loaded 行会显示 docker.service 的路径，例如：

Loaded: loaded (/lib/systemd/system/docker.service; enabled; vendor preset: enabled)

编辑 docker.service 文件，在 [Service] 部分添加代理环境变量：
```
sudo vim /lib/systemd/system/docker.service
```

在 [Service] 部分添加如下内容：

[Service]
Environment="HTTP_PROXY=http://127.0.0.1:7890/"
Environment="HTTPS_PROXY=http://127.0.0.1:7890/"

保存并退出编辑器，重载 docker.service 配置并重启 Docker 服务：
```
sudo systemctl daemon-reload
sudo systemctl restart docker
```
如果需要查看 Docker 启动日志，可以使用以下命令：
```
sudo journalctl -u docker.service
```