使用 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,不輸出完整代理地址。
"""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
- 依提示輸入該代理的密碼。成功後顯示 Exit IP 和實際出口地址;文件中的示意 IP 不能用作真實連線參數。
- 與控制台資源的預期出口核對,再使用相同代理設定測試實際目標網址;出口驗證與業務存取需分別確認。
- 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 · 聯絡技術支援