在 Linux 服务器上或容器内,没有系统代理对话框;有三种机制,你需要哪一种取决于软件的行为是否规范。 环境变量(http_proxy、https_proxy、no_proxy)被 curl、wget、pip、apt、git、大多数语言 HTTP 库以及 Docker 本身所遵守 — 而有些工具会静默忽略它们。进程级包装器(如 proxychains)在库级别强制单个程序通过代理。透明重定向(使用 iptables 和 redsocks 等辅助工具)会捕获主机或容器的所有出站 TCP 连接,无论程序认为自己在做什么。本指南涵盖所有三种方法、每种方法的陷阱以及如何检查结果。
级别 1:环境变量
这个约定比 Linux 本身还要古老:如果设置了 http_proxy / https_proxy,就使用它们;跳过 no_proxy 中列出的主机。
export http_proxy="http://user:pass@proxy.example.com:8080"
export https_proxy="http://user:pass@proxy.example.com:8080"
export no_proxy="localhost,127.0.0.1,::1,.internal,10.0.0.0/8"
curl https://api.ipify.org # 通过代理
curl http://localhost:9000/health # 直接连接,得益于 no_proxy
让人花费数小时的要点:
- 大小写。同时设置小写和大写(
HTTP_PROXY、HTTPS_PROXY、NO_PROXY);工具对读取哪个有分歧。注意https_proxy接受http://URL — 它指定的是 HTTPS 目标 的代理,而代理本身通常是带有CONNECT的普通 HTTP。 - 特殊字符 在密码中必须进行百分号编码。
- 作用域。变量仅适用于在设置它们之后启动的进程,并且在该 shell 中。由 systemd 启动的服务看不到你的 shell;将它们放在单元的
Environment=或EnvironmentFile中。Cron 作业同样具有干净的环境。 sudo默认会清除环境;使用sudo -E或配置env_keep。- 谁忽略它们。Go 程序会遵守(通过
net/http的ProxyFromEnvironment);Python 的 requests 会遵守;Node 的内置fetch和许多 Node HTTP 客户端 不 遵守,除非使用辅助工具;Java 需要-Dhttp.proxyHostJVM 标志;数据库和自定义 TCP 协议从不查看它们。如果设置变量后程序的流量仍然显示你的真实 IP,那么它属于这些情况之一 — 转到级别 2 或 3。
包管理器有自己的旋钮
# apt
echo 'Acquire::http::Proxy "http://user:pass@proxy.example.com:8080";' | sudo tee /etc/apt/apt.conf.d/95proxy
echo 'Acquire::https::Proxy "http://user:pass@proxy.example.com:8080";' | sudo tee -a /etc/apt/apt.conf.d/95proxy
# pip
pip config set global.proxy http://user:pass@proxy.example.com:8080
# git
git config --global http.proxy http://user:pass@proxy.example.com:8080
# npm
npm config set proxy http://user:pass@proxy.example.com:8080
npm config set https-proxy http://user:pass@proxy.example.com:8080
级别 1b:Docker 特定
Docker 有 两个 独立的代理作用域,混淆它们是经典的容器错误。
守护进程(拉取镜像)
镜像拉取由 Docker 守护进程(一个 systemd 服务)完成 — 它看不到你的 shell。在 drop-in 中配置它:
sudo mkdir -p /etc/systemd/system/docker.service.d
cat <<'EOF' | sudo tee /etc/systemd/system/docker.service.d/http-proxy.conf
[Service]
Environment="HTTP_PROXY=http://user:pass@proxy.example.com:8080"
Environment="HTTPS_PROXY=http://user:pass@proxy.example.com:8080"
Environment="NO_PROXY=localhost,127.0.0.1,registry.internal"
EOF
sudo systemctl daemon-reload && sudo systemctl restart docker
容器(来自应用程序的流量)
容器内的进程有自己的环境。要么在运行时传递变量:
docker run -e HTTP_PROXY=http://user:pass@proxy.example.com:8080 \
-e HTTPS_PROXY=http://user:pass@proxy.example.com:8080 \
-e NO_PROXY=localhost,127.0.0.1 myimage
或者在此客户端启动的所有容器的 ~/.docker/config.json 中设置默认值:
{ "proxies": { "default": {
"httpProxy": "http://user:pass@proxy.example.com:8080",
"httpsProxy": "http://user:pass@proxy.example.com:8080",
"noProxy": "localhost,127.0.0.1" } } }
客户端会将这些注入到每个容器的环境中(以及构建中)。在容器内部,同样的注意事项适用:应用程序必须遵守这些变量。在 Compose 中,为每个服务使用 environment: 块,并记住通过服务名相互通信的服务必须位于 NO_PROXY 中,否则每次内部调用都会尝试通过代理出去并失败。
构建
docker build 从 ~/.docker/config.json 或 --build-arg HTTP_PROXY=… 获取代理。不要使用 ENV 将凭据烘焙到镜像中;它们会出现在层历史中,任何拉取镜像的人都能看到。
级别 2:进程级包装器
对于忽略环境的程序,proxychains(维护的分支是 proxychains-ng,包名 proxychains4)预加载一个共享库,拦截程序的 socket 调用,并通过你定义的代理链路由它们:
sudo apt install proxychains4
# /etc/proxychains4.conf,在底部:
# [ProxyList]
# http proxy.example.com 8080 user pass
# 或: socks5 proxy.example.com 1080 user pass
proxychains4 -q ./my-binary --that-ignores-env
在配置中设置 proxy_dns,以便主机名查找也通过代理(来自 如何测试代理 的 DNS 泄漏问题)。限制:它只适用于使用标准 socket 库的动态链接二进制文件 — 静态链接的 Go 程序和任何使用原始 socket 的程序都会绕过它。它是一次处理一个进程的工具,非常适合测试和偶尔行为不端的二进制文件,而不是整个主机。
同类替代品:tsocks、graftcp(使用 ptrace,因此也能捕获静态二进制文件,但性能成本较高),以及将进程作为入口点运行在容器中的这些工具。
级别 3:使用 iptables 和 redsocks 进行透明重定向
当你需要主机或容器的 所有 流量都通过代理出去 — 包括你无法配置的软件 — 在内核级别进行重定向。iptables 可以将出站 TCP 连接重写到本地端口;一个监听该端口的小守护进程将每个连接包装在代理协议中并转发。redsocks 是标准的此类守护进程。
sudo apt install redsocks
# /etc/redsocks.conf
base { log_debug = off; log_info = on; daemon = on; redirector = iptables; }
redsocks {
local_ip = 127.0.0.1; local_port = 12345;
ip = PROXY_IP; port = 8080;
type = http-connect; # 或 socks5
login = "user"; password = "pass";
}
sudo systemctl restart redsocks
# 重定向所有出站 TCP,除了代理本身和本地/私有范围
sudo iptables -t nat -N REDSOCKS
sudo iptables -t nat -A REDSOCKS -d PROXY_IP -j RETURN
sudo iptables -t nat -A REDSOCKS -d 127.0.0.0/8 -j RETURN
sudo iptables -t nat -A REDSOCKS -d 10.0.0.0/8 -j RETURN
sudo iptables -t nat -A REDSOCKS -d 172.16.0.0/12 -j RETURN
sudo iptables -t nat -A REDSOCKS -d 192.168.0.0/16 -j RETURN
sudo iptables -t nat -A REDSOCKS -p tcp -j REDIRECT --to-ports 12345
sudo iptables -t nat -A OUTPUT -p tcp -j REDSOCKS # 此主机自身的流量
# 对于来自容器/其他主机通过此盒路由的流量,改用 PREROUTING
在这样做之前需要知道三件事。代理自身 IP 的 RETURN 规则不是可选的 — 没有它,redsocks 到代理的连接本身会被重定向回 redsocks,导致盒子循环。UDP 不会被此配方重定向:DNS 仍然会直接出去,除非你另外将端口 53 重定向到可信的解析器,或使用 redsocks 的 redudp 部分;QUIC/HTTP/3 将无法通过代理工作(参见 HTTP/3 通过代理),这没问题,因为客户端会回退到 TCP。使用超时测试规则(sudo timeout 60 iptables … 不是一回事,但保持第二个 SSH 会话打开并准备好 iptables -t nat -F 是)— 错误的规则可能会切断你与远程服务器的连接。
同样的模式适用于容器:在容器内运行 iptables 规则(需要 --cap-add=NET_ADMIN),或者更干净地,在主机上运行,将容器的流量路由到专用的网络命名空间。Kubernetes 用户会认出这正是服务网格 sidecar 捕获流量的方式。
哪种情况使用哪个级别
| 情况 | 使用 | 原因 |
|---|---|---|
| 脚本、CLI 工具、包管理器、行为规范的服务 | 环境变量(+ 工具特定配置) | 简单、可逆、进程级作用域 |
| Docker 镜像拉取 | 守护进程 drop-in | 守护进程有自己的环境 |
| 容器内的应用程序 | ~/.docker/config.json 或 -e | 注入到容器的环境中 |
| 一个忽略环境的二进制文件 | proxychains / graftcp | 在 socket 级别拦截;无需主机级更改 |
| 主机或命名空间中的所有流量,无条件 | iptables + redsocks | 内核级别;无法选择退出 |
| 不同目的地使用不同代理 | 类似 PAC 的逻辑:环境 no_proxy,或按目的地范围的 iptables 规则 | 按目标路由 |
始终验证
curl -s https://api.ipify.org # 遵守环境变量:应显示代理 IP
curl -s --noproxy '*' https://api.ipify.org # 绕过环境变量:仅当级别 3 生效时才显示代理 IP
python3 -c "import urllib.request;print(urllib.request.urlopen('https://api.ipify.org').read())"
dig +short myip.opendns.com @resolver1.opendns.com # DNS 看到你的哪个 IP?
第二行是有用的技巧:使用 --noproxy '*',curl 忽略环境变量,所以如果它 仍然 报告代理的 IP,则透明重定向正在工作;如果它报告你的真实 IP,则只有环境级别生效,不合规的软件将泄漏。还要单独检查 DNS — 这是服务器上最常见的泄漏,因为解析器是系统范围配置的,上述三个级别中没有一个会重定向 UDP,除非你明确设置。
对于选择背后的代理类型 — 大多数服务器工作使用数据中心代理,稳定身份使用 ISP 代理,目标要求时使用住宅代理 — 参见 代理类型比较;Linux 工作负载的提供商侧注意事项见 我们的 Linux 代理排名。
常见问题
如何为整个 Linux 服务器设置代理?
对于合规软件,系统范围导出 http_proxy/https_proxy/no_proxy(例如 /etc/environment),并通过 systemd Environment= 配置服务。对于真正的一切,使用 iptables 重定向到 redsocks。
如何让 Docker 使用代理?
两个地方:守护进程(用于拉取)通过 systemd drop-in 设置 HTTP_PROXY,容器通过 ~/.docker/config.json 的 proxies 或 -e 变量。它们是独立的;如果需要两者,则都设置。
为什么我的程序忽略 http_proxy?
并非所有软件都读取它 — Node 的 fetch、Java、数据库和自定义协议不读取。使用工具特定的设置、包装器(如 proxychains)或透明重定向。
什么是 redsocks?
一个守护进程,接受 iptables 重定向到它的 TCP 连接,并通过 HTTP CONNECT 或 SOCKS 代理转发它们,为任何应用程序提供透明代理,而无需配置应用程序。
透明重定向是否处理 DNS 和 UDP?
基本配方不处理 — 它重定向 TCP。显式重定向 DNS(或将解析器指向可信服务器),并期望基于 UDP 的协议(如 QUIC)回退到 TCP。
容器应该使用 SOCKS5 还是 HTTP 代理?
带有 CONNECT 的 HTTP 覆盖 HTTPS 目标,并且是环境变量所期望的;SOCKS5 仅用于非 HTTP TCP 流量,然后通过 proxychains 或 redsocks 的 socks5 模式。