按流量计费代理参数

PPG代理的选择参数是附加在代理用户名后的后缀。使用控制台中的“配置并导出”选择代理池、节点、协议、位置和会话。

连接范围#

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

UDP#

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

用户名语法#

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

<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位或更多位数字无效。建议使用明确的有效值，不要依赖回退行为。

错误与重试#

PPG选择失败通常表现为HTTP代理错误码11，并附带具体消息。流量计量失败对应错误码12。余额不足对应错误码13，HTTP状态码为402，需要检查余额或充值，而不是重试网络请求。

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