在带认证的 HTTP 代理后运行 Docker 容器

· Updated:

配置 Docker 代理首先要明确一个问题:究竟哪些流量需要经过代理?Docker 拥有三条独立的流量路径(运行时应用程序、docker build 以及拉取镜像的守护进程),且各自从不同位置读取代理配置。只要配置得当,同一台宿主机上的每个容器都能通过各自独立的 ProxyV4 IPv4 地址访问外网,而无需改动宿主机的路由表。

Docker · HTTP
ENV HTTP_PROXY=http://user:pass@ip:port HTTPS_PROXY=http://user:pass@ip:port
独享 IPv4(数据中心)
🇸🇬 新加坡
有货
起
US$1.10 / IP / 月
批量阶梯折扣
  • 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
购买 新加坡
独享 IPv4(数据中心)
🇺🇸 美国
有货
起
US$1.10 / IP / 月
批量阶梯折扣
  • 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:portRUN 步骤中的 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. 1

    将订单信息转换为代理 URL

    您的 ProxyV4 订单信息格式为 ip:port:user:pass;请将其改写为 http://user:pass@ip:port,可手动修改或使用代理格式转换器。

  2. 2

    为服务添加环境变量

    在 docker-compose.yml 中,于相应服务的 environment: 下配置 HTTP_PROXY、HTTPS_PROXY、http_proxy、https_proxy 以及 NO_PROXY=localhost,127.0.0.1,redis,db。

  3. 3

    重新创建容器

    环境变量的更改仅对新容器生效,因此请运行 docker compose up -d 重新创建该服务。

  4. 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 代理,付款后自动交付。无最低起订量限制。

查看新加坡实时价格

Related articles

代理配置
分层详解:在 Ubuntu 和 Debian 上配置代理
在 Ubuntu 或 Debian 上配置带认证的 APT 代理,以及 Shell、systemd 服务、sudo 与 GNOME 环境。提供即拷即用的配置文件与验证步骤,快速确认代理生效。
代理配置
通过带认证的代理使用 cURL:验证代理可用的测试命令
在任意系统上使用 -x 和 -U 通过带认证的 HTTP(S) 代理发送 cURL 请求,确认出口 IP,查看 CONNECT 握手过程并测量每次请求的耗时。
按平台选择代理
网页抓取专属代理:不限流量的固定 IP 池
适用于 Python、Scrapy、Playwright 和 Selenium 的网页抓取代理:独享 IPv4 与静态 ISP 地址池,无限流量,按 IP 统一定价。
按平台选择代理
空投与 Grass 代理:为每个钱包和节点提供独立 IPv4
为每个钱包与 DePIN 节点分配独立 IPv4 的空投和 Grass 代理。Grass、Dawn 及 Nodepay 专享静态 ISP;任务交互与测试网专享独享 IPv4。
按平台选择代理
用于SEO排名监控的代理:还原当地搜索者的真实结果页
提供美国、英国、越南、日本等7个市场的独享IPv4 SEO排名监控代理,确保自然排名、本地搜索包(Local Pack)和广告投放与当地搜索结果完全一致。
IPV4 · singapore
新加坡独享 IPv4 代理:每个店铺与广告账户专享一个固定 IP
新加坡独享 IPv4 代理:由您独享的静态新加坡数据中心 IP,适用于 Lazada 和 Shopee 新加坡店铺、新加坡广告账户及区域自动化业务。
IPV4 · united states
美国独享 IPv4 代理池:适用于数据抓取、排名追踪与广告核查
购买美国独享 IPv4 代理:静态美国数据中心 IP,单人专享,无限流量。专为数据采集、SERP 排名追踪与美国广告投放检查打造。
应用场景
围绕独享IP池设计网络爬虫
面向数据团队的规划指南:合理规划独享静态IP池规模,在自建代码中实现轮换,灵活选择IPv4、ISP或IPv6,合规负责地采集网络数据。