proxy-usage

name	proxy-usage
description	第三方代理统一入口 — 快代理 (HTTP) + Cliproxy (HTTP, 端口 3010)。 按使用链路组织: 场景→诊断→提取→验证→注入。供应商细节放在参考区，按需查阅。 凭证统一走 .env，禁止硬编码。

proxy-usage

逆向工程中代理的唯一入口。四个步骤走到底：

场景判断 → 诊断/提取 → 验证 → 注入工具链

在动手之前:

• 新供应商/新账号 → 先诊断，确认产品可用再提取
• 已有可用代理 → 跳到「RE 工具食谱」选对应工具
• 不知道选哪个 → 看「场景 → 供应商路由」

---

走一遍

第一步: 判断场景

目标网站在国内?  → 快代理 (HTTP 代理，国内 IP)
目标网站在海外?  → Cliproxy (HTTP 代理，海外住宅 IP)
需要固定 IP 长期持有? → 快代理 独享 / Cliproxy 静态 ISP
需要每次换 IP (轮换)? → 快代理 隧道 / Cliproxy Rotating
需要同 IP 保持 N 分钟? → Cliproxy Sticky (t-N) / 快代理私密(粘滞)

不确定就选 快代理 私密代理 (dps)，最通用。

第二步: 诊断 + 提取

快代理 — 先诊断再提取:

$py = "D:\reverse_ENV\.venv\Scripts\python.exe"

# 1. 诊断 (必做 — 确认哪些产品可用、余额是否够)
& $py "D:\reverse_ENV\skill\proxy-usage\scripts\kuaidaili_extract.py" --diagnose

# 2a. 白名单模式: 提取 ip:port 后直接验证
& $py "D:\reverse_ENV\skill\proxy-usage\scripts\kuaidaili_extract.py" --product dps --count 3 --check

# 2b. 账密模式: 需要代理 user/pass 时必须显式加 --with-auth
& $py "D:\reverse_ENV\skill\proxy-usage\scripts\kuaidaili_extract.py" --product dps --count 3 --with-auth --check

默认输出会脱敏代理 URL 和账密。需要给工具链复制明文时，显式加 --show-secret；只想逐行打印原始代理 URL 时用 --print-raw。

Cliproxy — 拼接用户名 + 直连:

$py = "D:\reverse_ENV\.venv\Scripts\python.exe"

# 1. 测试连通性
& $py "D:\reverse_ENV\skill\proxy-usage\scripts\cliproxy_test.py" --env "D:\reverse_ENV\skill\proxy-usage\.env"

# 2. 按需拼接用户名参数 (见下方「Cliproxy 参考」→「用户名分段参数」)
# Rotating: youruser-region-US-st-California
# Sticky:   youruser-region-US-st-Texas-sid-sess1-t-30

Cliproxy 网络前置 (大陆环境): 端口 3010 (HTTP 代理) 大陆直连可达。瓶颈不在网络层，在 IP 白名单: Cliproxy 要求连接来源 IP 在白名单中，大陆 IP 无法加入。当前用 Clash Verge 将 *.cliproxy.io 流量路由到 HK 节点，由 HK 出口 (可白名单) 连 Cliproxy。拓扑:

PC(大陆) → Clash → HK 节点 → us.cliproxy.io:3010 (HTTP) → 目标
              ↑ HK IP 可加入白名单

Clash 规则: DOMAIN-SUFFIX,cliproxy.io,<HK节点名>。Clash 开启后 Python/curl 代码无需改动，直连即通。

第三步: 验证

