在 Ubuntu 與 Debian 上逐層配置 Proxy
由 ProxyV4 工程團隊撰寫 · Updated:
在 Ubuntu 設定 Proxy 實際上包含四個小步驟,因為 Linux 沒有統一的 Proxy 總開關。您的 Shell 讀取環境變數、APT 讀取自有的設定目錄、systemd 服務讀取 Unit Drop-in 設定檔,而 GNOME 桌面則使用 gsettings。請僅配置您所需的層級;以下代碼範例皆採用具備使用者名稱與密碼的 ProxyV4 HTTP(S) Proxy。
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 Proxy 設定
若要讓 apt 使用需要身分驗證的 Proxy,請建立 /etc/apt/apt.conf.d/80proxy,並在 Proxy 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 Proxy 使用 APT
較新的 APT 版本(Ubuntu 18.04 及更新版本)在相同的設定鍵中也支援 SOCKS5 URL,例如 Acquire::http::Proxy "socks5h://USER:PASS@IP:PORT";。訂單必須處於 SOCKS5 或雙模式(此模式不包含僅支援 HTTP 的越南 IP)。若您的 APT 版本不支援此協定架構,請使用上述的 HTTP 格式。
僅為單一指令設定 Proxy
若要在不修改設定檔的情況下進行測試,可直接在命令列傳入選項:sudo apt -o Acquire::http::Proxy="http://USER:PASS@IP:PORT/" update。此方式不會儲存任何設定。
各設定檔對應的程式
在 Linux 上,大部分「Proxy 未生效」的問題回報,都是因為把正確的數值設定在錯誤的位置。兩條規則幾乎可以解釋所有情況: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 與自訂服務 | 執行 daemon-reload 並重啟後生效 |
適用於 curl、wget 與指令碼的 Shell 變數
請同時定義小寫與大寫的變數:curl 與 wget 會讀取 http_proxy,而其他執行階段則僅檢查 HTTP_PROXY。no_proxy 清單可避免本機回傳與私人網段經過 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 啟動的常駐程式僅能讀取其 Unit 檔案中宣告的變數。請將變數加入 drop-in 設定檔,重新載入並重啟服務。Docker 設定指南詳細介紹了 Docker daemon 與容器的相關設定。
# /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"。 - 多使用者機器上的憑證安全: 這些檔案以純文字儲存 Proxy 密碼。請嚴格限制存取權限,例如執行
sudo chmod 600 /etc/apt/apt.conf.d/80proxy。 - GNOME 桌面環境: 設定 → 網路 → 網路代理伺服器 → 手動,或使用指令
gsettings set org.gnome.system.proxy mode 'manual'並設定org.gnome.system.proxy.http下的主機與連接埠設定鍵。
測試與問題排解
載入設定檔後,執行 curl -s https://api.ipify.org 應顯示 Proxy IP 而非伺服器本身的位址。若要查詢國家與擁有者的完整報告,請將 IP 貼至 IP 查詢。若您不想為整個 Shell 設定 Proxy,curl 與 Python requests 指南展示了僅套用於個別指令的替代方案。
- `407 Proxy Authentication Required`: 登入憑證錯誤或密碼包含未編碼的特殊字元;請參閱 407 錯誤說明頁面。
- apt 僅在搭配 sudo -E 時正常運作: 80proxy 檔案不存在或有語法錯誤(每一行皆須以分號結尾)。
- 連線卡住(連線逾時): 伺服器的防火牆可能阻擋了連往 Proxy 連接埠的對外連線;請檢查防火牆原因說明。
步驟說明
- 1
為 APT 建立專屬的 Proxy 設定檔
由於 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 Drop-in 設定
針對每個必須使用 Proxy 的常駐程式建立包含 Environment 行的 proxy.conf Drop-in 檔案,隨後執行 daemon-reload 並重啟服務。
- 4
確認連線出口 IP
執行
source /etc/profile.d/proxy.sh接著執行curl -s https://api.ipify.org;輸出內容應為您的 Proxy IP。
常見問題
真的需要同時設定 http_proxy 與 HTTP_PROXY 嗎?
是的。部分工具(如 curl 和 wget)會檢查小寫名稱,其他工具則僅檢查大寫名稱。兩者皆設定可避免行為不一致。
為什麼 sudo apt update 沒有使用我的 Proxy?
除非加上 -E 參數,否則 sudo 會重設環境變數。在 /etc/apt/apt.conf.d/ 中建立檔案可讓 APT 強制使用該 Proxy。
如何在 Ubuntu 桌面圖形介面中設定 Proxy?
開啟「設定」→「網路」→「網路代理」並選取「手動」,或在 org.gnome.system.proxy 下透過 gsettings 進行設定。
靜態 Proxy 對 Linux 伺服器有用嗎?
有用,特別是在外部 API 或合作夥伴將您的 IP 列入許可清單時。獨享專屬 IPv4 只要持續續約即可維持相同位址,確保許可清單設定持續有效。
資料來源
專為伺服器與腳本打造的固定 IP Proxy
支援帳號密碼認證的 HTTP(S)、獨享專屬 IPv4 不限流量,且每次續約均維持相同位址。
比較價格方案