按流量计费代理参数

PPG代理的选择参数是附加在代理用户名后的后缀。使用控制台中的“配置并导出”选择代理池、节点、协议、位置和会话。关于哪些内容计入计费流量以及如何减少计费流量，参见按流量计费的流量如何计算。

连接范围#

同一个PPG凭证可用于每个符合条件的节点，并支持HTTP或SOCKS5。所选代理池决定路由和价格。灵活令牌通过_pool-...选择其代理池。固定令牌使用其已保存的代理池，不需要该后缀；指定其他代理池的后缀会被拒绝。

UDP#

标记为UDP的代理池通过SOCKS5端点传输UDP。HTTP代理仅传输TCP。按流量计费代理池API将此报告为udp。UDP可以访问除少数常被滥用的服务（如SNMP、NetBIOS、SIP、SSDP和memcached）以外的任意目标端口。

浏览器无法通过其代理设置使用UDP：Chrome的SOCKS5支持只转发TCP，因此HTTP/3会回退到HTTP/2，WebRTC可能绕过代理。要让浏览器或整台设备使用UDP（HTTP/3、WebRTC通话），请将代理关联到VPN配置文件。UDP代理列出了支持UDP的代理池。

用户名语法#

在基础代理用户名后追加零个或多个以下划线分隔的片段：

<base-username>_pool-residential-kilo_country-us_region-california_city-los-angeles_sid-crawl-42_sttl-600

使用控制台中的小写slug。城市定位需要同时提供country和region。state是region的兼容别名；不要同时提供两者。在此用户名语法中，小写的国家别名uk会规范化为gb，这与免费代理API不同。

地理位置示例#

# country
<base-username>_pool-residential-kilo_country-us

# region inside a country
<base-username>_pool-residential-kilo_country-us_region-california

# city inside a region
<base-username>_pool-residential-kilo_country-us_region-california_city-los-angeles

使用控制台中为所选代理池显示的地理位置选项。语法有效的slug仍可能在该代理池中不可用。

无效或有歧义的示例：

<base-username>_city-los-angeles
<base-username>_region-california_city-los-angeles
<base-username>_country-us_region-california_state-california

粘性会话#

sid用于请求会话亲和性。清理后，会话ID包含字母、数字和连字符，且长度至少为3个字符。仅使用前15个字符，因此要让会话ID在前15个字符内保持唯一。

<base-username>_pool-residential-kilo_country-de_sid-cart-17_sttl-900

sttl控制请求的粘性时长，单位为秒。取值1至86400会被采用。当前的兼容行为会将0以及86401至999999的取值映射为600秒；7位或更多位数字无效。建议使用明确的有效值，不要依赖回退行为。

流量上限和到期时间#

每个按流量计费的代理都可以有自己的流量上限和到期日期。两者均为可选。用它们可以给客户、团队成员或工具分配固定的流量或固定的时间。

• 控制台。在“按流量计费”页面添加或编辑代理。到期时间是一个日期，代理在当天结束时（UTC）停止。**流量上限（GB）**是以GB为单位的上限；小数可用点或逗号书写（2.5或2,5）。在代理列表中，“流量统计”框会显示已统计的上限额度，它可能略超前于实际交付的流量。
• API。创建或更改代理时发送expiresAt和allowanceBytes。两者都会在每个令牌上返回。

上限统计您的客户端与节点之间双向的全部流量，包含协议开销，因此它绝不会小于您被计费的流量。代理可能在达到上限之前略早停止，但绝不会超出上限。上限只会拒绝流量，您被计费的金额不会改变。详情见流量上限。

已用完全部上限的代理会被代理错误24拒绝。添加、更改或移除上限会让该代理已打开的连接结束一次，客户端随后按新的上限重新连接。

代理地址#

设置 > 代理地址只有一个复选框：使用中性地址。默认关闭。开启后：

• 代理列表、代理生成器和API显示中性主机名和中性代理池名称；
• 更换IP链接使用中性地址；
• HTTPS代理行保留litport.net，因为HTTPS证书是为该名称签发的。

它改变的是我们为您的账户显示的名称。它不会改变代理的IP地址、VPN配置文件、邮件或控制台自身的地址。中性名称与标准名称相同时，该名称不会有任何变化。

错误与重试#

PPG选择失败通常表现为HTTP代理错误码11，并附带具体消息。流量计量失败对应错误码12。余额不足对应错误码13，HTTP状态码为402，需要检查余额或充值，而不是重试网络请求。已用完流量上限的代理对应错误码24，HTTP状态码为403；错误码25对应HTTP状态码503，表示未能及时读取上限，短暂重试即可。

可观察到的HTTP头和SOCKS5限制，参见代理错误参考。关于PPG上游故障，参见错误码16的处理建议。