需要在一段时间内尽量使用同一出口时,在提取凭据时同时传入 sessionId 和 sessionMinutes。本页按官方动态资源2接入指南说明这些字段怎么写。它解决的是「怎么开粘性」,不是再解释一遍「粘性和静态有何不同」——概念对照见粘性会话 vs 静态 IP。
默认不指定会话时,请求可以获得轮换 IP。粘性会话在时长内会尽量保持同一出口,不保证出口绝不变化。需要订购期内固定住宅 IP 时,请使用静态。仅限授权目标。不支持中国大陆使用。
开始前备齐什么
| 准备项 | 从哪里来 |
|---|---|
| 动态账户 ID 与令牌 | 购买响应中的 accountId;令牌放服务端 |
| 是否真的需要粘性 | 只要轮换出口就不要复用会话;要长期固定出口请改用静态 |
| 会话标识规则 | 文档:sessionId 仅字母和数字,最多保留 6 个字符 |
| 时长规则 | 文档:sessionMinutes 支持 1 至 60 分钟 |
占位符(非生产):主机 proxy.example.invalid,端口 10000,用户 USER_EXAMPLE,密码 PASS_EXAMPLE_NOT_REAL。账户 ID 示例 ACCOUNT_ID_EXAMPLE。下文 cart01 取自官方文档示例,不是产品分配的固定会话名。
字段含义
| 字段 | 文档口径 | 使用注意 |
|---|---|---|
| 不传会话 | 可获得轮换 IP | 不要把「碰巧同一出口」当成粘性已开启 |
sessionId | 字母和数字,最多 6 个字符;平台会把它与当前标准地区层级绑定,生成实际使用的 6 位会话标识 | 不要自造更长的 ID,也不要写进用户名 |
sessionMinutes | 1 至 60 分钟 | 不要把未核实的更长窗口写成产品能力 |
| 切换国家、州/省或城市 | 应同时生成新的会话标识 | 只改地区、沿用旧 ID,可能继续使用原地区出口 |
| 批量提取 | 默认每条凭据使用独立的 5 分钟会话;若同时传入会话字段,平台会为每条派生独立标识,并使用指定时长 | 这不是并发上限或 SLA |
需要彼此隔离的任务,应使用不同的 sessionId。客户端仍须使用提取返回的完整用户名和密码,不要自己把会话写进用户名。
开启粘性的提取示例
export ZTPROXY_BASE="https://backend.ztproxy.net/api"
export ZTPROXY_TOKEN="TOKEN_EXAMPLE_NOT_REAL"
curl -X POST "$ZTPROXY_BASE/business/dynamic-accounts/ACCOUNT_ID_EXAMPLE/extract" \
-H "Authorization: Bearer $ZTPROXY_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"protocol": "socks5",
"country": "US",
"sessionId": "cart01",
"sessionMinutes": 10
}'
country 不是粘性所必需;需要定点时先查地区目录,见指定地区。协议默认仍是文档中的 socks5。测通时把主机、端口、认证分参数填写,见curl 测通。
粘性和静态不要混用
| 需求 | 更合适的产品或做法 |
|---|---|
| 每次换出口,做公开页抽样 | 动态,不要传会话字段 |
| 十几到六十分钟内尽量同一出口 | 动态 + 文档中的粘性字段 |
| 订购期内相对固定的住宅 IP,例如给合作方报地址 | 静态;白名单场景见静态 IP 白名单 |
粘性不是静态,也不是 SLA。窗口结束后,或出口发生变化时,应按业务需要重新提取,而不是假定同一组凭据永远指向同一 IP。
合规与范围
只用于授权目标。不要把本页写成绕过限制的教程。价格以控制台与价格方案为准(动态约 $0.40/GB,100 TB 整包约 $0.20/GB;静态共享约 $1.50、独享约 $5 /IP/月)。USDT/USDC 可用;Visa/Mastercard 申请中。不支持中国大陆使用。
FAQ
粘性会话能代替静态 IP 吗?
不能。粘性只在 1 至 60 分钟的窗口内尽量保持同一出口;静态是订购期内相对固定的住宅 IP。见粘性 vs 静态。
sessionId 可以超过 6 个字符吗?
按文档不要这样用。只需字母和数字,最多保留 6 个字符;平台会生成实际使用的 6 位标识。
最长能开多久?
文档支持的 sessionMinutes 是 1 至 60。不要把更长的窗口写成已核实能力。
同一会话是否保证 IP 绝不变化?
不保证。文档写明在时长内会尽量保持同一出口,但出口仍可能变化。
换国家时可以沿用同一个 sessionId 吗?
不建议。文档提示:切换国家、州/省或城市时应生成新的会话标识,否则可能继续使用原地区出口。
可以用来突破登录限制吗?
不可以。仅限合法授权目标。
批量提取的 5 分钟是产品套餐吗?
不是。那是文档对批量提取默认会话的说明,不是计费套餐,也不是并发 SLA。计费见按 GB 还是按 IP。
价格以哪里为准?
以控制台与价格方案为准。