国内隧道账密认证
更新时间: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 资源 |