国内隧道账密认证

更新时间:2026-07-02

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

一、请求参数

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

参数键 字段名 类型 必填 说明
acc 账号 string 代理账号用户名
cty 国家 string 目标 IP 的国家代码,如 US、CN。支持多国家(逗号分隔,如 US,UK),系统将随机选取其中一个
reg 省份/地区 string 目标 IP 的省份或地区代码。多国家模式下此参数无效
sid 会话 ID string 粘性会话标识。相同 sid 在会话有效期内始终返回同一个 IP

二、使用示例

2.1指定地区

//提取江苏的 IP
acc-myaccount-cty-cn-reg-32

2.2 基础用法(仅指定账号)

//账密
acc-myaccount

三、错误码说明

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