配置参数

Rola IP 通过代理用户名中的参数控制出口地区、会话及 IP 轮换方式。以下为包含地区和会话参数的动态住宅 IP 用户名示例：

test_1-country-us-state-ny-city-newyork-sessiontime-10

各组成部分的含义如下：

用户名片段	参数	含义
test	账号名	实际代理IP账号名（基础部分，必填）
_1	sessionid	会话标识，写在账号名下划线后面，用来区分独立会话和独立 IP
-country-us	country	指定出口国家，这里是美国
-state-ny	state	指定州 / 省，取值为州代码（ny，仅动态住宅 IP）
-city-newyork	city	指定城市，取值为城市名称（newyork，仅动态住宅 IP）
-sessiontime-10	sessiontime	会话保持时长，这里是 10 分钟

可省略不需要的参数及其取值。配置时请注意以下规则：

• sessionid 不是写成 -sessionid-xxx 参数，而是账号名下划线后面的值。test_1 的 sessionid 就是 1，最长支持 32 个字符；不同 sessionid 表示独立会话，系统会尽量分配独立出口 IP。
• state 和 city 目前仅 动态住宅 IP 支持；动态机房 IP和移动手机 IP 只支持 country 国家级定位，不支持州或城市级定位。
• sessiontime 的单位是分钟，支持 1～120 分钟。
• 如果希望每次请求使用新的 IP，用 -f-1 代替会话参数（与固定会话相反，适合无状态任务），例如 test-country-us-f-1。

参数说明

参数	是否必填	说明	示例
country	否	指定国家或地区。通常使用国家代码。	country-us
state	否	指定州、省或一级行政区，取值为州代码（如 ny）。仅动态住宅 IP支持，需要配合 country 使用。	state-ny
city	否	指定城市，取值为城市名称（如 newyork）。仅动态住宅 IP支持，需要配合 country、state 使用。	city-newyork
sessionid	否	写在账号名下划线后面，用来区分独立会话和独立 IP。最长支持 32 个字符。	test_1 中的 1
sessiontime	否	指定会话保持时长，单位为分钟，支持 1～120 分钟。	sessiontime-10
f-1	否	按请求轮换 IP，适合不需要保持登录态的任务。	test-country-us-f-1

用户名格式

不同网络的账号名带有不同标记，写在 sessionid 前面：

网络	账号名标记	基础写法	带会话写法
动态住宅 IP	无	test	test_1
动态机房 IP	_dc	test_dc	test_dc_1
移动手机 IP	_mobile	test_mobile	test_mobile_1

通用格式如下，以动态住宅 IP 为例。机房和移动网络需使用带相应标记的账号名：

test_sessionid-country-国家代码-sessiontime-分钟

不需要的参数可以省略。三种网络都可以使用以下写法（注意替换账号名标记）：

test_1-country-us                    # 动态住宅IP
test_dc_1-country-us-sessiontime-10  # 动态机房IP
test_mobile-country-us-f-1           # 移动手机IP

动态住宅 IP还可以追加 state 和 city，格式如下：

test_sessionid-country-国家代码-state-州代码-city-城市名称-sessiontime-分钟

test_1-country-us-state-ny
test_1-country-us-state-ny-city-newyork
test_1-country-us-state-ny-city-newyork-sessiontime-15

sessionid 规则

sessionid 是账号名下划线后面的值，不是 -sessionid-xxx 参数：

test_1
test_2
test_login001

说明：

• test_1 的 sessionid 是 1。
• test_2 的 sessionid 是 2。
• test_login001 的 sessionid 是 login001。
• sessionid 最长支持 32 个字符。
• 不同 sessionid 表示独立会话，系统会尽量分配独立出口 IP。

配置页面中的“账号名后缀”对应 sessionid；机房和移动网络的会话标识位于网络标记之后：

如果某个流程需要在会话时间内保持同一个 IP，使用同一个账号名和 sessiontime：

test_1-country-us-sessiontime-10

如果要同时使用多个独立 IP，为每个任务设置不同的 sessionid：

test_2-country-us-sessiontime-10

按请求轮换 IP

如果任务不需要保持会话，希望每次请求都使用新的出口，可以在账号参数中追加 -f-1：

test-country-us-f-1

如果同时需要指定 sessionid，也可以写成：

test_1-country-us-f-1

-f-1 的含义是让每次请求使用新的 IP，适合采集、批量访问、可用性检测等无状态任务。如需登录、注册、下单、提交表单等连续流程，优先使用固定 sessionid 和 sessiontime，不建议使用 -f-1。

地区参数

动态住宅 IP、动态机房 IP、移动手机 IP 都支持 country 国家级定位。其中只有动态住宅 IP还支持 state（州）和 city（城市），动态机房 IP和移动手机 IP 目前只能定位到国家，不支持州或城市级定位。

动态住宅 IP的地区参数从大到小依次为：

country -> state -> city

建议按以下顺序使用：

1. 先只指定 country，确认可以正常连接。
2. 如果使用动态住宅 IP，且业务需要更精确的定位，再追加 state。
3. 如需城市级定位，再追加 city。

WARNING

state 和 city 仅适用于动态住宅 IP。动态机房 IP和移动手机 IP 目前只支持 country，不要追加州或城市参数。

会话时间

sessiontime 用来指定会话保持时长，单位为分钟，支持 1～120 分钟。

test_1-country-us-sessiontime-10

上面的示例表示：

• sessionid 为 1；
• 指定美国出口；
• 会话保持时间为 10 分钟，支持范围为 1～120 分钟；
• 在会话时间内，test_1 会尽量保持同一个 IP。

推荐配置

适用网络	场景	推荐用户名参数
全部	只需要指定国家	test-country-us
动态住宅 IP	需要州级定位	test-country-us-state-ny
动态住宅 IP	需要城市级定位	test-country-us-state-ny-city-newyork
全部	登录或注册流程	test_1-country-us-sessiontime-10
全部	下单、表单提交等连续流程	test_1-country-us-sessiontime-15
全部	并行执行多个独立任务	test_1-country-us-sessiontime-10、test_2-country-us-sessiontime-10
全部	按请求轮换 IP	test-country-us-f-1

上表用户名以动态住宅 IP为例；动态机房 IP、移动手机 IP 请将账号名替换为带 _dc / _mobile 标记的形式，例如 test_dc-country-us、test_mobile_1-country-us-sessiontime-10。

TIP

首次配置建议仅设置 country 并验证连接。需要同一流程保持同一个 IP 时，再使用固定 sessionid 和 sessiontime；需要多个独立出口时，使用不同 sessionid；需要每次请求使用新的 IP 时，追加 -f-1。