代理

TelegramOS 中的代理：支持的类型、配对规则、连通性测试、粘性会话恢复与流量。

工作区中的每个账号都通过各自专属的代理连接。代理既提供 IP 多样性（降低 Telegram 将多个账号关联起来的风险），也提供稳定的传输层。

代理类型

不支持 MTProto 代理。代理有两个来源：从平台池分配给你的租用代理，以及你自己的代理（由你提供端点和凭据）。

你可以批量导入自己的代理：每次请求最多 100 个，以 JSON 列表形式提交。

配对规则

• 严格执行一个账号一个代理。一个账号最多持有一个代理，一个代理最多服务一个账号。将一个已被 active 或 warming 账号持有的代理再分配给别的账号会被拒绝（409）。
• 租用账号不能改指向另一个租用代理。

连通性测试

可以通过 POST /api/proxies/{id}/check 按需运行测试，也可以在创建代理时带上 test_on_create=true（默认关闭）。测试分三步：

1. 解析代理主机名，并要求得到公网 IP。私有地址、环回地址、链路本地地址、组播地址和保留地址均会导致测试失败。
2. 通过该代理向 http://api.ipify.org 发送一次 GET 请求。
3. 记录结果：reachable或unreachable、出口 IP 以及延迟。

测试失败只会记录结果。不会隔离任何东西，平台也不会按计划重新测试；修好端点后请再次运行检查。

代理不可达的账号会由错误恢复机制重试：30 分钟后第一次，之后延迟逐次翻倍，最多 5 次。

工作进程启动时的 IP 泄漏检查

每次账号的工作进程启动时，都会进行一次离线泄漏检查，确认代理主机不是服务器自身的 IP。如果是，该账号会被暂停，并标记 pause_reason=ip_leak。

私有地址范围

连通性测试会拒绝解析到以下范围的代理主机：

• 10.0.0.0/8
• 172.16.0.0/12
• 192.168.0.0/16
• 127.0.0.0/8
• 169.254.0.0/16
• 组播地址和保留地址

命中这些范围只会导致测试失败。

粘性会话恢复与轮换

没有计划性轮换。租用代理保持粘性会话，只有在出口看起来已失效时，工作进程才会替换它：

• 当某个账号在 15 分钟内有 4 次或更多连接尝试全部失败时，该租用代理的粘性会话 id 会被更换。账号获得新的出口 IP，凭据不变。
• 每个账号每 30 分钟最多一次，每轮扫描最多处理 10 个账号。
• 当超过 30% 的账号都在失败时会被抑制。这种情况被视为故障，而不是代理问题。
• 如果账号在 6 小时后仍然失败，会被暂停，原因为 proxy_unreachable。

手动轮换（POST /api/proxies/{id}/rotate）仅适用于你自己的代理。对租用代理会被拒绝。

流量配额

每个租用代理套包每月包含 50 MB 流量。

你自己的代理不由平台计量。

常见问题

我可以让两个账号使用同一个代理吗？不可以。一个账号一个代理。已被 active 或 warming 账号持有的代理会被拒绝（409）。

租用代理不工作了会怎样？工作进程会更换粘性会话以获取新的出口 IP（见“粘性会话恢复”）。如果账号持续失败 6 小时，会以 proxy_unreachable 为原因被暂停。

我可以为租用账号使用自己的代理吗？不可以。租用账号只接受租用代理；与你自己的代理配对会被拒绝（403）。

自有账号可以使用租用代理吗？可以，前提是该租用代理已分配给你。

如何查看我当前代理的 IP？运行连通性测试。它会记录出口 IP 和延迟。