代理列表下载｜支持txt/CSV/API多种格式

什么是代理列表？

代理列表是您所购代理的逐行记录文件，爬虫、自动化工具、反检测浏览器及账号管理程序通常通过加载此类文件实现代理轮换或账号分配。

不同工具接受的格式不同，即使是相同的代理，也需要调整格式才能直接使用。Socks5Proxy支持预选常用格式，下载列表后无需再次编辑。

手动修改列表时，哪怕只少了一个冒号，工具也无法读取整行。从一开始就下载适合工具的格式，可以避免这种错误，即使购买了新计划导致列表变化，只需重新下载相同格式即可。

可以以哪些格式获取代理列表？

在控制台「我的代理」页面或API中选择以下任一格式。选择HTTP协议将包含HTTP端口，选择SOCKS5则包含SOCKS5端口。

可随时更换格式重复获取。同一代理计划可分别生成http://格式文件（用于爬虫）和socks5://格式文件（用于浏览器），实际IP和账户信息完全一致。

从哪里下载代理列表？

支付完成后，仪表板的我的代理页面会立即显示IP列表。您可以在上方选择格式、协议、国家和计划，并下载为.txt或.csv文件。如果购买了多个计划，可以将它们合并为一个文件下载，或按计划或国家分开下载。

列表在固定高度的表格内滚动显示，每行自带复制按钮，少量使用时无需下载文件即可直接复制。

文件名包含格式和接收日期，即使多次下载也能轻松识别最新文件。CSV文件首行为列名，在电子表格中打开即可直接显示为表格。

列表页支持按国家、套餐、到期日筛选，可导出筛选结果。例如专选美国ISP专属IP导出CSV，可直接生成账户匹配表。

如何通过API获取代理列表？

在控制台API密钥页面创建密钥（仅创建时显示完整内容，请妥善保存）。遗失需重新创建，新密钥将使旧密钥立即失效。

提供两种列表接口：/proxies返回含IP、端口、账号密码、国家城市、到期日的JSON；/proxies/download返回指定格式文本行。两接口均支持国家(country)与协议(protocol)筛选。

API请求使用API密钥而非账户令牌。账户令牌仅用于控制台登录，API密钥仅用于程序化操作（如列表查询），即使密钥泄露也不会危及账户安全。所有请求必须通过HTTPS发送。

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://socks5proxy.io/api/v1/proxies/download?protocol=http&format=ip:port:user:pass"

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://socks5proxy.io/api/v1/proxies?country=us"

import itertools, requests

API = "https://socks5proxy.io/api/v1/proxies/download"
lines = requests.get(API, params={"protocol": "http", "format": "url"},
    headers={"Authorization": "Bearer YOUR_API_KEY"}, timeout=20).text.split()
pool = itertools.cycle(lines)

for url in ["https://example.com/a", "https://example.com/b"]:
    p = next(pool)
    print(requests.get(url, proxies={"http": p, "https": p}, timeout=20).status_code)

启用IP授权后列表格式变化

IP授权是将服务器公网IPv4注册到仪表盘，仅允许这些IP免密连接。最多可注册10个地址。

启用IP授权后，ip:port格式可直接连接。列表文件不含密码，适合多人协作场景。移动办公设备建议搭配账号密码使用。

注册的地址是连接代理的一方，即服务器或计算机的公网IPv4。不是注册代理IP，请注意不要混淆。公网IP可以在仪表板的IP认证栏中直接查看和添加。

将代理列表导入工具时有什么技巧？

• 账号管理工具可导入CSV文件，方便在表格中批量关联账号与IP。
• 爬虫接收http://格式，通过轮换实现每次请求使用不同代理。
• 反检测浏览器接受socks5://格式，每个配置文件设置一行。
• 如果按国家分开任务，可以应用国家过滤器，分别获取每个国家的文件。
• 购买新计划后，新的IP会添加到相同的API地址中，因此每次开始任务时，请重新获取列表。

代理列表包含哪些信息？

单行包含IP、HTTP端口、SOCKS5端口、用户名和密码，CSV和JSON中还包含国家代码、城市和计划到期日。可选国家数量：数据中心47，ISP19。

所有IP均为IPv4，在套餐周期内保持固定。因此获取的代理列表在有效期内可重复使用。

JSON列表的每个条目都包含计划类型，因此可以在程序内区分处理共享、私有、专用IP。例如，专用IP可用于账户登录，共享IP仅用于公开页面采集。

如果使用的是下载一次后长期使用的工具，请注意计划到期后相关IP将无法连接，请及时更换为新列表。通过API获取的方式则无需进行此类整理。

如何安全存储代理列表文件？

包含用户名和密码的列表文件等同于账户信息。请勿直接上传到公开仓库或多人可见的聊天室，建议存放在服务器的配置文件夹或密钥管理工具中。

若需在代码库保存代理信息，请启用IP授权并采用ip:port格式获取。由于无需密码，即使文件外泄，非授权服务器也无法建立连接。

API密钥也请按相同方式保管。若怀疑密钥泄露，在控制台创建新密钥即可立即禁用旧密钥。

如何一次性检查列表连接是否正常？

最简单的验证方法是向IP检查地址发送列表中各行的请求。若返回IP与行内IP一致则连接正常。如下方cURL循环示例，简短脚本即可在几分钟内验证数百个IP。

测试时请勿同时开启过多连接，若使用共享计划，请确保并发连接数不超过500。若某条线路无法连接，请先检查是否填错了HTTP端口与SOCKS5端口，以及认证方式是否正确。

while read p; do
  echo "$p $(curl -s -m 15 -x "$p" https://api.ipify.org)"
done < proxies.txt

获取代理列表需要先购买什么？

列表下载与API功能包含于所有套餐。共享数据中心100IP起购，月单价$0.0179起，ISP/私有/专属套餐列表获取方式相同。

使用账户令牌注册并充值后即可购买套餐，列表实时生成。最低充值金额：$30。

不同套餐的代理列表可统一管理。如需分别下载共享数据中心与专用ISP列表，请使用筛选功能；若需合并下载，请取消筛选。