Python 代理整合教學與範例

更新於 2026-10-18 約 3 分鐘閱讀

使用 Python 呼叫網頁或 API 時,可以為每次請求指定 MantaProxy 代理。本文以 Requests 為例,先驗證一個代理的出口,再將相同設定用於自己的請求。設定只作用於這段程式,不會修改系統代理。

1. 準備連線資訊與 Python 環境

開啟控制台「靜態代理管理」,點擊出口 IP,從詳情抽屜取得連線主機、連接埠、代理使用者名稱與密碼。準備 Python 3;以下命令建立獨立環境,並安裝 Requests 與 SOCKS 支援。

macOS / Linux

python3 -m venv .venv
.venv/bin/python -m pip install "requests[socks]"

Windows PowerShell

py -m venv .venv
.\.venv\Scripts\python.exe -m pip install "requests[socks]"

2. 設定 HTTP 或 SOCKS5 代理

替換下方命令中的三個 YOUR_PROXY 佔位文字,填入同一個資源的真實資料,再於同一個終端執行範例。主機只填 IP 或網域,不包含協定、連接埠或使用者名稱。程式會另行詢問密碼,輸入時不顯示字元。

macOS / Linux

export MANTA_PROXY_HOST="YOUR_PROXY_HOST"
export MANTA_PROXY_PORT="YOUR_PROXY_PORT"
export MANTA_PROXY_USERNAME="YOUR_PROXY_USERNAME"
export MANTA_PROXY_SCHEME="http"

Windows PowerShell

$env:MANTA_PROXY_HOST="YOUR_PROXY_HOST"
$env:MANTA_PROXY_PORT="YOUR_PROXY_PORT"
$env:MANTA_PROXY_USERNAME="YOUR_PROXY_USERNAME"
$env:MANTA_PROXY_SCHEME="http"

HTTP 代理使用 MANTA_PROXY_SCHEME=http;SOCKS5 改為 socks5h。字典中的 http 與 https 鍵表示目標網址的協定,值仍使用代理的連線協定;瀏覽 HTTPS 網站不需要將 HTTP 代理地址改成 https://。socks5h 由代理解析網域,socks5 則在本機解析。

完整範例:proxy_example.py

將以下程式碼儲存為 proxy_example.py,或下載同名檔案。使用者名稱和密碼的特殊字元會自動編碼;程式只顯示出口 IP,不輸出完整代理地址。

下載完整 Python 範例

"""Test one MantaProxy resource with Requests. Install: requests[socks]."""

import os
from getpass import getpass
from urllib.parse import quote

import requests


def build_proxies():
    required = ("MANTA_PROXY_HOST", "MANTA_PROXY_PORT", "MANTA_PROXY_USERNAME")
    missing = [name for name in required if not os.environ.get(name)]
    if missing:
        raise SystemExit("Set these variables first: " + ", ".join(missing))

    scheme = os.environ.get("MANTA_PROXY_SCHEME", "http").strip().lower()
    if scheme not in ("http", "socks5h"):
        raise SystemExit("MANTA_PROXY_SCHEME must be http or socks5h.")
    host = os.environ["MANTA_PROXY_HOST"].strip()
    if "://" in host or "/" in host or "@" in host:
        raise SystemExit("Use the host only, without a URL, port or credentials.")
    try:
        port = int(os.environ["MANTA_PROXY_PORT"])
        if not 1 <= port <= 65535:
            raise ValueError
    except ValueError:
        raise SystemExit("MANTA_PROXY_PORT must be a number from 1 to 65535.")

    username = os.environ["MANTA_PROXY_USERNAME"]
    password = os.environ.get("MANTA_PROXY_PASSWORD") or getpass("Proxy password: ")
    if not password:
        raise SystemExit("A proxy password is required.")
    if ":" in host and not host.startswith("["):
        host = "[" + host + "]"
    auth = quote(username, safe="") + ":" + quote(password, safe="")
    proxy_url = f"{scheme}://{auth}@{host}:{port}"
    return {"http": proxy_url, "https": proxy_url}


