使用 Python 调用网页或接口时,可以在每次请求中指定 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 · 联系技术支持