代码集成概览

接入须知

程序可通过用户后台生成的连接信息接入代理IP。接入前请准备以下信息：

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

如果开启了 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 最长支持 32 个字符。不同标识对应独立会话，系统会尽量分配独立出口 IP。
• 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 验证代理IP是否可用。

SOCKS5 代理：

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

HTTP 代理：

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

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

代码集成示例

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

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