Python 代理集成教程与示例

更新于 2026-10-18 约 3 分钟阅读

使用 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,不输出完整代理地址。

下载完整 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 · 联系技术支持

这篇文章对您有帮助吗?

您的反馈将帮助我们优化文档体验。