CrawlRelay 代理文档：快速开始

我如何发送第一个请求？

从您的控制面板复制用户名和密码，然后运行下面的任一命令。每个命令都会打印网站看到的 IP 地址，该地址通常每次运行时都会改变。

curl -x http://USERNAME-country-us:[email protected]:7777 https://api.ipify.org

import requests

proxy = "http://USERNAME-country-us:[email protected]:7777"
r = requests.get("https://api.ipify.org", proxies={"http": proxy, "https": proxy}, timeout=(10, 30))
print(r.text)

import { ProxyAgent, fetch } from "undici";

const dispatcher = new ProxyAgent("http://USERNAME-country-us:[email protected]:7777");
const res = await fetch("https://api.ipify.org", { dispatcher });
console.log(await res.text());

我如何构建用户名？

从控制面板中的用户名开始，依上面格式顺序用连字符附加参数。每个参数都是可选的。值为小写，城市名称用下划线表示（new_york，sao_paulo）。城市可用性不同。

轮换会话和粘性会话的行为如何？

不带 session- 的用户名在每次新建 TCP 连接时从代理池获取一个 IP，通常不同；带 session-<id>-ttl-<minutes> 的用户名则保持该 ID 的出口 IP 不变，直到 TTL 结束或住宅设备离线。

• 轮换按连接发生，不按请求；保持连接复用同一出口 IP。
• 每个任务、浏览器上下文或账户流程使用一个新的会话 ID。
• 发送相同会话 ID 的两个爬虫共用一个出口 IP。

会话指南]详述各库中的连接复用。

限制有哪些？

• 阻止的目标地址： 禁止用于银行、政府和支付门户网站，以及 SMTP 发信端口 25、465 和 587。相关请求会被拒绝。
• 用途： 仅限公开数据，遵守可接受使用政策。禁止账户劫持、欺诈、垃圾邮件及绕过网站封锁。
• 流量： 按GB计费。流量使用统计包括通过代理传输的所有数据（上传和下载，含头部）。1 GB = 1,000,000,000 字节。连接尝试未能到达目标的请求不计入流量。流量用完时请求将停止。
• 会话： 最长支持 30 分钟持续时长；IP可能提前更换，例如对应住宅设备离线时。
• 协议： 支持 HTTP、HTTPS (CONNECT) 和 SOCKS5 代理。
• 并发： 不计费。限制取决于每个目标的接受度；详见并发指南。

我如何管理凭据和使用情况？

在控制面板或通过REST API（地址为https://crawlrelay.com/api/v1）使用API密钥管理。支持随时撤销的 API 密钥。主要功能：

• 子用户： 每个爬虫或客户端项目一组凭据，可选流量上限。详情见住宅API。
• IP白名单： 最多允许10个IP无需密码即可连接。
• 使用量： 按每日订阅流量提醒，防爬取流量耗尽。
• 目录： 可定位的国家、城市、州和ASN，方便代码在使用用户名前校验。
• 订单： 可直接用余额购买更多流量，无需入控制面板。详见订单API。