海外动态账密认证文档

更新时间：2026-07-02

账密认证是代理 IP 服务中常用的身份验证方式，通过用户名和密码组合实现快速接入。本文档详细介绍账密认证的参数规则、使用示例及注意事项，帮助您正确配置和使用代理服务。

一、请求参数

账密认证支持多种参数配置，可根据业务需求灵活指定 IP 属性：

参数键	字段名	类型	必填	说明
acc	账号	string	是	代理账号用户名
cty	国家	string	否	目标 IP 的国家代码，如 US、CN。支持多国家（逗号分隔，如 US,UK），系统将随机选取其中一个
reg	省份/地区	string	否	目标 IP 的省份或地区代码。多国家模式下此参数无效
city	城市	string	否	目标 IP 的城市代码。多国家模式下此参数无效
cnt	大洲	string	否	目标 IP 的大洲代码，如 NA（北美）、EU（欧洲）。多国家模式下此参数无效
sid	会话 ID	string	否	粘性会话标识。相同 sid 在会话有效期内始终返回同一个 IP
ttl	会话时效	int	否	IP 使用时长（单位：分钟）。若套餐配置了固定时长，则取两者的较小值
rep	去重方式	int	否	IP 去重策略：1 = 去重提取（默认套餐策略），2 = 允许重复提取
ipv	IP 协议版本	string	否	指定 IP 协议版本：4 = IPv4（默认），6 = IPv6

指定大洲

//提取欧洲大洲的 IP
acc-myaccount-cnt-EU

指定国家

//提取美国 IP
acc-myaccount-cty-US

指定国家 + 省份 + 城市

//提取美国加州洛杉矶的 IP
acc-myaccount-cty-US-reg-CA-city-losangeles

基础用法（仅指定账号）

//账密
acc-myaccount

多国家随机提取

//从美国、英国、德国中随机选取一个国家提取 IP
acc-myaccount-cty-US,UK,DE

粘性会话

//使用会话 ID `mysession001`，会话有效期内每次请求返回同一个 IP
acc-myaccount-cty-US-sid-mysession001

粘性会话 + 指定时效

//会话有效时长 10 分钟，10 分钟内保持同一个 IP
acc-myaccount-cty-US-sid-mysession001-ttl-10

指定 IPv6

//提取美国的 IPv6 地址
acc-myaccount-cty-US-ipv-6

允许 IP 重复提取

//不进行去重，允许重复提取相同 IP
acc-myaccount-rep-2

综合示例

//账号 `myaccount`，提取美国纽约的 IPv4 地址，使用粘性会话 `session888`，时效 5 分钟，去重提取
acc-myaccount-cty-US-reg-NY-sid-session888-ttl-5-ipv-4-rep-1

错误场景	说明
用户名格式非法	用户名以 - 开头/结尾、键值对数量为奇数、含未知参数键、参数值为空或重复
不支持白名单模式	隧道认证不支持白名单认证方式
请求频率超限	超过套餐 QPS 限制（轮转模式）
通道数超限	超过套餐允许的最大粘性会话通道数
IP 提取失败	当前条件下无可用 IP 资源

📋 重要说明

sid（粘性会话）与轮转模式互斥：设置 sid 后进入粘性会话模式，相同 sid 在有效期内返回同一个 IP；不设置 sid 则每次请求轮转提取新 IP。

多国家模式：cty 填写逗号分隔的多个国家代码时，reg、city、cnt 参数自动失效，系统随机选取一个国家。

时效优先级：若套餐配置了 IP 存活时间（IpAliveTime），则实际生效时长为 min(套餐配置时长，ttl 参数时长)。

IP 协议版本：默认使用 IPv4，如需 IPv6 请显式指定 ipv-6，需套餐支持。

去重策略：rep 参数优先级高于套餐默认去重配置，设置 rep-2 可强制允许重复 IP。