动态住宅怎么开粘性会话:sessionId 和时长怎么设

在动态住宅提取时传入 sessionId 和 1 到 60 分钟的 sessionMinutes,可在窗口内尽量保持同一出口。粘性不是静态 IP。不支持中国大陆。

在动态住宅提取时传入 sessionId 和 1 到 60 分钟的 sessionMinutes,可在窗口内尽量保持同一出口。粘性不是静态 IP。不支持中国大陆。

需要在一段时间内尽量使用同一出口时,在提取凭据时同时传入 `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。

价格以哪里为准?

以控制台与价格方案为准。

下一步

  1. 按任务决定轮换、粘性还是静态。
  2. 用提取接口领取完整凭据并测通。
  3. 需要报固定地址时改看静态与白名单。