05-参数详解与生成格式
分类:代理提取 | 更新日期:2026-09-14
看懂每一个参数,才能把代理稳定地配到业务里。本页是所有参数与写法的集中索引。
本页目录
- 用户名(username)参数一览
- 拼接规则与完整示例
- IP 时效:三种模式怎么选
- 地区写法与代码速查
- 场景化参数组合推荐
- 六种高频写法错误
用户名(username)参数一览
账密认证的“魔法”都在用户名里:它由若干 键-值 段用下划线拼接而成,用来告诉网关「要哪个地区、保持多久、是否复用同一 IP」。密码始终是子账号密码,不需要拼接。
| 名称 | 描述 |
|---|---|
username | 用户名(子账号名 + 下列参数段) |
password | 密码(子账号密码,无需拼接参数) |
session | 在 IP 时效内,相同 session 会优先复用同一 IP;不填写时,每次请求优先分配不同 IP。最多 12 位字符 |
life | 保持 IP 使用时间,最大为 120 分钟 |
area | 全球地区 code,例如美国 area-US(国家代码) |
city | 所属城市,例如纽约 city-newyork(城市代码) |
state | 州 / 省,例如纽约州 state-Newyork(州代码) |
asn | 运营商 ASN,例如 asn-12345 |
示例主机不是固定值 us.duckip.net:1000(动态住宅代理)与 as.duckip.net:2000(静态住宅代理)只是文档示例,不同地区与产品线的主机前缀可能不同;实际以控制台「复制」到的主机与端口为准,不要照抄示例。
拼接顺序不必死记 先在控制台把参数选好,直接复制生成结果即可。手工拼写只用于程序化动态切换区域(例如同一账号轮询多国)。
拼接规则与完整示例
# 结构:子账号 + 各参数段(下划线分隔)
子账号_area-US_state-ALASKA_city-ANCHORAGE_life-5_session-7BhsSJv2788rr
# 生成到目标端后的完整形态
Proxy Server: us.duckip.net
Port: 1000
Username: 子账号_area-US_state-ALASKA_city-ANCHORAGE_life-5_session-7BhsSJv2788rr
Password: 子账号密码段之间用下划线 _|键与值之间用连字符 -|未填写的参数可整段省略|地区代码建议复制而非手写
关于大小写与拼写 州 / 城市代码请尽量从控制台下拉框选择后复制,不要凭记忆手写。地区代码写错通常不会报错,而是表现为“IP 落到意外国家”或回落到随机分配。
IP 时效:三种模式怎么选
| 模式 | 控制台选项 | 参数表现 | 适用场景 |
|---|---|---|---|
| 每次请求更换 | 每次请求更换 | 不写 session、不写 life | 公开数据采集、批量比价等不需要身份延续的任务。 |
| 指定时效(粘性) | 指定时效 + IP 持续时长 | 写 life-5(1—120 分钟) | 需要一段时间内稳定出口的任务,例如登录、下单流程。 |
| 会话级复用 | 指定时效 + session | life-30_session-abcd1234 | 多账号 / 多环境:每个环境一个固定 session,互不串号。 |

看「IP 时效」与 session 两处 选择「指定时效」并设置 IP 持续时长与 session,即得到粘性代理

看红色标注 1—3 标注 1—3:指定时效 → 持续时长(示例 5 分钟)→ session(示例 AOBLyIV)
地区写法与代码速查
| 层级 | 账密认证(username) | API 提取(链接参数) | 示例 |
|---|---|---|---|
| 国家 / 地区 | area-US | cc=US | 美国 US、德国 DE、英国 GB,以及中国香港、中国台湾、中国澳门等 |
| 州 / 省 | state-ALASKA | state=BAVARIA | 美国的州、德国的联邦州等 |
| 城市 | city-ANCHORAGE | city=NUREMBERG | 精确到城市的定向 |
| 运营商 | asn-12345 | 以控制台提供为准 | 指定 ISP 网段,适合对线路敏感的验证任务 |
「代理区域」与「国家定向」的区别 控制台里的「代理区域」用于指定 IP 池所在的大区(如美洲区域),默认智能即可;它与 area / cc 的国家定向是两件事——前者选“池子在哪个大区”,后者选“IP 落在哪个国家 / 城市”。
场景化参数组合推荐
| 业务场景 | 推荐组合 | 说明 |
|---|---|---|
| 指纹浏览器多账号 | 账密认证 + life-60 + 每环境独立 session | 出口稳定、互不串号;「批量生成」可一次产出一组。 |
| 公开数据采集 / 爬虫 | API 提取(num 按并发)+ 短 life | 按需取量、IP 自动轮换,成本可控。 |
| 电商比价 / 库存监测 | 账密认证 + 国家定向 + 指定时效 | 同一站点连续请求时可降低风控概率。 |
| 广告验证 / 落地页核验 | 账密认证 + 国家 + 城市定向 | 确保看到的是目标地区真实视图。 |
| 移动端 App / 模拟器 | 账密认证 + 通用模式 + 指定时效 | 客户端需要手工填写的字段最少。 |
| 长期店铺 / 账号托管 | 静态住宅代理(流量或带宽)+ 固定 IP | IP 不自动变化,账号身份最稳定。 |
| 长周期、高并发的大规模采集 | 不限量住宅代理(按带宽 + 并发 + 计费周期选档) | 流量不设上限,按所选时间周期计费;能力由带宽与并发两项共同决定。 |

看左右两栏的联动 左侧任何参数变化,右侧生成的用户名都会同步更新
六种高频写法错误
| 现象 | 常见原因 | 修正 |
|---|---|---|
| 认证失败 / 无返回 | 用户名被二次编辑,参数段缺少下划线或多了空格 | 直接使用「复制」按钮的结果,不要手工改动。 |
| IP 落在错误国家 | area / cc 拼写错误,或选了非本产品的区域 | 从控制台下拉框重新选择并复制。 |
| 所有环境 IP 相同 | 批量生成时复用了同一个 session | 重新生成一批 session,或使用「批量生成」自动分配。 |
| IP 频繁变化 | 未设置 life,或选择了「每次请求更换」 | 改为「指定时效」并设置 30—120 分钟。 |
| 同一 IP 长期不变被限流 | life 上限 120 分钟且持续复用同一 session | 定期轮换 session,或降低单 IP 的请求频率。 |
| 多条结果粘连成一行 | lb(分隔符)与解析方式不匹配 | 按脚本解析习惯选择换行 / Tab 等分隔符。 |

看「格式」列选项 格式列选择“代理服务器:端口:用户名:密码”后可直接粘贴到代理管理器
相关文档 代理使用说明(命令行 / 代码 / 客户端接入) | 账密认证提取