# HTTP 代理 (快代理 / Cliproxy 通用)
& "D:\reverse_ENV\.venv\Scripts\python.exe" "D:\reverse_ENV\skill\proxy-usage\scripts\proxy_check.py" `
    --proxy "http://user:pass@ip:port"

第四步: 注入工具链

按你用的工具对号入座:

工具	怎么注入
ruyi-mcp 浏览器	ruyi_new_page(proxy="http://...")
Python requests	requests.get(url, proxies={"http": proxy_url, "https": proxy_url})
curl	curl -x "http://user:pass@host:port"
mitmproxy (ldplayer 抓包)	mitmdump --mode upstream:http://proxy_ip:port
aiohttp / httpx	session.get(url, proxy=proxy_url) / Client(proxy=proxy_url)

具体代码见下方「RE 工具食谱」。

完整示例: 用快代理给 ruyi-mcp 浏览器挂代理

$py = "D:\reverse_ENV\.venv\Scripts\python.exe"

# 1. 诊断
& $py "D:\reverse_ENV\skill\proxy-usage\scripts\kuaidaili_extract.py" --diagnose

# 2. 白名单模式: 提取 1 个 HTTP 代理，输出会脱敏
& $py "D:\reverse_ENV\skill\proxy-usage\scripts\kuaidaili_extract.py" --product dps --count 1

# 3. 账密模式: 需要明文 URL 时显式开启
& $py "D:\reverse_ENV\skill\proxy-usage\scripts\kuaidaili_extract.py" --product dps --count 1 --with-auth --print-raw

# 4. 在 ruyi-mcp 中使用明文代理 URL
# ruyi_new_page(url="https://目标", proxy="<上一步 --print-raw 输出的 URL>")

---

供应商参考

快代理

产品线:

产品	代码	协议	特点
私密代理	dps	HTTP/HTTPS	独享，手动提取，最通用
隧道代理	tps	HTTP/HTTPS	固定隧道地址，自动换 IP
独享代理	kps	HTTP/HTTPS	独占端口，长期持有
开放代理	ops	HTTP/HTTPS	共享池，成本低
海外动态	fps	HTTP/SOCKS5	真实住宅 IP
海外静态	sfps	HTTP	固定住宅 IP

SecretId 类型 (首次必读):

级别	用途	能调的 API
账户级	管余额、建订单	getaccountbalance, createorder
订单级	提取代理、管白名单	getdps, getkps, gettps, getproxyauthorization 等

新用户典型流程: 注册 → 拿账户级 key → 充值 → 购买套餐 → 拿订单级 key → 提取代理

错用账户级 key 调 getdps → 报 -123 secret type error。 充值后未购买套餐 → 报 -5 余额充值订单不能提取私密代理。

认证三方式:

方式	何时用
API 签名 (SecretId + signature)	调用提取 API (SDK 自动处理)
账密 (user:pass@ip:port)	使用代理时
IP 白名单	固定出口 IP 场景，免账密

Python SDK:

# 安装: D:\reverse_ENV\.venv\Scripts\python.exe -m pip install kdl
import kdl
auth = kdl.Auth("secret_id", "secret_key")
client = kdl.Client(auth)
proxies = client.get_dps(num=1, format='json', pt=1)   # pt: 1=HTTP 2=HTTPS 3=SOCKS5
# → ["1.2.3.4:5678"]
auth_info = client.get_proxy_authorization(plain_text=1)  # 取账密用于拼接

隧道代理: 不需要提取 IP，用固定隧道地址 + 账密直连:

from urllib.parse import quote

proxy_url = f"http://{quote(username, safe='')}:{quote(password, safe='')}@{tunnel_host}:{tunnel_port}"
# 每次请求自动换 IP

文档直达: API 概览 | SDK 样例 | 创建订单 API | 鉴权信息

---

Cliproxy

HTTP 代理，海外住宅 IP，按流量计费。端口 3010，大陆直连可达 (仅 IP 白名单限制)。

核心机制: 用户名分段参数

不走传统 API 提取，把路由参数编码到用户名:

<username>-region-<国家>-st-<州>-sid-<会话ID>-t-<分钟>

SID 硬约束: <会话ID> 只使用 ASCII 字母、数字、下划线，例如 job12165_p1。禁止使用 -；用户名本身以 - 分段，含连字符的 SID 可能被截断并与其他任务碰撞，导致不同请求实际复用同一出口 IP。cliproxy_test.py 已对此 fail-fast。

参数	含义	示例
region-XX	ISO 3166-1 国家	region-US, region-SG
st-XXX	州/省 (可选)	st-California
sid-XXX	会话 ID，变了就换 IP	sid-myapp_sess1
t-N	Sticky 分钟 (可选, 最长 120)	t-30

Rotating (每次换 IP): 不写 sid 和 t

youruser-region-US-st-California

Sticky (N 分钟不变): 写 sid 和 t

youruser-region-US-st-Texas-sid-sess1-t-30

批量分页、图片/CDN 下载、断点续跑和并发诊断见 Cliproxy 批量任务实战。

连接:

from urllib.parse import quote

proxy_url = f"http://{quote(username, safe='')}:{quote(password, safe='')}@{host}:{port}"
# host: us.cliproxy.io (美) 或 sg.cliproxy.io (新)
# port: 3010
# 原生 HTTP 代理，requests/curl/ruyi 直接支持，无需额外依赖

网络前置 (大陆): 端口 3010 大陆直连可达。瓶颈是 IP 白名单 — 大陆 IP 无法加入。通过 Clash HK 节点中继:

PC(大陆) → Clash → HK 节点 → us.cliproxy.io:3010 → 目标

Clash 开启后代码无需改动，http://user:[e-mail]:3010 直连即通。

白名单模式: 在后台将 HK 出口 IP 加入白名单后，可省略账密，直接用 http://host:3010。

API 模式 (端口绑定): 在 Web 面板生成 API URL → GET 请求触发绑定 → 该端口固定 IP。适合需要预先选好 IP 再操作的场景。

文档直达: 帮助中心 | 流量包 API | 账密模式 | 静态 ISP

---

RE 工具食谱

ruyi-mcp 浏览器

# 快代理 HTTP
ruyi_new_page(url="https://目标", proxy="http://user:pass@ip:port")

# Cliproxy HTTP
ruyi_new_page(url="https://目标",
    proxy="http://user-region-US-st-CA:[e-mail]:3010")

ruyi-mcp 代理在 ruyi_new_page 时设置，启动后无法切换。多代理需求用多标签页。

Python requests

import requests

# 快代理 HTTP
proxies = {"http": "http://user:pass@ip:port", "https": "http://user:pass@ip:port"}
resp = requests.get("https://目标", proxies=proxies, timeout=15)

# Cliproxy HTTP
proxies = {
    "http": "http://user-region-US-sid-sess1-t-30:[e-mail]:3010",
    "https": "http://user-region-US-sid-sess1-t-30:[e-mail]:3010",
}
resp = requests.get("https://目标", proxies=proxies, timeout=30)

注意: session.proxies = {...} 在某些 requests 版本不生效，建议每次 get()/post() 显式传 proxies=。

curl

# HTTP 代理
curl -x "http://user:pass@ip:port" "https://目标"

# Cliproxy HTTP
curl -x "http://user-region-US:[e-mail]:3010" "https://目标"

aiohttp / httpx

# aiohttp
async with aiohttp.ClientSession() as session:
    async with session.get(url, proxy="http://user:pass@ip:port") as resp:
        data = await resp.json()

# httpx
with httpx.Client(proxy="http://user:pass@ip:port") as client:
    resp = client.get(url)

mitmproxy 上游 (ldplayer 抓包链)

# 模拟器 → mitmproxy(抓包) → 上游付费代理 → 目标
mitmdump --mode upstream:http://user:pass@proxy_ip:port -w traffic.flow

---

脚本

脚本	用途
scripts/kuaidaili_extract.py	快代理: --diagnose 诊断 + --product dps/tps/kps/ops 提取 + --check 验证
scripts/cliproxy_test.py	Cliproxy: --full 对比 Rotating vs Sticky, 单次 --region US --sticky 30
scripts/proxy_check.py	通用: 验证单个/批量代理可用性 (HTTP + SOCKS5)

凭证: 三个脚本都支持 --env <路径> 从 .env 文件读取。推荐把凭证写在 skill/proxy-usage/.env（已 gitignored），一行命令加载:

$py = "D:\reverse_ENV\.venv\Scripts\python.exe"
$env_path = "D:\reverse_ENV\skill\proxy-usage\.env"
& $py "D:\reverse_ENV\skill\proxy-usage\scripts\kuaidaili_extract.py" --env $env_path --diagnose
& $py "D:\reverse_ENV\skill\proxy-usage\scripts\cliproxy_test.py" --env $env_path
& $py "D:\reverse_ENV\skill\proxy-usage\scripts\proxy_check.py" --env $env_path --proxy "http://user:pass@ip:port"

或设一次系统环境变量 (持久化，重启仍有效):

# 快代理
[Environment]::SetEnvironmentVariable("KDL_SECRET_ID", "xxx", "User")
[Environment]::SetEnvironmentVariable("KDL_SECRET_KEY", "yyy", "User")
# Cliproxy
[Environment]::SetEnvironmentVariable("CLIPROXY_USER", "xxx", "User")
[Environment]::SetEnvironmentVariable("CLIPROXY_PASS", "yyy", "User")

---

规范

凭证管理

禁止硬编码。 凭证只走三个渠道，优先级从高到低:

1. 环境变量 (KDL_SECRET_ID, CLIPROXY_USER 等)
2. .env 文件 (skill/proxy-usage/.env 或 workspace/<项目>/.env)
3. 项目凭证文件 (workspace/<项目>/proxy_creds.json)

所有凭证文件已加入 .gitignore。

故障排查

症状	原因	动作
快代理 -123 secret type error	账户级 key 调了订单级 API	购买套餐后换订单级 key
快代理 -5 余额充值订单不能...	充值了但没买套餐	会员中心购买产品套餐
Cliproxy TCP timeout	大陆直连被阻断	开启 Clash (HK 节点)
代理连上但目标返回 403	IP 被目标封禁	换 IP
代理返回 407	认证失败	检查账密/白名单配置
Sticky 模式 IP 变了	会话过期	加大 t-N 值
不同 SID 仍复用同一 IP	SID 含 - 被分段截断，或 SID 实际重复	改用 [A-Za-z0-9_]+；验证 SID 内同 IP、SID 间不同 IP
进程存活但产物数不增长	代理超时重试、供应商并发节流、同 IP 已被 WAF 标记	连续两个观测窗口检查落盘计数；降低并发或换 SID/IP，不要只延长 timeout
高并发先快后停	供应商账号/线路并发限制或 Sticky IP 被目标限速	从 4 并发基线逐级增加；零增长立即回退，已落盘页必须跳过
CDN 直连 TLS 失败	大陆到静态资源 CDN 的 TLS/线路问题	用已验证代理下载；断点跳过已有文件，Sticky 出口降速后换新 SID
Cliproxy 返回 403 forbidden ip=...	连接来源 IP 不在白名单	确认 Clash HK 节点开启；在 Cliproxy 后台将 HK 出口 IP 加入白名单
ruyi-mcp 代理不生效	浏览器已启动	ruyi_browser_quit 后重新 ruyi_new_page

禁止事项

• 硬编码凭证到代码/文档
• 代理未验证可用就直接跑逆向 (先跑 proxy_check.py)
• 同一 IP 跨项目混用 (封禁连带)
• 同目标高频请求不做 IP 轮换
• 代理流量用于非逆向用途