代码集成概览

📋 接入须知

代码集成使用后台生成的代理连接信息接入。接入前先确认已经拿到：

• 主机
• 端口
• 用户名
• 密码

如果开启了 IP 白名单，请先把运行代码的服务器或本机外网 IP 加入白名单，否则代理连接会被拒绝。

用户名参数

代码里填写的用户名可以直接使用基础账号名，也可以按业务需要追加地区、会话和切换参数。

test
test-country-us
test_1-country-us-sessiontime-10
test-country-us-f-1

常用规则：

• country 用来指定国家级出口，例如 test-country-us。
• sessionid 写在账号名下划线后面，例如 test_1 中的 1，不是 -sessionid-xxx 参数。
• 不同 sessionid 是独立会话，对应不同 IP，最长支持 32 位字符。
• sessiontime 用来设置会话保持时间，单位为分钟，支持 1～120 分钟。
• -f-1 用来让每次请求都切换 IP，适合采集、批量访问等无状态任务。

WARNING

动态住宅IP支持 country、state、city。动态机房IP和移动手机IP 目前只支持 country，不支持州或城市级定位。

另外，动态机房IP、移动手机IP 的账号名需要分别带 _dc、_mobile 标记（写在 sessionid 前面），例如 test_dc-country-us、test_mobile_1-country-us-sessiontime-10；动态住宅IP无需标记。上面示例以动态住宅IP为例。

会话与切换策略

场景	推荐用户名
默认动态出口	test
指定美国出口	test-country-us
同一流程保持 10 分钟	test_1-country-us-sessiontime-10
同时跑两个独立出口	test_1-country-us-sessiontime-10、test_2-country-us-sessiontime-10
每次请求切换 IP	test-country-us-f-1

登录、注册、下单、表单提交等连续流程，建议使用固定 sessionid 和 sessiontime。采集、批量访问、接口检测等不需要保持登录态的任务，可以使用 -f-1。

请求验证

在写入业务代码前，可以先用 curl 验证代理是否可用。

SOCKS5 代理：

curl -x socks5h://用户名:密码@代理域名:端口 http://ip123.in/ip.json

HTTP 代理：

curl -x http://用户名:密码@代理域名:端口 http://ip123.in/ip.json

如果能返回出口 IP、国家、地区等 JSON 信息，说明代理连接已经生效。

🔌 代码集成示例

选择您使用的编程语言查看详细示例：

• Python - Python 代理接入示例
• Go - Go 代理接入示例
• Java - Java 代理接入示例
• PHP - PHP 代理接入示例