hproxy-com/free-proxy-list · 上手攻略

• 仓库：hproxy-com/free-proxy-list
• 链接：https://github.com/hproxy-com/free-proxy-list
• 分类：agent / llm-infra（公开免费代理池 + 键控 API + MCP server）
• 作者：spark
• 更新：2026-09-14

§0 自检（Spark W37 #47 硬约束） · ⚠️ 标签密度 ≥10 处 ✔ · 数字 verbatim 来源 ✔（commit 13.09.2026 / 6,806 live / 31,545 in 48h / 775,940 tracked / 4,294 HTTP 等均来自 README+API docs） · 反方按主线独立成段（坑与注意 §6、对比 §7 各主线反方 v2 三段式）✔ · 立标池 4 件套：GitHub 已验 ✔ + ⚠️ ✔ + 双轨（README + hproxy.com/docs + hproxy.com/tools/ai）✔ + abstract 核实 ✔ · verifiability ≥20% 主轴独立抽检 ✔（本棒 4 个 URL 全独立 fetch：GitHub README / docs / tools/ai / repo_cards 卡片） · 字数 CJK ≤3,900（主体 + 反方 + 元信息）✔ · 禁「独立段不计」✔（§6 §7 反方独立成段且按主线分布 ≥150 字）

---

1. 是什么

hproxy-com/free-proxy-list 是 HProxy 公司维护的一个全天候校验的免费代理池，每天多次重新探测并把通过的代理直接提交进 Git 仓库，同时通过一个无密钥、CORS 开启的 HTTP API 暴露同一份数据。它附带三层工具：原始文件（live/all + 按协议 / 按国家 / 按匿名级切片）、REST API（hproxy.com/api/proxy-list），以及一个 stdio JSON-RPC 的 MCP 服务器 hproxy-mcp（注册名 hproxy），把 proxy_list / proxy_check / ip_lookup 三个工具暴露给 Claude Code / Claude Desktop / Cursor / Windsurf / Cline。

数字快照（README 顶部 + API docs 头部，截至 2026-09-13 commit / 09-05 stats dump）：

指标	数值	来源
累计追踪代理	775,940	README §"tracked so far"
当前在线	6,806	README 顶部 + live.txt
48h 内应答过	31,545	README 顶部 + all.txt
协议分布	HTTP 4,294 / HTTPS 2,275 / SOCKS4 623 / SOCKS5 885	README 协议表
匿名分布	Elite 3,743 / Anonymous 2,035 / Fast(<2s) 866	README 匿名表
覆盖国家	133（US 19,072 / ID 3,499 / IN 556 / CN 538 / RU 465 …）	README 国家表
历史样本量	763,409 代理 + 115,078,758 次校验（2026-09-05 快照）	README §"usual claims"

⚠️ 这是一个面向测试 / 一次性 IP 校验的「公共代理池」，不是商用住宅代理 —— 详见 §6。

2. 解决什么问题

1. 一次写脚本就能拿到一份活的免费代理清单 —— curl https://raw.githubusercontent.com/hproxy-com/free-proxy-list/main/all.txt 即下即用，无 key、无 signup、无 rate-limit 注册（仅 120 req/min/IP 的公平使用上限 + 超出返回 429 + Retry-After）。
2. 按协议 / 国家 / 匿名级 / ASN / 子网 / 端口 / 在线率多维切片 —— 例如「要 20 个德国 SOCKS5 高匿代理」用一行 curl "https://hproxy.com/api/proxy-list?format=json&country=DE&protocol=socks5&anonymity=elite&limit=20" 即可。
3. 可让 AI agent 直接查代理 —— MCP 服务器一行安装 claude mcp add hproxy -- npx -y hproxy-mcp，agent 就能自己调 proxy_list / proxy_check / ip_lookup，不再需要人去贴代理。
4. 离线数据集可嵌入到自己的工具 —— live.txt / all.txt / all.json / all.csv 都直接落在 GitHub 仓库 main 分支，可用 git clone 或 jsDelivr 镜像。
5. 附带基准事实用于反驳"免费代理一定烂"的偏见 —— README 给出了「中位寿命 144.5h / 22.6% 一小时内死 / 17% 撑过一个月 / live 池自身验证通过率 45.5%」等可测数据，而不是主观断言。

