分层详解:在 Ubuntu 和 Debian 上配置代理

· Updated:

在 Ubuntu 上配置代理实际上包含四个独立的环节,因为 Linux 没有全局通用的统一代理开关。Shell 读取环境变量,APT 读取专属配置目录,systemd 服务读取 Unit 补充配置(drop-in),而 GNOME 桌面则使用 gsettings。你只需配置实际用到的层级即可;以下代码示例均基于带有用户名和密码的 ProxyV4 HTTP(S) 代理。

Ubuntu / Linux · HTTP
export 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
购买 新加坡

带用户名和密码的 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.shcurl, wget, python, git, node每个新的登录 Shell
PAM 会话/etc/environment所有用户会话重启后依然有效
APT/etc/apt/apt.conf.d/80proxyapt update, apt install永久有效(仅限 APT)
systemd 单元/etc/systemd/system/<svc>.service.d/proxy.confDocker 守护进程、自定义服务执行 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 指南介绍了针对单个命令设置代理的替代方案。

  • `407 Proxy Authentication Required`:认证凭据错误或密码中包含未编码的特殊字符;请参见 407 页面。
  • apt 仅在配合 sudo -E 时生效:80proxy 文件缺失或存在语法错误(每行必须以分号结尾)。
  • 连接挂起:服务器防火墙可能阻止了代理端口的出站访问;请排查 防火墙原因。

操作步骤

  1. 1

    为 APT 配置独立的代理文件

    由于 sudo apt update 会忽略 Shell 环境变量,请创建包含 Acquire::http::Proxy 和 Acquire::https::Proxy 的 /etc/apt/apt.conf.d/80proxy,然后使用 apt-config dump 进行检查。

  2. 2

    编写 /etc/profile.d/proxy.sh

    同时以小写形式导出 http_proxy、https_proxy 和 no_proxy,并以大写形式导出 HTTP_PROXY、HTTPS_PROXY 和 NO_PROXY,确保所有 CLI 工具都能识别它们。

  3. 3

    根据需要添加 systemd 补充配置

    针对每一个需要走代理的守护进程,创建一个包含 Environment 配置行的 proxy.conf 补充配置文件,然后运行 daemon-reload 并重启该服务。

  4. 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 且流量不设限,每次续费均保持同一地址不变。

对比价格

Related articles

代理配置
在带认证的 HTTP 代理后运行 Docker 容器
将 Docker 容器运行、镜像构建和拉取流量通过带认证的 HTTP(S) 代理发出,借助 NO_PROXY 保持服务间内部通信,并完成出口 IP 验证。
代理配置
通过带认证的代理使用 cURL:验证代理可用的测试命令
在任意系统上使用 -x 和 -U 通过带认证的 HTTP(S) 代理发送 cURL 请求,确认出口 IP,查看 CONNECT 握手过程并测量每次请求的耗时。
代理配置
分步指南:通过带认证的代理发送 Python requests 请求
通过带认证的 HTTP(S) 代理发送 Python 请求:构建 proxies 字典、绑定至 Session、对特殊密码编码、轮询代理列表并验证出口 IP。
免费工具
批量检测代理:可用状态、出口IP与延迟
免费在线代理检测工具:粘贴多达100条 ip:port:user:pass 格式代理,即可查看可用状态、出口IP和延迟,并获取各类失败原因的说明与解决建议。
按平台选择代理
网页抓取专属代理:不限流量的固定 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 · united states
美国独享 IPv4 代理池:适用于数据抓取、排名追踪与广告核查
购买美国独享 IPv4 代理:静态美国数据中心 IP,单人专享,无限流量。专为数据采集、SERP 排名追踪与美国广告投放检查打造。