跳到正文

Python 批量检测代理:存活、延迟、出口国家

一个现成能跑的短脚本:读取 proxies.txt,用 ipinfo.io 逐个检测代理,打印表格并生成 results.csv。

脚本测什么,不测什么

存活指代理从 https://ipinfo.io/json 取回了 JSON。延迟是这次请求在你这台机器上的整体耗时,包括经代理完成的 TLS 握手。国家和网络名称(org)直接取自 JSON。协议是你在这一行里写的协议(http、socks5 或 socks5h),不是脚本检测出来的。

有两个限制要记住。一次采样不是测速:多跑几轮再比较。国家是数据库给出的答案,不是物理位置,MaxMind 解释了不同服务商为什么会不一致。不要把网络名称当成 IP 是住宅还是机房的证明,只当作提示。

脚本:check_proxies.py

#!/usr/bin/env python3
"""Check a list of proxies: alive, latency, exit country, ISP/network, protocol.

pip install "requests[socks]"
python check_proxies.py proxies.txt            # prints a table and writes results.csv

Accepted lines in proxies.txt (one proxy per line, # starts a comment):
  http://USERNAME:PASSWORD@HOST:PORT
  socks5h://USERNAME:PASSWORD@HOST:PORT
  HOST:PORT:USERNAME:PASSWORD        (treated as HTTP)
  HOST:PORT                          (treated as HTTP, no login)
"""
import csv
import sys
import time
from concurrent.futures import ThreadPoolExecutor
from urllib.parse import quote, urlsplit

import requests

CHECK_URL = "https://ipinfo.io/json"   # returns ip, country, city, org as JSON
TIMEOUT = (5, 10)                       # (connect, read) seconds
WORKERS = 20


def normalize(line):
    """Return a proxy URL or None for a blank or comment line."""
    line = line.strip()
    if not line or line.startswith("#"):
        return None
    if "://" in line:
        return line
    parts = line.split(":")
    if len(parts) == 2:
        return "http://%s:%s" % (parts[0], parts[1])
    if len(parts) == 4:
        host, port, user, password = parts
        return "http://%s:%s@%s:%s" % (quote(user, safe=""), quote(password, safe=""), host, port)
    raise ValueError("cannot read line: " + line)


def safe_name(url):
    """host:port only, so passwords never reach the output."""
    u = urlsplit(url)
    return "%s:%s" % (u.hostname, u.port)


def check(url, own_ip):
    row = {"proxy": safe_name(url), "scheme": urlsplit(url).scheme, "alive": False,
           "ms": "", "ip": "", "country": "", "org": "", "note": ""}
    started = time.perf_counter()
    try:
        r = requests.get(CHECK_URL, proxies={"http": url, "https": url}, timeout=TIMEOUT)
        row["ms"] = int((time.perf_counter() - started) * 1000)
        if r.status_code != 200:
            row["note"] = "HTTP %d from the check site" % r.status_code
            return row
        data = r.json()
        row.update(alive=True, ip=data.get("ip", ""), country=data.get("country", ""),
                   org=data.get("org", ""))
        if own_ip and row["ip"] == own_ip:
            row["note"] = "exit IP equals your own IP: proxy not used"
    except requests.exceptions.ProxyError as e:
        row["note"] = "407 proxy login rejected" if "407" in str(e) else "proxy error (host, port, protocol or login)"
    except requests.exceptions.ConnectTimeout:
        row["note"] = "connect timeout (host or port unreachable)"
    except requests.exceptions.ReadTimeout:
        row["note"] = "read timeout (connected, no answer)"
    except requests.exceptions.SSLError:
        row["note"] = "TLS error"
    except requests.exceptions.ConnectionError:
        row["note"] = "connection error (refused or unreachable)"
    except ValueError:
        row["note"] = "answer was not JSON"
    return row


def main(path):
    urls = []
    for line in open(path, encoding="utf-8"):
        u = normalize(line)
        if u:
            urls.append(u)
    try:
        own_ip = requests.get(CHECK_URL, timeout=TIMEOUT).json().get("ip", "")
    except Exception:
        own_ip = ""
    with ThreadPoolExecutor(max_workers=WORKERS) as pool:
        rows = list(pool.map(lambda u: check(u, own_ip), urls))
    fields = ["proxy", "scheme", "alive", "ms", "ip", "country", "org", "note"]
    with open("results.csv", "w", newline="", encoding="utf-8") as f:
        w = csv.DictWriter(f, fieldnames=fields)
        w.writeheader()
        w.writerows(rows)
    for r in sorted(rows, key=lambda r: (not r["alive"], r["ms"] if r["ms"] != "" else 10**9)):
        print("%-24s %-8s %-5s %6s ms  %-2s  %-30s %s" % (
            r["proxy"], r["scheme"], "OK" if r["alive"] else "FAIL", r["ms"], r["country"], r["org"][:30], r["note"]))
    print("%d of %d alive" % (sum(r["alive"] for r in rows), len(rows)))


if __name__ == "__main__":
    if len(sys.argv) != 2:
        sys.exit("usage: python check_proxies.py proxies.txt")
    main(sys.argv[1])

需要 Python 3.9 或更高版本和 requests。只打印主机和端口,不打印密码。测试结果见来源里的本地测试。

输入文件和运行命令

# proxies.txt  (one per line; # starts a comment)
http://USERNAME:PASSWORD@HOST:2222
socks5h://USERNAME:PASSWORD@HOST:3333
HOST:2222:USERNAME:PASSWORD

# run
pip install "requests[socks]"
python check_proxies.py proxies.txt

