# 用户名参数

用户名参数是附加到代理凭据用户名后的键值对（例如 USER-cc-de-city-berlin-sid-a1b2），用于告知网关应选择哪个出口以及保持多长时间。由于每个连接都会携带相应选择，因此只需一个主机名和一组凭据即可服务所有国家/地区、城市、提供商和会话模式，无需生成新的代理列表。


## 结构

| 参数 | 值 | 含义 |
| --- | --- | --- |
| -cc- | ISO 3166-1 alpha-2 | 出口所在国家/地区 |
| -state- | 美国邮政代码 | 美国州（与 -cc-us 搭配） |
| -city- | 小写 ASCII，不含空格 | 国家/地区内的城市 |
| -asn- | AS 编号 | 网络提供商或移动运营商 |
| -sid- | a-z 0-9，最多 32 个字符 | 粘性会话的会话标识符 |
| -ttl- | 1m 至 24h | 粘性会话的有效期 |


## 规则

- 参数顺序无关紧要；未知键会返回 400，因此拼写错误不会在无提示的情况下被路由到其他位置。
- 密码不会随参数改变。
- 使用 IP 白名单时，可用任意用户名携带参数；密码会被忽略。
- 无需进行 URL 编码：允许的字符在代理 URL 中均可安全使用。


## 在 ProxShift 中的工作方式

ProxShift 在 res.proxshift.com 上仅使用六个参数（-cc-、-state-、-city-、-asn-、-sid-、-ttl-），在 mob.proxshift.com 上使用其中适用的子集；文档页面列出了所有值和错误。

来源：https://proxshift.com/zh/glossary/username-parameters