Docs
登录

Proxy API

提供粘性会话和单一端口扁平接入的住宅代理网络。当 Smart Proxy 不够灵活时使用——直接访问 IP 池，由您自行控制轮换。

迁移到 Smart AI Proxy

更快的路由、AI 驱动的封禁规避、更少的配置项。Proxy Backconnect 已弃用，但现有集成仍可继续使用——没有计划关停。

Endpoint

PROXYbackconnect.crawlbase.com:9000
# Username = your token + optional session/country qualifiers
# Password = blank

基本用法

curl -x 'http://YOUR_TOKEN:@backconnect.crawlbase.com:9000' \
     'https://httpbin.org/ip'
import requests

proxies = {
    'http':  'http://YOUR_TOKEN:@backconnect.crawlbase.com:9000',
    'https': 'http://YOUR_TOKEN:@backconnect.crawlbase.com:9000',
}
res = requests.get('https://httpbin.org/ip', proxies=proxies)

默认情况下，每个请求都会通过不同的住宅 IP——纯轮换模式。

粘性会话

若要将请求固定到同一个 IP，请在用户名后追加一个会话 ID。相同的会话 ID 在约 30 分钟内会返回同一个 IP。

# Format: TOKEN-session-SESSION_ID
curl -x 'http://YOUR_TOKEN-session-checkout42:@backconnect.crawlbase.com:9000' \
     'https://shop.example.com/cart'

国家定向

# Format: TOKEN-country-XX
curl -x 'http://YOUR_TOKEN-country-DE:@backconnect.crawlbase.com:9000' \
     'https://www.amazon.de'

# Combine: country + session
curl -x 'http://YOUR_TOKEN-country-DE-session-cart-1:@backconnect.crawlbase.com:9000' \
     'https://www.amazon.de/cart'

用户名修饰符

所有可用用户名修饰符的参考，使用连字符组合。

格式效果
TOKEN默认——每次请求随机 IP
TOKEN-country-XX来自国家 XX 的 IP（ISO 3166）
TOKEN-session-NAME粘性绑定到一个 IP，约 30 分钟
TOKEN-country-XX-session-NAME在指定国家内的粘性会话

静态 IP 与地理定位

当您需要在多个请求之间保持相同的出口 IP 时——多步骤结账流程、账号登录 + 抓取，或任何依赖目标站点识别同一客户端的场景——Backconnect 可以锁定一个静态 IP，并返回端口 + 会话生命周期。只要您在会话窗口内持续使用，代理就会将该 IP 绑定到您的 token。

静态 IP 端点的速率限制为 每个国家每 5 分钟 1 次请求（如果未指定国家，则总体每 5 分钟 1 次）。请缓存客户端收到的端口——不要在每次抓取时重新请求。

套餐限定功能

静态 IP 和国家定向并非在所有 Backconnect 套餐中均可用，且国家可用性因套餐等级而异。如果收到未授权响应，请在重试前检查您的套餐或联系支持团队。

获取静态 IP

返回一个用于 proxy.crawlbase.com 的端口，以及绑定保持有效的秒数。只要您在窗口期内继续通过该端口发送流量，会话计时器就会自动延长。

GEThttps://api.crawlbase.com/proxy/static
curl 'https://api.crawlbase.com/proxy/static?token=YOUR_TOKEN'

# Response
# { "port": 1234, "host": "proxy.crawlbase.com", "session_time": 10 }

来自指定国家的静态 IP

传入 2 字母的 ISO 3166 国家代码（US、GB、DE、IT、RU……）以将静态 IP 固定到该地理位置。如果当前所请求国家中没有空闲端口，响应将返回错误——请按国家分桶的速率限制退避后重试。

curl 'https://api.crawlbase.com/proxy/static?token=YOUR_TOKEN&country=FR'

# Response
# { "port": 4551, "host": "proxy.crawlbase.com", "session_time": 10 }

IP 白名单

Backconnect 支持 IP 白名单——让您服务器的出站 IP 无需在每次请求时发送 token 即可对代理进行身份验证。适用于不希望在代码中保存凭据的固定 IP 管道，也是在无法传递 Proxy-Authorization header 的环境下使用 Backconnect 的唯一方式。

三个端点，均位于 /proxy/whitelist_ips 之下，通过 HTTP 方法加以区分。变更 最多需要 1 分钟 才能生效。

套餐限定功能

白名单管理并非在所有套餐中均可用，且每个套餐对可同时加入白名单的 IP 数量有上限。未授权响应表示您的套餐不包含此功能；请联系支持团队进行升级。

添加白名单 IP

POSThttps://api.crawlbase.com/proxy/whitelist_ips
curl -X POST 'https://api.crawlbase.com/proxy/whitelist_ips?token=YOUR_TOKEN&ip=123.123.123.123'

移除白名单 IP

DELETEhttps://api.crawlbase.com/proxy/whitelist_ips
curl -X DELETE 'https://api.crawlbase.com/proxy/whitelist_ips?token=YOUR_TOKEN&ip=123.123.123.123'

查看白名单 IP

返回您 token 当前的白名单 IP 列表，格式为 JSON。

curl 'https://api.crawlbase.com/proxy/whitelist_ips?token=YOUR_TOKEN'

Backconnect vs Smart Proxy

Smart ProxyBackconnect
使用场景简易模式——自动路由、反爬绕过直接访问 IP 池，自定义轮换
JS 渲染可用不支持（原始代理）
自动重试支持不支持——需自行处理
粘性会话通过 header通过用户名
最适合大多数用户自定义爬虫、网络研究
优先选择 Smart Proxy

Backconnect 是更底层的工具。如果您没有特定的使用理由，Smart Proxy 能以更少的工作量获得更好的结果。