购买动态住宅流量后，用官方文档中的提取接口领取完整主机、端口、用户名和密码，不要自己拼接用户名。本页按动态资源2说明。不支持中国大陆。
先完成动态住宅流量购买，再领取一组完整的主机、端口、用户名和密码。本页按官方文档「动态资源2接入指南」和「动态流量与提取」说明操作顺序：保存购买响应里的账户 ID，调用提取接口，用返回字段接入客户端。不要自己拼接或改写用户名。程序化总览见API 对接；字符串格式见代理格式。
ZTProxy 还提供静态住宅（按 IP·月）。静态实例的主机和认证在订单开通完成后从订单列表读取，流程不同，不要把本页的提取步骤套到静态订单上。示例是假占位符，不要当成生产地址。仅限授权目标。不支持中国大陆使用。
开始前备齐什么
| 准备项 | 从哪里来 |
|---|---|
| 已购买的动态流量与账户 ID | 控制台或购买响应中的 `accountId`；文档里公开产品号为 `dynamic_2`，界面名称以控制台为准 |
| 登录令牌 | 仅服务端保存；见认证与快速开始 |
| 测通目标 | 你有权访问的 HTTPS 地址 |
| 选型判断 | 若任务需要订购期内固定出口，改看静态和动态 vs 静态 |
占位符（非生产）：主机 `proxy.example.invalid`，端口 `10000`，用户 `USER_EXAMPLE`，密码 `PASS_EXAMPLE_NOT_REAL`。Token 示例 `TOKEN_EXAMPLE_NOT_REAL`，账户 ID 示例 `ACCOUNT_ID_EXAMPLE`。命令以文档为准。
提取时拿什么
提取成功时，接口会返回结构化的 `host`、`port`、`username`、`password`。批量提取时，以 `data.proxy.list` 为准；此时结构化字段和 `formatted_proxy` 只代表列表中的第一条。`formatted_proxy` 的顺序是 `host:port:username:password`，适合单行导入，但写入页面或日志时仍应把凭据与主机关分开，避免出现字面的 `用户名:密码@主机`。
| 字段 | 怎么用 |
|---|---|
| `host` / `port` | 原样填进客户端；不要手写拼入口域名 |
| `username` / `password` | 分字段使用；不要自行拼接或修改用户名 |
| `protocol` | 文档默认 `socks5`。用 SOCKS5 访问 HTTPS 目标，并不代表这条提取路径已经提供 HTTP 代理或 HTTPS CONNECT。若控制台或其他路径返回 HTTP 代理，按返回值填写，见HTTP / SOCKS5 |
| 入口域名 | 文档当前实现：美国地区使用 `host5.ztproxy.net`，亚洲、欧洲及其他非美国地区或全球随机使用 `host4.ztproxy.net`。始终以当次提取响应的 host 为准 |
普通用户只能提取自己的账户；代理商只能提取有权管理的账户。不要把订单号当成账户 ID。
一次提取示例
把账户 ID 和令牌换成你自己的值。下面只演示「全球随机、默认 SOCKS5」的请求体，地区和粘性会话见指定地区与粘性会话。
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"
}'测通时把返回的主机、端口与认证分成参数填写，例如 curl 使用 `--proxy` 与 `--proxy-user`，不要写成 `用户名:密码@主机`。命令行测通步骤见curl 测通；若文档示例使用 `socks5h://` 主机和端口，协议须与提取结果一致。
控制台若提供同等提取能力，菜单名称以实际界面为准，仍应领取完整凭据，不要手改用户名。
常见问题怎么排查
| 现象 | 先检查什么 |
|---|---|
| 401 | 令牌是否过期；是否漏了 `Authorization` 请求头。见认证 |
| 403 | 是否在提取不属于自己的账户；代理商是否越权 |
| 404 | 是否把订单号当成了 `accountId`；先查账户列表 |
| 400 | 流量是否已用尽；地区或会话参数是否合法。见查剩余流量 |
| 503 | 入口或用量暂时不可用；不要无限重试，记录时间与订单号后再查 |
| 407 或仍显示本机 IP | 是否使用了提取返回的完整字段；协议是否与返回值一致。见407 排查 |
令牌和代理密码只放在服务端或密钥系统，不要写进前端、公开仓库或日志。
合规与范围
只用于授权目标。不要把本页写成绕过限制的教程。价格以控制台与价格方案为准（动态约 $0.40/GB，100 TB 整包约 $0.20/GB；静态共享约 $1.50、独享约 $5 /IP/月）。USDT/USDC 可用；Visa/Mastercard 申请中。不支持中国大陆使用。
FAQ
为什么不能自己拼用户名？
官方文档要求每次通过提取接口获取完整凭据，客户端不应自行拼接或修改代理用户名。自己加国家或会话后缀容易得到无效认证。
示例主机和账户 ID 能直接用吗？
不能。必须改成控制台或接口返回的真实值。本文占位符不是生产地址。
提取默认是 HTTP 还是 SOCKS5？
文档中该提取路径默认 `socks5`。用 SOCKS5 去访问 HTTPS 目标，不等于 HTTP 代理或 HTTPS CONNECT 已在该路径可用。以当次返回的协议为准，一般说明见HTTP / SOCKS5。
动态提取和静态订单有什么不同？
动态按流量使用，凭据通过提取获得；静态是订购期内相对固定的住宅 IP，开通后从订单列表读取实例。不要把提取步骤套到静态订单。
一次可以提取多少条？
文档写明 `quantity` 范围是 1 至 200，默认 1。批量结果读 `data.proxy.list`。这不是产品并发上限或 SLA。
可以用来突破登录限制吗？
不可以。仅限合法授权目标。
入口一定是 host4 或 host5 吗？
文档描述的是当前实现，美国地区与其他地区入口可能不同。始终以当次提取响应中的 `host` 为准，不要手写拼域名。
价格以哪里为准？
以控制台与价格方案为准。