把 HOST、USERNAME、PASSWORD 换成「我的资产」里的值。密码含特殊字符时,用 URL 形式并做百分号编码;host:port:user:password 形式由脚本自动编码。

每条说明的含义

每条说明的含义
项目可能原因检查什么
407 proxy login rejected用户名或密码错误,或 IP 租期已到重新从「我的资产」复制;特殊字符做百分号编码
proxy error(主机、端口、协议或账号)连不上代理,或代理不支持行里写的协议Proxy302 的 2222 是 HTTP、3333 是 SOCKS5;检查协议和 IP 是否对应
connect timeout主机或端口 5 秒内没有响应主机和端口、本机防火墙、本机网络
read timeout已连接,但 10 秒内没有回应再测一次;重复出现说明代理太慢或卡住
exit IP equals your own IP请求没有走代理proxies.txt 里的这一行,以及是否是一个转发你自己地址的代理

来源:我们 2026 年 11 月 17 日对脚本做的本地测试;原因是对这些错误的常规解读,不能证明某个具体代理的情况。

值得调整的设置

TIMEOUT 是 (5, 10):前一个数是连接超时,第二个是读取超时,requests 文档就是这么定义的。requests 默认不超时,所以任何检测脚本都要设超时。WORKERS 是 20;网络或查询服务吃力时调低,检测几千个代理前先看服务的使用条款。

脚本把代理传给每个请求,因为 Requests 文档说明环境变量里的代理会覆盖 session.proxies。希望由代理解析域名时用 socks5h://,由本机解析时用 socks5://;两者都需要 requests[socks]。更详细的 proxies 字典用法见已有的 Python requests 指南。

用 Proxy302 怎么做

  1. 第 1 步

    打开「我的资产」,为每个 IP 复制 HOST、PORT、USERNAME 和 PASSWORD。租用的 IP 各有一种协议,购买时选定:HTTP 用 2222 端口,SOCKS5 用 3333 端口。动态住宅是一个网关、一个账号,两种协议都能用。

  2. 第 2 步

    在 proxies.txt 里每个 IP 写一行,协议前缀要和购买的协议一致,然后运行脚本。

    预期结果 OK 行显示你购买的国家和网络名称;没有行提示代理未生效。

  3. 第 3 步

    如果某一行失败,用 curl 和同一行再测这一个代理。仍然失败的话,把订单号和脚本打印的说明发给支持。

常见问题

Python 怎么检测带账号密码的代理列表?

把账号写进代理 URL,http://USERNAME:PASSWORD@HOST:PORT,并按 Requests 文档的方式传给 proxies 参数。脚本也能读 HOST:PORT:USERNAME:PASSWORD 格式的行,并自动给账号编码。

怎么测代理的速度?

脚本里的毫秒数是一次小请求的耗时,反映的是响应速度,不是带宽。在不同时段多跑几次再比较;要测带宽,请通过代理下载一个较大的文件。

为什么不同查询网站显示的出口国家不一样?

每个服务都有自己的数据库,更新时间也不同。判断前先在两三个服务里核对国家;关于城市和国家不一致的指南解释了原因。

脚本支持 SOCKS5 吗?

支持,安装 requests[socks],并在行里写 socks5:// 或 socks5h://。我们的本地测试里 SOCKS5 只测了端口关闭的情况,验证的是出错路径,不是真实的 SOCKS5 代理。

Proxy302 的代理能免费检测吗?

没有免费试用,所以要先购买代理才能检测。最小的购买是 1 GB 动态住宅流量,或一个 IP 一天。

参考资料

4
  1. Requests 文档:Advanced usage

    官方文档 · 确认日期:

    2026 年 11 月 17 日读取:proxies 参数含 http 和 https 两个键;账号密码写成 http://user:password@host;代理 URL 必须带协议;环境变量里的代理会覆盖 session.proxies;SOCKS 需要 requests[socks],socks5 在本机解析 DNS,socks5h 由代理解析;默认不超时;timeout 元组是(连接,读取)。

  2. 脚本的本地测试

    本地示例 · 确认日期:

    2026 年 11 月 17 日用 Python 3.9 和 requests 2.32 对本地测试代理运行:通向 ipinfo.io 的隧道(存活;出口 IP 与本机 IP 相同,所以提示代理未生效)、返回 407 的代理(行内带和不带账号各一次)、接受连接后不回应的代理(读取超时)、关闭的 HTTP 代理端口和关闭的 SOCKS5 端口。每种情况都输出了表格里的对应说明。没有通过真实的远程代理做查询。

    这次测试没有测量真实代理的延迟和国家。

  3. MaxMind:IP 定位差异说明

    官方文档 · 确认日期:

    2026 年 11 月 17 日读取:ISP 可以把地址在大范围内重新分配或转租,也没有义务公开网络所在位置,所以某个数据库可能保留过时的位置;精确度随要求的详细程度而变化。

  4. Proxy302 产品信息和价格表

    产品观察 · 确认日期:

    站点产品信息文件,11 月 10 日对照控制台、后端和价格表核对:机房 IP 按 IP 租用,1 天 US$0.25、30 天 US$3.99;静态 ISP 1 天 US$0.50、30 天 US$7.99,各国同价;HTTP 端口 2222、SOCKS5 端口 3333;按 IP 租用的每个 IP 一种协议;动态住宅走 proxy.proxy302.com,一个账号两种协议都能用;没有免费试用。

准备好试试了吗?

注册账号、充值一次,就能选动态住宅、静态 ISP 或数据中心 IP,几分钟配进你的浏览器。