docker build的proxy，容器的proxy ,image的Proxy 三个的区别

Docker Daemon 代理 (守护进程代理) 容器运行时代理 镜像构建代理 (Build Proxy)

作用对象 Docker 守护进程 (dockerd) docker run 后运行的容器 docker build 过程

主要影响范围 全局性配置，影响所有通过 dockerd 的网络操作 配置后启动的特定容器或所有新容器（取决于配置方式） 仅本次构建过程

典型用途 docker pull, docker push 容器内应用程序访问外部网络 构建时下载软件包（如 apt, pip, npm）

配置方式 1. Systemd 配置文件 (/etc/systemd/system/docker.service.d/)
2. daemon.json (部分系统) 1. ~/.docker/config.json (全局)
2. docker run -e (单次)
3. Docker Compose 文件 1. --build-arg 传递参数
2. Dockerfile 中 ARG 指令

配置示例 Environment=“HTTP_PROXY=http://proxy.example.com:8080” docker run -e http_proxy=http://proxy.example.com:8080 image_name 或 ~/.docker/config.json docker build --build-arg http_proxy=http://proxy.example.com:8080 .

💡 配置注意事项与技巧

配置 Docker 代理时，有几个通用但非常重要的点需要注意：

• 协议支持：Docker Daemon 代理目前主要支持 HTTP、HTTPS 和 FTP 代理协议，不支持直接的 Socks5 代理。如果只有 Socks5 代理，需要使用工具（如 polipo）将其转换为 HTTP 代理 。

• 地址问题：在配置代理地址时，需要注意：

◦   如果 Docker 守护进程或容器使用默认的 bridge 网络模式，要访问宿主机上的代理服务，不能使用 127.0.0.1 或 localhost，因为这对容器来说是它自己。通常需要指定宿主机的 Docker 网桥 IP（如 172.17.0.1） 或宿主机的真实 IP 地址 。

◦   若在 docker build 或 docker run 时添加了 --network=host 参数，容器会与宿主机共享网络命名空间，这时就可以直接使用 127.0.0.1 来指向宿主机上的代理服务 。

• no_proxy 设置：为了避免对内部地址的请求也走代理，通常需要配置 no_proxy 或 NO_PROXY 环境变量来列出直连的地址，如 localhost, 127.0.0.1, 内部域名或局域网网段 。

🛠️ 各代理的详细配置方法

1. Docker Daemon 代理 (用于 docker pull/push)

这是影响最广的代理配置，决定了 Docker 守护进程本身如何访问网络，主要用于镜像的拉取和推送。

• 通过 Systemd 配置（Linux 常见）：

1.  创建或编辑配置文件：/etc/systemd/system/docker.service.d/http-proxy.conf
2.  加入以下内容（替换为你实际的代理地址和端口）：
    [Service]
    Environment="HTTP_PROXY=http://proxy.example.com:8080"
    Environment="HTTPS_PROXY=http://proxy.example.com:8080"
    Environment="NO_PROXY=localhost,127.0.0.1,.internal.example.com"
    
3.  保存后，重新加载配置并重启 Docker 服务：
    sudo systemctl daemon-reload
    sudo systemctl restart docker

• 通过 daemon.json 配置（部分系统）：

编辑 /etc/docker/daemon.json 文件（如果不存在则创建），添加：
{
  "proxies": {
    "default": {
      "httpProxy": "http://proxy.example.com:8080",
      "httpsProxy": "http://proxy.example.com:8080",
      "noProxy": "localhost,127.0.0.1,.internal.example.com"
    }
  }
}

同样，修改后需要重启 Docker 服务 。

2. 容器运行时代理 (用于 docker run)

此配置影响容器运行后其内部应用程序访问外部网络的方式。

• 全局配置（影响所有新容器）：

编辑 ~/.docker/config.json 文件（位于用户家目录下），添加：
{
  "proxies": {
    "default": {
      "httpProxy": "http://proxy.example.com:8080",
      "httpsProxy": "http://proxy.example.com:8080",
      "noProxy": "localhost,127.0.0.1"
    }
  }
}

此配置无需重启 Docker，对之后新建的所有容器生效 。

• 单次配置（仅影响本次运行的容器）：

在 docker run 命令中直接通过 -e 选项设置环境变量：
docker run -e http_proxy=http://proxy.example.com:8080 -e https_proxy=http://proxy.example.com:8080 your-image

• Docker Compose 配置：

在 docker-compose.yml 文件中的服务定义下添加 environment 部分：
services:
  your-service:
    image: your-image
    environment:
      - http_proxy=http://proxy.example.com:8080
      - https_proxy=http://proxy.example.com:8080

3. 镜像构建代理 (用于 docker build)

这是最容易混淆的地方。Docker Daemon 代理仅负责拉取构建时的基础镜像（FROM 语句），而构建过程中执行指令（如 RUN apt-get update）的网络请求需要单独配置。

• 通过 --build-arg 传递（推荐）：

在构建命令中明确指定代理参数：
docker build \
  --build-arg HTTP_PROXY=http://proxy.example.com:8080 \
  --build-arg HTTPS_PROXY=http://proxy.example.com:8080 \
  -t your-image-name .

对应的 Dockerfile 中最好提前声明这些参数：
ARG HTTP_PROXY
ARG HTTPS_PROXY
# 后续的 RUN 命令或其它指令就可以利用这些变量了

• 在 Dockerfile 中硬编码（不推荐）：

直接在 Dockerfile 中设置环境变量，但注意这可能会将代理信息保留在最终镜像中，存在安全风险。通常建议在构建结束后取消设置：
ENV http_proxy=http://proxy.example.com:8080
ENV https_proxy=http://proxy.example.com:8080
# ...你的构建步骤...
RUN unset http_proxy https_proxy  # 构建后取消设置

🎯 如何选择配置方式

• 临时或特定需求：对于一次性的构建或容器运行，使用 --build-arg 或 docker run -e 附加环境变量最灵活。

• 个人开发环境（希望一劳永逸）：

◦   为所有新构建的容器自动设置代理：配置 ~/.docker/config.json 。

◦   为 docker pull/push 设置代理：配置 Docker Daemon 的代理 。

• 企业或生产环境：通常推荐通过 Systemd 配置 Docker Daemon 的代理 ，并在 CI/CD 流水线中明确使用 --build-arg 来传递代理参数 ，这样更清晰、易于管理。

⚠️ 常见问题排查 (Troubleshooting)

1. 配置了代理但无效：
   ◦ 确认代理地址和端口是否正确，代理服务是否正常运行。

   ◦ 对于 Docker Daemon 代理，确认是否执行了 systemctl daemon-reload 和 restart docker。

   ◦ 检查防火墙规则是否允许 Docker 守护进程或容器访问代理服务器。

2. 构建时某些指令不走代理：
   ◦ 确保在 docker build 时正确传递了 --build-arg。

   ◦ 注意：docker build 过程中，只有 FROM 指令拉取基础镜像受 Docker Daemon 代理影响，其他指令（如 RUN）需要靠构建参数传递代理 。

3. 容器无法访问某些内网地址：
   ◦ 检查 no_proxy 或 NO_PROXY 环境变量是否正确设置，是否包含了需要直连的内部域名或 IP 段 。

希望以上的解释和对比能帮助你更好地理解 Docker 中不同层次代理配置的区别和用途。