配置参数
Rola IP 通过用户名（账号名）携带参数的方式来控制代理出口——国家、州、城市、会话等所有控制项都写在用户名里。下面是一条包含全部明细参数的完整用户名：
test_1-country-us-state-ny-city-newyork-sessiontime-10把它逐段拆开，每一段对应一个控制项：
| 用户名片段 | 参数 | 含义 |
|---|---|---|
test | 账号名 | 你的代理账号名（基础部分，必填） |
_1 | sessionid | 会话标识，写在账号名下划线后面，用来区分独立会话和独立 IP |
-country-us | country | 指定出口国家，这里是美国 |
-state-ny | state | 指定州 / 省，取值为州代码（ny，仅动态住宅） |
-city-newyork | city | 指定城市，取值为城市名称（newyork，仅动态住宅） |
-sessiontime-10 | sessiontime | 会话保持时长，这里是 10 分钟 |
不需要的参数可以整段省略。几个要点：
sessionid不是写成-sessionid-xxx参数，而是账号名下划线后面的值。test_1的sessionid就是1，最长支持 32 位字符；每个不同的sessionid都是独立会话，对应不同 IP。state和city目前仅 动态住宅 支持；动态机房和移动 IP 只支持country国家级定位，不支持州或城市级定位。sessiontime的单位是分钟，支持 1～120 分钟。- 如果希望每次请求都切换 IP，用
-f-1代替会话参数（与固定会话相反，适合无状态任务），例如test-country-us-f-1。
参数说明
| 参数 | 是否必填 | 说明 | 示例 |
|---|---|---|---|
country | 否 | 指定国家或地区。通常使用国家代码。 | country-us |
state | 否 | 指定州、省或一级行政区，取值为州代码（如 ny）。仅动态住宅支持，需要配合 country 使用。 | state-ny |
city | 否 | 指定城市，取值为城市名称（如 newyork）。仅动态住宅支持，需要配合 country、state 使用。 | city-newyork |
sessionid | 否 | 写在账号名下划线后面，用来区分独立会话和独立 IP。最长支持 32 位字符。 | test_1 中的 1 |
sessiontime | 否 | 指定会话保持时长，单位为分钟，支持 1～120 分钟。 | sessiontime-10 |
f-1 | 否 | 每次请求都切换 IP，适合不需要保持登录态的任务。 | test-country-us-f-1 |
用户名格式
动态住宅、动态机房、移动 IP 这三种网络都适用的通用格式：
test_sessionid-country-国家代码-sessiontime-分钟不需要的参数可以省略。这三种网络都可以使用以下写法：
test_1-country-us
test_1-country-us-sessiontime-10
test-country-us-f-1动态住宅还可以追加 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-15sessionid 规则
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。
如果某个流程需要在会话时间内保持同一个 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 都支持 country 国家级定位。其中只有动态住宅还支持 state（州）和 city（城市），动态机房和移动 IP 目前只能定位到国家，不支持州或城市级定位。
动态住宅的地区参数从大到小依次为：
country -> state -> city建议按以下顺序使用：
- 先只指定
country，确认可以正常连接。 - 如果使用动态住宅，且业务必须更精确，再追加
state。 - 只有在动态住宅确实需要城市级定位时，才追加
city。
WARNING
state 和 city 仅适用于动态住宅。动态机房和移动 IP 目前只支持 country，不要追加州或城市参数。
会话时间
sessiontime 用来指定会话保持时长，单位为分钟，支持 1～120 分钟。
test_1-country-us-sessiontime-10上面的示例表示：
sessionid为1；- 指定美国出口；
- 会话保持时间为 10 分钟，支持范围为 1～120 分钟；
- 在会话时间内，
test_1会尽量保持同一个 IP。
推荐配置
| 适用网络 | 场景 | 推荐用户名参数 |
|---|---|---|
| 全部 | 只需要指定国家 | test-country-us |
| 动态住宅 | 需要州级定位 | test-country-us-state-ny |
| 动态住宅 | 需要城市级定位 | 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 |
TIP
如果不确定如何配置，优先使用 country。需要同一流程保持同一个 IP 时，再使用固定 sessionid 和 sessiontime；需要多个独立出口时，使用不同 sessionid；需要每次请求都换 IP 时，追加 -f-1。