# Username 参数语法

账密模式下,地理定位和会话控制全部通过在用户名后追加参数实现,密码保持不变。本页是完整语法参考。

## 语法结构

```
{账号}-pool-flow[-region-{国家码}][-state-{州名}][-city-{城市}][-asn-{ASN}][-sid-{8位随机}-ttl-{分钟}]
```

从左到右依次为:账号主体 → 池标识(固定 `-pool-flow`)→ 地理定位参数 → 会话参数。**顺序固定,不可调换**。

## 参数说明

| 参数 | 格式 | 说明 |
| --- | --- | --- |
| `-pool-flow` | 固定值 | 动态住宅池标识,账密模式必带 |
| `-region-{CC}` | ISO 两位国家码 | 国家定位,如 `US`、`GB`、`JP`、`AE`,不区分场景免费 |
| `-state-{State}` | 州/省名称 | 需与 `region` 同时使用,如 `California` |
| `-city-{city}` | 城市名,小写、去空格 | **必须与 `state` 同时使用**,如 `losangeles`、`newyork` |
| `-asn-{ASN}` | `AS` + 数字 | ASN(运营商网络)定位,如 `AS15802`;**与 state/city 互斥**,只能与 region 组合 |
| `-sid-{seed}` | 8 位随机字母数字 | 粘性会话标识,同一 sid 复用同一 IP;换 sid 即换 IP |
| `-ttl-{n}` | 整数,1–120 | 粘性会话保持分钟数,与 `sid` 成对出现 |

## 组合规则

* 只轮换不定位:`USERNAME-pool-flow`
* 定位可逐级细化:region → region+state → region+state+city
* ASN 定位与 state/city 不能同时使用
* 粘性会话参数永远放在最后
* 不带 `sid`/`ttl` 时为默认行为:**每次请求自动轮换 IP**

## 示例大全

```bash
# 1. 全球随机 IP,逐请求轮换
curl -x proxy.eproxies.net:23333 -U "USERNAME-pool-flow:PASSWORD" https://ipinfo.io

# 2. 指定国家(美国)
curl -x proxy.eproxies.net:23333 -U "USERNAME-pool-flow-region-US:PASSWORD" https://ipinfo.io

# 3. 指定到州(美国加州)
curl -x proxy.eproxies.net:23333 -U "USERNAME-pool-flow-region-US-state-California:PASSWORD" https://ipinfo.io

# 4. 指定到城市(美国加州洛杉矶)
curl -x proxy.eproxies.net:23333 -U "USERNAME-pool-flow-region-US-state-California-city-losangeles:PASSWORD" https://ipinfo.io

# 5. ASN 定位(阿联酋 AS15802)
curl -x proxy.eproxies.net:23333 -U "USERNAME-pool-flow-region-AE-asn-AS15802:PASSWORD" https://ipinfo.io

# 6. 国家 + 粘性会话(同一美国 IP 保持 30 分钟)
curl -x proxy.eproxies.net:23333 -U "USERNAME-pool-flow-region-US-sid-a1b2c3d4-ttl-30:PASSWORD" https://ipinfo.io

# 7. 城市级定位 + 粘性会话
curl -x proxy.eproxies.net:23333 -U "USERNAME-pool-flow-region-US-state-California-city-losangeles-sid-a1b2c3d4-ttl-30:PASSWORD" https://ipinfo.io
```

> 不确定参数怎么拼?控制台「代理设置」页提供可视化生成器:选择国家/州/城市/会话类型后,页面会实时生成完整 username,直接复制即可。支持的国家和城市列表也在该页查询。

## 常见错误

| 现象 | 原因 | 解决 |
| --- | --- | --- |
| 认证失败(407) | username 拼写错误或缺少 `-pool-flow` | 用控制台生成器核对 |
| 城市定位不生效 | `city` 未携带 `state` | 补上 `-state-{州名}` |
| ASN 定位不生效 | 与 `state`/`city` 混用 | ASN 只能与 `region` 组合 |
| IP 频繁变化 | 未使用粘性会话 | 追加 `-sid-{8位}-ttl-{分钟}` |