代理总数
–
测活可用
–
协议分布
–
最近同步
–
同步数据源
从 proxy.scdn.io 抓取最新列表入库（自动去重）代理列表
| IP : 端口 | 协议 | 国家 / 地区 | 源站延迟 | 本机测活 | 更新时间 | 操作 |
|---|---|---|---|---|---|---|
| 加载中… | ||||||
- / -
API 接口文档
所有接口均为公开 GET/POST，可直接被外部程序调用（把域名换成你的工具箱地址）GET /api/proxy/list — 代理列表（JSON）
分页查询本机代理池，支持筛选。
| 参数 | 说明 |
|---|---|
| protocol | 可选，HTTP / HTTPS / SOCKS4 / SOCKS5 |
| country | 可选，国家/地区名（先查 stats 拿候选） |
| q | 可选，IP 模糊搜索 |
| ok | 可选，=1 时只返回本机测活可用的 |
| page / per_page | 分页，默认 1 / 50，per_page 最大 300 |
返回：{"ok":true,"total":269,"items":[{"ip":"1.2.3.4","port":8080,"protocol":"HTTP","country":"香港","latency":4,"ok":1,"ownLatency":180,"lastCheck":1791275000,"updatedAt":1791275000}, …]}
GET /api/proxy/export — 导出 ip:port 文本（最适合采集脚本）
纯文本，每行一条 ip:port，直接返回给外部程序解析。
| 参数 | 说明 |
|---|---|
| protocol | 可选，按协议过滤 |
| country | 可选，按国家过滤 |
| ok | 可选，=1 只导出测活可用的 |
| limit | 最多导出条数，默认 500，最大 5000 |
| scheme | 可选，=1 时输出 协议://ip:port（如 socks5://1.2.3.4:1080） |
GET /api/proxy/stats — 统计信息（JSON）
总数、可用数、各协议数量、国家候选（带数量，可用于 country 筛选）、最近同步时间、是否同步中。
POST /api/proxy/sync — 触发同步（JSON）
从 proxy.scdn.io 抓取入库，异步执行（20 秒限频）。返回后轮询 stats 的 syncing 字段看是否完成。
返回：{"ok":true,"message":"同步任务已启动，稍候刷新列表"}
POST /api/proxy/check — 单条测活（JSON）
从本机网络实测代理连通性，返回结果与本机延迟（ms）。
返回：{"ok":true,"alive":true,"latency":180}
POST /api/proxy/check/batch — 批量测活（JSON）
取最久未测的一批做并发验证（12 并发），同步返回结果。
返回：{"ok":true,"checked":50,"alive":31}