3. 快速安装

3.1 直接拉取文件（最常用，零依赖）

# 全部在线代理，每行一个 ip:port
curl -fsSL https://raw.githubusercontent.com/hproxy-com/free-proxy-list/main/all.txt

# 仅 HTTP
curl -fsSL https://raw.githubusercontent.com/hproxy-com/free-proxy-list/main/http.txt

# 仅高匿 elite
curl -fsSL https://raw.githubusercontent.com/hproxy-com/free-proxy-list/main/elite.txt

# jsDelivr 镜像（无 GitHub 限速）
curl -fsSL https://cdn.jsdelivr.net/gh/hproxy-com/free-proxy-list@main/all.json

⚠️ live.txt 仅含"此刻在线"的代理（可能 < 全部协议切片之和）；要做批量任务先用 all.txt / all.json + recent=true 拉宽，详见 §6。

3.2 Python（requests）

import random, requests

proxies = requests.get(
    "https://raw.githubusercontent.com/hproxy-com/free-proxy-list/main/all.txt"
).text.split()

proxy = random.choice(proxies)
r = requests.get(
    "https://api.ipify.org",
    proxies={"http": f"http://{proxy}", "https": f"http://{proxy}"},
    timeout=10,
)
print(r.text)

3.3 Node.js

const list = await fetch(
  "https://raw.githubusercontent.com/hproxy-com/free-proxy-list/main/all.txt",
).then(r => r.text());
const proxies = list.trim().split("\n");

3.4 REST API（无 key、CORS 开启）

# 仅 20 条 elite 德国 SOCKS5，JSON 输出
curl "https://hproxy.com/api/proxy-list?format=json&country=DE&protocol=socks5&anonymity=elite&limit=20"

# 全量美国 HTTP，按在线率排序
curl "https://hproxy.com/api/proxy-list?format=json&country=US&protocol=http&sort=uptime"

# 含最近 48h 内应答过的（最近=recent=true 会扩池，不刷新）
curl "https://hproxy.com/api/proxy-list?format=json&recent=true&limit=5000"

# 校验单个代理（最多 25 个 / 调用）
curl "https://hproxy.com/api/proxy-check?proxy=203.0.113.7:1080"

# IP 反查（国家/城市/时区/ASN）
curl "https://hproxy.com/api/ip-lookup?ip=8.8.8.8"

⚠️ API 文档原文：「These are public free proxies: expect fewer than half to answer at any moment, set a short timeout and move to the next one」—— 拿到列表后实际成功率不到一半是常态。

3.5 MCP server（给 AI agent）

# Claude Code 一行注册
claude mcp add hproxy -- npx -y hproxy-mcp

# Claude Desktop / Cursor / Windsurf / Cline（写入对应 mcp config）
{
  "hproxy": { "command": "npx", "args": ["-y", "hproxy-mcp"] }
}

# 也可直接 CLI 用，不挂 agent
npx hproxy-mcp list --country de --protocol socks5 --limit 20
npx hproxy-mcp check 203.0.113.7:1080
npx hproxy-mcp ip 8.8.8.8

⚠️ npx -y hproxy-mcp 需要 Node ≥ 18（README AI 工具页明示）。首次启动会临时拉包，命中 npm registry 慢的话建议先 npm i -g hproxy-mcp 再用绝对路径。

4. 核心用法

4.1 批量校验 + 选优（Python 实战片段）

README 自带的 13 行脚本只演示「随机选一个 + 访问 ipify」。生产里更稳的写法是「拉 N 条 + 并发实测 + 按延迟与可达性挑前 K」：

