在带认证的 HTTP 代理后运行 Docker 容器
由 ProxyV4 工程团队撰写 · Updated:
配置 Docker 代理首先要明确一个问题:究竟哪些流量需要经过代理?Docker 拥有三条独立的流量路径(运行时应用程序、docker build 以及拉取镜像的守护进程),且各自从不同位置读取代理配置。只要配置得当,同一台宿主机上的每个容器都能通过各自独立的 ProxyV4 IPv4 地址访问外网,而无需改动宿主机的路由表。
ENV HTTP_PROXY=http://user:pass@ip:port HTTPS_PROXY=http://user:pass@ip:port- 1 个 IPUS$1.85
- 3+ 个 IPUS$1.70
- 10+ 个 IPUS$1.60
- 25+ 个 IPUS$1.50
- 50+ 个 IPUS$1.40
- 100+ 个 IPUS$1.30
- 200+ 个 IPUS$1.20
- 500+ 个 IPUS$1.10
- 1 个 IPUS$1.85
- 3+ 个 IPUS$1.70
- 10+ 个 IPUS$1.60
- 25+ 个 IPUS$1.50
- 50+ 个 IPUS$1.40
- 100+ 个 IPUS$1.30
- 200+ 个 IPUS$1.20
- 500+ 个 IPUS$1.10
Docker 读取代理配置的三处位置
在一个作用域中设置变量对另外两个完全无效。常见的情况是 docker pull 正常走代理,但容器内的应用程序仍在使用宿主机的原生 IP 访问外网,反之亦然。
| 流量类型 | 配置位置 | 典型使用场景 |
|---|---|---|
| 运行中容器内部的应用程序 | docker run -e HTTP_PROXY=... 或 Compose 中的 environment: 块 | 爬虫请求、API 调用、自动化任务 |
docker build 期间执行的命令 | --build-arg HTTP_PROXY=http://user:pass@ip:port | RUN 步骤中的 apt、pip 和 npm 下载 |
| Docker 守护进程本身 | /etc/systemd/system/docker.service.d/http-proxy.conf | 针对镜像仓库的 docker pull 与 docker push |
每个容器独立 IP
由于运行时环境变量存在于各个容器的独立环境中,单台 VPS 可以运行(例如)十个工作节点,且每个节点配置不同的 http://user:pass@ip:port 值。这样每个工作节点在访问目标网站时都会呈现独立的出口地址;由于 ProxyV4 独享 IPv4 仅出租给单一客户,绝不会有其他人的流量共享该地址。
建议每个服务维护一个独立的 .env 文件,或每个代理对应一个 Compose 服务,以便清晰查看各任务所绑定的 IP。续费时可以保留相同的地址,因此这些配置文件无需任何修改。
保障技术栈正常运行的环境变量
如果完成这些配置后 docker pull 仍然走直连,或者容器无法访问其自身的数据库,代理无法正常工作页面将按顺序逐一排查各个 Docker 层。
- 同时定义大写名称(
HTTP_PROXY、HTTPS_PROXY、NO_PROXY)与小写名称(http_proxy、https_proxy、no_proxy);不同的工具和运行环境对大小写拼写的识别各不相同 - 将应用程序调用的所有 Compose 服务名称都加入
NO_PROXY,例如NO_PROXY=localhost,127.0.0.1,redis,postgres,确保数据库和缓存流量保留在桥接网络中,而不会被转发至代理 HTTPS_PROXY同样使用http://协议前缀;客户端会发起 CONNECT 隧道,HTTPS 网站始终保持端到端加密- 切勿在
Dockerfile中使用ENV写入代理密码:密码会留存在镜像层中。请在运行时通过.env或 Compose 文件进行注入
操作步骤
- 1
将订单信息转换为代理 URL
您的 ProxyV4 订单信息格式为
ip:port:user:pass;请将其改写为http://user:pass@ip:port,可手动修改或使用代理格式转换器。 - 2
为服务添加环境变量
在
docker-compose.yml中,于相应服务的environment:下配置HTTP_PROXY、HTTPS_PROXY、http_proxy、https_proxy以及NO_PROXY=localhost,127.0.0.1,redis,db。 - 3
重新创建容器
环境变量的更改仅对新容器生效,因此请运行
docker compose up -d重新创建该服务。 - 4
从容器内部检查出口 IP
运行
docker exec -it <container> curl -s https://proxyv4.com/api/my-ip。返回的地址应为代理 IP,而非宿主机的 IP。
常见问题
添加 HTTP_PROXY 后,应用无法连接 Redis 或 Postgres,这是为什么?
HTTP 客户端此时将发往 redis 或 db 的请求发送到了外部代理,而外部代理无法解析这些内部服务名称。请将它们添加到 NO_PROXY(以及 no_proxy)中,例如 NO_PROXY=localhost,127.0.0.1,redis,db,然后重新创建容器。
同一台服务器上的每个容器可以使用不同的代理吗?
可以。为每个服务或每个 .env 文件指定独立的 http://user:pass@ip:port 值即可。容器共享同一台宿主机,但在访问互联网时使用各自独立的出口 IP。
为什么要将代理变量以大小写两种形式各设置一次?
因为业内没有统一的标准。基于 libcurl 构建的工具通常读取小写的 http_proxy 和 https_proxy,而许多 Go 和 Node 工具则读取大写名称。两者同时设置可以确保镜像内的所有工具都能正常生效。
docker pull 会使用我在 Compose 中设置的变量吗?
不会。拉取镜像由守护进程执行,其代理配置读取自 systemd drop-in 配置文件 /etc/systemd/system/docker.service.d/http-proxy.conf,而不是容器的环境变量。
来源
为每个容器配备独立的独享 IPv4
覆盖 7 个国家的不限流量独享 IPv4,以及美国和越南的静态 ISP 代理,付款后自动交付。无最低起订量限制。
查看新加坡实时价格