分层详解:在 Ubuntu 和 Debian 上配置代理
由 ProxyV4 工程团队撰写 · Updated:
在 Ubuntu 上配置代理实际上包含四个独立的环节,因为 Linux 没有全局通用的统一代理开关。Shell 读取环境变量,APT 读取专属配置目录,systemd 服务读取 Unit 补充配置(drop-in),而 GNOME 桌面则使用 gsettings。你只需配置实际用到的层级即可;以下代码示例均基于带有用户名和密码的 ProxyV4 HTTP(S) 代理。
export 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
带用户名和密码的 APT 代理配置
要让 apt 使用需要身份认证的代理,请创建 /etc/apt/apt.conf.d/80proxy 并在代理 URL 中写入用户名和密码。无论是否使用 sudo,APT 每次运行时都会读取此文件,并忽略你的 Shell 环境变量:
sudo tee /etc/apt/apt.conf.d/80proxy > /dev/null << 'EOF'
Acquire::http::Proxy "http://USER:PASS@IP:PORT/";
Acquire::https::Proxy "http://USER:PASS@IP:PORT/";
EOF
sudo chmod 600 /etc/apt/apt.conf.d/80proxy
# 检查 APT 将使用的配置,然后进行测试
apt-config dump | grep -i proxy
sudo apt update每行末尾必须以分号结尾,如果密码包含 @、: 或 #,必须进行百分号编码(@ 转换为 %40)。如果随后执行 apt update 时提示 407 Proxy Authentication Required 并停止,说明文件中的登录凭据有误;请参见 407 页面。
通过 SOCKS5 代理使用 APT
较新的 APT 版本(Ubuntu 18.04 及更高版本)也支持在相同的配置项中使用 SOCKS5 URL,例如 Acquire::http::Proxy "socks5h://USER:PASS@IP:PORT";。代理订单必须处于 SOCKS5 或双模式(dual mode),这排除了越南 IP(仅支持 HTTP)。如果你使用的 APT 版本不支持该协议方案,请使用上述 HTTP 形式。
仅为单条命令设置代理
如果想在不修改配置文件的情况下进行测试,可以在命令行中直接传递选项:sudo apt -o Acquire::http::Proxy="http://USER:PASS@IP:PORT/" update。此方式不会保存任何配置。
哪个文件控制哪个程序
Linux 上大多数关于“代理未生效”的反馈,通常是因为在错误的位置设置了正确的配置。有两条规则可以解释几乎所有这类问题:sudo 默认会丢弃当前用户的环境变量,而 systemd 服务从不读取 ~/.bashrc。
| 层级 | 设置位置 | 读取程序 | 生效期限 |
|---|---|---|---|
| 登录 Shell | ~/.bashrc 或 /etc/profile.d/proxy.sh | curl, wget, python, git, node | 每个新的登录 Shell |
| PAM 会话 | /etc/environment | 所有用户会话 | 重启后依然有效 |
| APT | /etc/apt/apt.conf.d/80proxy | apt update, apt install | 永久有效(仅限 APT) |
| systemd 单元 | /etc/systemd/system/<svc>.service.d/proxy.conf | Docker 守护进程、自定义服务 | 执行 daemon-reload 并重启服务后 |
适用于 curl、wget 和脚本的 Shell 变量
请同时定义小写和大写变量:curl 和 wget 会读取 http_proxy,而其他运行时环境只检查 HTTP_PROXY。no_proxy 列表可确保本地环回和私有网段不经过代理。
# /etc/profile.d/proxy.sh - Shell 和 CLI 工具
sudo tee /etc/profile.d/proxy.sh > /dev/null << 'EOF'
export http_proxy="http://USER:PASS@IP:PORT"
export https_proxy="http://USER:PASS@IP:PORT"
export HTTP_PROXY="http://USER:PASS@IP:PORT"
export HTTPS_PROXY="http://USER:PASS@IP:PORT"
export no_proxy="localhost,127.0.0.1,::1,10.0.0.0/8,172.16.0.0/12,192.168.0.0/16"
export NO_PROXY="$no_proxy"
EOF
source /etc/profile.d/proxy.sh密码中的特殊字符在此处同样需要进行百分号编码。APT 拥有自己的配置文件,如上文所述。
由 systemd 管理的服务
由 systemd 启动的守护进程只能看到其单元文件中声明的环境变量。将变量添加到配置片段(drop-in)中,重载配置并重启服务即可。Docker 配置指南详细介绍了 Docker 守护进程与容器的代理设置。
# /etc/systemd/system/<svc>.service.d/proxy.conf
[Service]
Environment="HTTP_PROXY=http://USER:PASS@IP:PORT"
Environment="HTTPS_PROXY=http://USER:PASS@IP:PORT"
Environment="NO_PROXY=localhost,127.0.0.1"
sudo systemctl daemon-reload
sudo systemctl restart <svc>sudo、共享服务器与桌面环境
- sudo:运行
sudo -E curl ...可保留当前导出的环境变量,或通过sudo visudo添加Defaults env_keep += "http_proxy https_proxy HTTP_PROXY HTTPS_PROXY no_proxy NO_PROXY"实现永久生效。 - 多用户机器上的凭据安全:这些文件以明文形式保存代理密码。请严格限制其访问权限,例如执行
sudo chmod 600 /etc/apt/apt.conf.d/80proxy。 - GNOME 桌面:设置 → 网络 → 网络代理 → 手动,或通过
gsettings set org.gnome.system.proxy mode 'manual'以及org.gnome.system.proxy.http下的 host 和 port 键值进行配置。
测试与故障排查
加载配置文件后,运行 curl -s https://api.ipify.org 应输出代理 IP,而不是服务器自身的地址。如需查看国家/地区和所有者的完整信息,可将该 IP 粘贴至 IP 查询。如果不想为整个 Shell 设置代理,curl 和 Python requests 指南介绍了针对单个命令设置代理的替代方案。
操作步骤
- 1
为 APT 配置独立的代理文件
由于 sudo apt update 会忽略 Shell 环境变量,请创建包含 Acquire::http::Proxy 和 Acquire::https::Proxy 的 /etc/apt/apt.conf.d/80proxy,然后使用 apt-config dump 进行检查。
- 2
编写 /etc/profile.d/proxy.sh
同时以小写形式导出 http_proxy、https_proxy 和 no_proxy,并以大写形式导出 HTTP_PROXY、HTTPS_PROXY 和 NO_PROXY,确保所有 CLI 工具都能识别它们。
- 3
根据需要添加 systemd 补充配置
针对每一个需要走代理的守护进程,创建一个包含 Environment 配置行的 proxy.conf 补充配置文件,然后运行 daemon-reload 并重启该服务。
- 4
确认出口 IP
运行
source /etc/profile.d/proxy.sh,随后执行curl -s https://api.ipify.org,终端输出应为你所配置的代理 IP。
常见问题
真的有必要同时配置 http_proxy 和 HTTP_PROXY 吗?
是的。像 curl 和 wget 等部分工具会读取小写变量名,而另一些工具只识别大写变量名。两者同时设置可以避免行为不一致。
为什么 sudo apt update 没有使用我的代理?
除非显式传递 -E 参数,否则 sudo 会重置环境变量。在 /etc/apt/apt.conf.d/ 中添加配置文件可以让 APT 始终使用代理。
如何在 Ubuntu 桌面图形界面中设置代理?
打开设置 → 网络 → 网络代理并选择手动,或者通过 gsettings 在 org.gnome.system.proxy 下进行配置。
静态代理对 Linux 服务器有用吗?
很有用,特别是在远程 API 或合作伙伴对你的 IP 设置了白名单时。独享 IPv4 只要持续续费就会始终保持同一地址,从而保证白名单记录持续有效。
来源
适用于服务器与自动化脚本的固定 IP 代理
支持用户名与密码认证的 HTTP(S) 代理,独享 IPv4 且流量不设限,每次续费均保持同一地址不变。
对比价格