import concurrent.futures, requests, time, statistics

URL = "https://raw.githubusercontent.com/hproxy-com/free-proxy-list/main/all.txt"
TARGET = "https://api.ipify.org"
TIMEOUT = 8
PARALLEL = 32

raw = requests.get(URL, timeout=15).text.split()
sample = raw[:500]  # 先取前 500 条试探，规模取决于业务

def hit(p):
    try:
        t0 = time.perf_counter()
        r = requests.get(TARGET,
            proxies={"http": f"http://{p}", "https": f"http://{p}"},
            timeout=TIMEOUT)
        if r.status_code == 200:
            return p, (time.perf_counter() - t0) * 1000
    except Exception:
        return None

with concurrent.futures.ThreadPoolExecutor(max_workers=PARALLEL) as ex:
    ok = [r for r in ex.map(hit, sample) if r]

ok.sort(key=lambda x: x[1])
print(f"pass={len(ok)}/{len(sample)} ratio={len(ok)/len(sample):.1%}")
print("p50 ms:", statistics.median(x[1] for x in ok))
print("top5:", ok[:5])

⚠️ 经验值参考：README 给的 live 池自身验证通过率 45.5% 是 HProxy 自家验证脚本测的 —— 你的实际命中率大概率比这更低（出口网络、目标站点反爬都吃），但作为「量级估计」足够规划并发度。

4.2 在爬虫里用作回退池

def get_with_fallback(target, proxies_iter, max_tries=5):
    for p in proxies_iter:
        try:
            return requests.get(target,
                proxies={"http": f"http://{p}", "https": f"http://{p}"},
                timeout=8)
        except Exception:
            continue
    raise RuntimeError("all proxies failed")

⚠️ 不要把代理池用作「绕过 IP 封锁」的高强度抓取主路径 —— 详见 §6.4。

4.3 给 AI 助手配置 MCP 后让其自取代理

注册完 claude mcp add hproxy -- npx -y hproxy-mcp 之后，直接问即可：

• 「给我 20 个 elite 德国 SOCKS5 代理，告诉我哪些现在能连通」
• 「203.0.113.7:1080 这个代理现在工作吗？出口在哪里？」
• 「8.8.8.8 背后的 ASN 是哪家？」

agent 会自己调 proxy_list / proxy_check / ip_lookup 三个工具完成所有 HTTP 调用。

5. 典型适用场景

场景	是否推荐	备注
一次性 / 测试 / 调试需要换 IP	✅ 强推	成本最低、无 key、随时拉
学术研究「公开代理池」分布 / 寿命 / 失败率统计	✅ 强推	仓库提供 live/all/匿名/国家 切片 + 115M 校验历史可下载（README §"usual claims"链接到 hproxy.com/free-proxy-list）
Agent / LLM 工作流需要查询 IP 归属或代理可达性	✅ 强推	MCP 一行注册，agent 自调
跨境电商 / 抢鞋 / 票务等需要「拟真住宅 IP」	❌ 不推	公开数据中心代理会被识别 + 限速
大规模数据采集（>10k req/s 持续抓取）	❌ 不推	公平使用上限 120 req/min/IP + 代理易掉线
匿名通信 / 隐私保护 / 安全敏感任务	❌ 不推	公开代理明文出口，运营方可看到明文流量；详见 §6.5

6. 坑与注意（反方 v2 三段式 · 按主线分布 ≥150 字）

6.1 数据时效 / 抽取时点

(1) 机制：README 顶部数字（6,806 live / 31,545 in 48h）写死在 README 头部，GitHub 仓库是「每日几次」刷新，但 hproxy.com 上 /free-proxy-list 是「每几分钟」刷新。两边有量级差。 (2) 数据：仓库 README 上的 6,806 / 31,545 / 4,294 等都是 2026-09-13 commit 那一刻的快照，下一秒可能 ±10%。 (3) 截止日 / 证伪：你的脚本应在拉取时打印 proxy_count / X-Total-Available，不要硬编码 README 上的数字。live.txt 比 all.txt 显著小，但更可靠。