def main():
    proxies = build_proxies()
    with requests.Session() as session:
        session.trust_env = False
        try:
            response = session.get(
                "https://api.ipify.org?format=json",
                proxies=proxies,
                timeout=(10, 30),
            )
            response.raise_for_status()
            exit_ip = response.json()["ip"]
        except requests.exceptions.ProxyError:
            raise SystemExit("Proxy error: check host, port, protocol and credentials.")
        except requests.exceptions.Timeout:
            raise SystemExit("Timeout: check proxy reachability and the target site.")
        except requests.exceptions.SSLError:
            raise SystemExit("TLS error: check system time and trusted CA certificates.")
        except requests.exceptions.HTTPError as error:
            raise SystemExit(f"HTTP error: {error.response.status_code}")
        except requests.exceptions.RequestException:
            raise SystemExit("Request failed. Check the configuration and network.")
        except (ValueError, KeyError):
            raise SystemExit("The IP check did not return the expected JSON result.")
    print("Exit IP:", exit_ip)


if __name__ == "__main__":
    main()

範例使用 trust_env=False,避免環境代理設定影響測試,並保留 HTTPS 憑證驗證。企業網路若需要專用 CA,請在 Session 明確設定可信憑證路徑。無互動的服務可透過其密鑰管理機制注入 MANTA_PROXY_PASSWORD;本機測試使用密碼提示即可。

在自己的請求中使用相同設定

將以下程式放在 proxy_example.py 的同一目錄,替換成自己的目標網址,並沿用完整範例的例外處理。Requests 取得 HTTP 回應,不會執行網頁 JavaScript。

import requests
from proxy_example import build_proxies

with requests.Session() as session:
    session.trust_env = False
    response = session.get(
        "https://example.com/",
        proxies=build_proxies(),
        timeout=(10, 30),
    )
    response.raise_for_status()
    print(response.status_code)

3. 執行範例並驗證出口

設定參數後,在檔案所在目錄執行:

macOS / Linux

.venv/bin/python proxy_example.py

Windows PowerShell

.\.venv\Scripts\python.exe proxy_example.py
  1. 依提示輸入該代理的密碼。成功後顯示 Exit IP 和實際出口地址;文件中的示意 IP 不能用作真實連線參數。
  2. 與控制台資源的預期出口核對,再使用相同代理設定測試實際目標網址;出口驗證與業務存取需分別確認。
  3. timeout=(10, 30) 分別設定連線與讀取逾時,不是整次請求的 30 秒上限。先驗證一個資源與一個請求,再依方案與目標服務要求調整任務量。

4. 常見問題與排查

  • 缺少 MANTA_PROXY 變數或連接埠無效: 請在執行程式的同一終端設定參數,連接埠只填數字。編輯器或排程任務需單獨傳入環境變數。
  • HTTP 407、驗證失敗或 Proxy error: 核對主機、連接埠、協定與該資源的代理憑據,不要使用網站密碼或其他資源的資料。HTTPS 通道的 407 也可能顯示為 ProxyError。
  • Missing dependencies for SOCKS support: 使用執行程式的同一個 Python 安裝 requests[socks],並確認 IDE 選用了相同虛擬環境。
  • 連線逾時或 Read timed out: 確認資源有效、目前網路能存取主機與連接埠,再測試目標網站。不要只靠增加逾時或重試次數處理問題。
  • 憑證驗證失敗: 檢查系統時間、Python CA 憑證和企業網路要求,必要時明確提供可信 CA 檔案。不要以 verify=False 處理驗證或連線問題。
  • 出口 IP 不符預期: 確認執行目前範例,請求已傳入 proxies,並核對所購資源。分別驗證出口、地區及目標存取,再提供遮蓋後的錯誤資訊給支援。

5. 官方文件與相關指引

Requests: proxies / SOCKS · Requests: timeouts / errors · Python: urllib.parse.quote

繼續閱讀:查看與複製連線資訊 · 協定與設定 FAQ · 連線與網路排查 FAQ · 聯絡技術支援

這篇文章對您有幫助嗎?

您的回饋將幫助我們最佳化檔案體驗。