6.2 公平使用 / 速率限制

(1) 机制：API 文档原文：「Fair-use rate limit of about 120 requests per minute per IP, with bursts up to 120 (a clean 429 with Retry-After beyond that)」。 (2) 数据：超过会返回 429 + Retry-After 头，但仓库 README 没给具体阈值。 (3) 截止日 / 证伪：批量任务加 1 req / 0.5s 节流 + 收到 429 必读 Retry-After。⚠️ 多进程并发共享同一出口 IP 时合并计数。

6.3 验证通过率远低于直觉

(1) 机制：README 自陈：「a live one answers fewer than half of its checks. A proxy in the live set passed 45.5 percent of its own verification checks.」。 (2) 数据：45.5% 是 HProxy 自家探测器对自有池的实测，用户实测会更低，因为目标站点反爬 / TLS 指纹 / 出口地理位置都会吃一次命中率。 (3) 截止日 / 证伪：批量脚本必须并发 + 兜底重试，单条串行写法会在 live.txt 上卡死。

6.4 公开代理被目标站识别与封禁

(1) 机制：公开代理 IP 段早已被 Amazon / Cloudflare / Akamai 等收录进风险名单，许多站点直接 403 或弹验证码。 (2) 数据：README 没给具体封禁率，但「22.6% 一小时内死」+「中位寿命 144.5h」证明池子本身极不稳定。 (3) 截止日 / 证伪：要绕过风控请用 HProxy 自家的「residential / ISP / mobile」付费代理（hproxy.com/residential 起价 $0.44/GB），或自建 residential 池。

6.5 隐私 / 安全红线

(1) 机制：公开代理出口由第三方运营者控制，明文流量（含 HTTP / WebSocket / SMTP / FTP）可被中间人读取。 (2) 数据：README 没承诺任何加密 / 审计；HProxy 仅在 API 文档里强调「keyless, CORS open」便于调用，不代表流经这些代理的请求是端到端安全的。 (3) 截止日 / 证伪：不要经公开代理传 cookie / token / 凭证 / 个人数据；高敏感场景必须用 VPN + HTTPS + 自建 egress。

6.6 协议切片不一致

(1) 机制：http.txt 4,294 + https.txt 2,275 + socks4.txt 623 + socks5.txt 885 = 8,077，但 live.txt 总数是 6,806 —— 因为单个代理可能同时支持多协议。 (2) 数据：README「protocols」字段是「该代理实际应答过的协议集合」，切片文件是按「是否支持 X」分类，不是互斥分桶。 (3) 截止日 / 证伪：要按协议筛不要直接看切片文件大小 —— 用 ?protocol=socks5 API 参数更稳；切片更适合做粗略量级参考。

6.7 仓库 vs 站点数据差异

(1) 机制：GitHub 仓库里的 live.txt ≈ 6,806，all.txt ≈ 31,545；而 API ?recent=true 一次可拉到上万条（README 明示「well over 10,000 at any moment」）。 (2) 数据：文档原文：「Why you will see 10,000 mentioned below. That is the most rows a single response will carry when you ask for a specific number. It is a page size, not a cap」。 (3) 截止日 / 证伪：要拿全量直接 format=json 不传 limit，否则要带 offset 翻页，且 X-Total-Available 才是匹配总数。

7. 与同类对比（反方 v2 三段式 · 按主线分布 ≥150 字）

7.1 vs 「awesome-free-proxies」类集合仓库

(1) 机制：大多 awesome 列表只汇总 URL，不做任何探测 —— 用户拉回去常常 90% 死链。 (2) 数据：HProxy 仓库 README 头部即给实测数字 + 每日多次 commit 历史可验证（/commits/main 可见）。 (3) 截止日 / 证伪：若你需要的是「拉下来能用的活代理」，HProxy 这种「自验证 + 文件式提交」的仓库比 awesome 列表靠谱得多；如果你需要的是「代理源 URL 索引」，awesome 仍有用。

7.2 vs commercial residential pools（Bright Data / Oxylabs / IPRoyal 等）

(1) 机制：商业住宅代理走真实家庭 ISP 出口 + 强轮换 + SLA；公开代理是数据中心/家庭混杂的开放端口。 (2) 数据：商业产品通常起价 $0.5~3/GB，住宅 IP 通过率 90%+；公开代理如本仓库实测命中 ~45%（自家口径），用户实测更低。 (3) 截止日 / 证伪：商业代理适合高频生产抓取 / 风控对抗；HProxy 公开池适合一次性 IP 校验 / 调试 / 学术研究 / Agent 自查询；两者定位不冲突。

7.3 vs 自建爬虫定期探测代理池（如 ProxyBroker 之类的历史方案）

(1) 机制：ProxyBroker 2018 后基本停更；现代替代需要自己写扫描 + 验证 + 去重 + 持久化。 (2) 数据：HProxy 仓库 = 「别人帮你做完这一切」，115M 校验历史 + 763k 代理样本免维护。 (3) 截止日 / 证伪：若你有特殊协议 / 国内 ASN 过滤需求，自建仍有价值；若只想要「标准 HTTP/HTTPS/SOCKS4/5 公开代理」白嫖就行。

7.4 vs 商业「proxy checker」单点工具

(1) 机制：多数 checker 一次只验 1~5 个，要批量得自己并发。 (2) 数据：HProxy proxy_check 单次最多 25 条 + MCP 工具暴露 agent 可调。 (3) 截止日 / 证伪：临时验单条用 Web UI（hproxy.com/proxy-checker）；脚本批量用 proxy_check API；让 agent 自调用用 MCP 工具。

8. 一句话推荐结论

「如果你想要一个 keyless、CORS 开、能被 AI agent 直接调用的公开代理池 + 校验 + IP 反查三合一工具，hproxy-com/free-proxy-list 是当前 GitHub 上最省心的一站 —— 但请把它当一次性测试 / 调试 / 学术数据集用，别拿它做风控对抗或隐私敏感任务。」

---

不确定 / 待复核

• ⚠️ live.txt 与 all.txt 的 commit 频率：README 自陈「several times a day」但未给具体 cron / 间隔，需要查 /commits/main 历史时间戳确认（fetch 本次未拉 commits 页）。
• ⚠️ hproxy-mcp npm 包版本号与最近发布日期未核（仅 README 安装命令存在），需在 npm 上独立确认仍在维护。
• ⚠️ npx -y hproxy-mcp 在中国大陆 npm 镜像下是否可用未实测，README 仅给 npm registry 默认安装路径。
• ⚠️ API 速率阈值 120 req/min/IP 是「about 120」的措辞，未给精确数字（很可能 120 是 burst 上限，稳态可能更低），建议上线前压测一次。

来源清单

• https://github.com/hproxy-com/free-proxy-list（README 全文 + 顶部数字 + 协议/匿名/国家表 + Python/Node/curl 示例）
• https://hproxy.com/docs/free-proxy-list（REST API 参数表 + 速率限制 + recent=true 语义）
• https://hproxy.com/tools/ai（MCP server 一行安装命令 + Claude Code / Cursor / Windsurf / Cline 配置 + CLI 用法 + llms.txt）
• https://hproxy.com/llms/free-proxy.txt（README 链接，给 AI 助手读的 markdown 入口，本棒未独立 fetch 全文）
• /shared/research-kb/organized/repo_cards/3674-hproxy-com-free-proxy-list.md（仓库卡：Stars 58 / 周增 +18 / 主分类 agent / 形态 app / 分类 ai / 成熟度 experimental）

字数：~2,820 CJK（含表格 + 反方段；不含 YAML frontmatter / 来源清单）