代理管理与账号出口¶

Telegram Panel 按账号管理 Telegram 连接出口。导入、登录，以及后台任务和模块对账号执行的 Telegram 操作都会复用账号当前路由，避免同一个账号先直连、后切换代理。

先区分面板出口和账号出口¶

代理管理页顶部显示的是面板服务自身的公网出口。代理列表和账号详情显示的是对应代理或账号的出口，两者互不等价。

顶部显示“未使用 WARP”：只表示面板服务自身没有通过 Cloudflare WARP。
WARP 代理行显示“WARP 已连接”：表示该轻量出口的 WARP 检测成功。
出口地址包含冒号时通常是 IPv6。IPv6 同样是有效公网出口。
当前出口检测先使用 Cloudflare Trace 验证公网 IP，再按 IP 补充国家/地区、城市和 ISP。地理服务临时不可用时仍会保留已验证的 IP 和国家码，不会把代理误判为失败。

选择账号使用的出口¶

账号支持以下路由：

明确直连：绕过账号代理和全局代理。
全局代理：继承 Telegram:Proxy 配置。
已有代理：绑定代理管理中的 HTTP、SOCKS5、MTProxy、Resin、外部 WireGuard WARP 或内置轻量 WARP。
外部 WireGuard WARP：运营方在面板外运行 WireGuard/gost 等轻量出口，面板只保存它暴露出的 HTTP/SOCKS5 监听并绑定账号。
独立 WARP：v1.31.81 起，一键创建、登录、导入及逐账号绑定统一使用主容器内的轻量 wgcf＋wireproxy。选择“创建一对一 WARP”并勾选条款后，在首次验证前创建独占出口。

导入账号、手机号登录和二维码登录都会在第一条 Telegram 请求前要求选择路由。选定后，验证码发送、二维码轮询、2FA 验证和 Session 建立会使用同一出口；失败时不会静默回退到面板直连。

切换已入库账号的代理时，宿主会先停用账号并严格断开旧客户端，再提交新路由并重建连接。模块和后台任务下一次按账号执行操作时会自动使用新出口。

账号列表的“代理”列以 #代理编号 作为主要标识，避免自动生成的 WARP 名称占用过多空间；鼠标悬停在编号上仍可查看完整代理名称，下一行继续显示已检测到的出口 IP。编号与“代理管理”列表中代理名称下方的 #ID 一致，可用于快速核对账号实际绑定的代理。

导入后的绑定规则¶

导入或登录选择已有代理后，账号会保存该代理的 ProxyId，并关闭全局继承；以后仍会长期使用这条专属代理，直到在账号管理中手动切换或解除。
选择全局设置时，账号保存为 ProxyId=null、UseGlobalProxy=true，以后会跟随全局代理的修改；选择直连则保存为 ProxyId=null、UseGlobalProxy=false。
账号有专属 ProxyId 时始终优先于全局代理。全局代理选择已有代理时只保存代理 ID，运行时从代理表读取最新的 WARP/Resin 参数，不复制过期凭据快照。

配置全局代理¶

在 代理管理 → 全局代理 中可以直接启用 HTTP、SOCKS5 或 MTProxy，也可以从已有的普通代理、外部 WireGuard WARP 或 Resin 中选择。v1.31.83 起，已就绪的内置轻量 WARP 也可以设为全局代理，同一个出口允许多个账号显式共享。旧容器 WARP 在 v1.31.82 起不再支持。选择已有代理时保存的是代理引用，后续编辑该代理会对继承全局的账号生效。保存后面板会立即重载配置并清理 Telegram 客户端缓存；继承“全局设置”的账号会在下一次连接时使用新出口，账号已绑定的独立代理和明确直连不受全局代理覆盖。配置缺失或无效时会在连接 Telegram 前失败，不会回退为面板直连。

已保存的密码和 MTProxy Secret 不会回显；编辑时留空会保持原值，HTTP / SOCKS5 密码可通过“清除已保存的密码”显式删除。停用只关闭全局代理开关并保留连接参数，方便稍后恢复。

添加和检测普通代理¶

在 代理管理 中添加代理，然后执行出口检测。支持：

HTTP
SOCKS5
MTProxy
外部 WireGuard WARP HTTP 或 SOCKS5 监听
Resin HTTP 或 SOCKS5 数据面

HTTP 和 SOCKS5 可以通过 Cloudflare Trace 检测公网出口。外部 WireGuard WARP 也使用 Cloudflare Trace，但必须返回 warp=on 或 warp=plus 才算检测成功。MTProxy 只服务 Telegram MTProto，不能通过普通 HTTP 请求检测公网 IP。

代理列表支持按“使用中/未使用”和分类筛选；勾选多个代理后可以批量设置分类或删除。批量删除会逐项执行并列出失败原因；仍被账号或全局代理使用的项目会保留，其它可删除项目不受影响。使用中包括直接绑定账号，以及被全局代理引用的代理。

从 v1.31.44 起，启用的普通代理、外部 WireGuard WARP 和 Resin 默认每 5 分钟自动做一次轻量健康巡检。巡检请求使用 Proxy:Egress:ProbeUrl（Docker 环境变量 TP_PROXY_EGRESS_PROBE_URL），默认是 https://208.67.222.222/；它只确认代理 HTTP/SOCKS 链路能发起出站请求，不调用 Cloudflare Trace，也不会刷新 IP、国家/地区、城市或 ISP 快照。需要查看或更新出口元数据时，继续使用页面上的手动“检测出口”，该操作才会访问 Proxy:Egress:MetadataUrl（默认 https://cloudflare.com/cdn-cgi/trace），外部 WireGuard WARP 仍要求 Trace 返回 warp=on 或 warp=plus。

可通过 Proxy__Egress__Maintenance__Enabled=false 回滚到仅手动检测； Proxy__Egress__Maintenance__IntervalMinutes 可调整周期（默认 5 分钟）。成功判据是服务日志不再每 5 分钟出现 Cloudflare Trace 请求，代理行“最近检测”持续更新，手动检测仍能刷新出口 IP 和 WARP 状态。失败时查看服务日志中的 Proxy egress maintenance，并先确认轻量探针 URL、代理地址、认证、外部 WireGuard 监听和 Resin 控制面可达；若自定义探针不可用，改回默认 ProbeUrl 或关闭巡检。

外部 WireGuard WARP 多出口¶

计划 v1.31.79 附带可选的共享 WireGuard 运维工具，运营者可在明确接受 Cloudflare 条款后，通过命令注册独立 WARP 材料、在一个共享容器运行多个用户态 WireGuard 出口，并调用既有面板 API 检测和绑定。该工具仍属于面板外运维通道，没有新增面板内注册页面；真实注册和 Telegram 路径需要另行验收。

这是当前版本支持的轻量多出口路径：面板不尝试在宿主机创建 WireGuard 接口、不写入 wg-quick 配置、不复制或改写 Cloudflare WARP 私钥，也不验证“只改 PrivateKey 就能生成新 Cloudflare peer”这类假设。Cloudflare 官方 Linux 文档只说明 WARP 客户端可以把隧道协议切换为 WireGuard，并未把复制配置改 key 声明为可由面板安全托管的生命周期接口；因此宿主网络和 WARP 注册仍由运营方在面板外管理。

推荐拓扑是每个外部出口在宿主机或旁路容器中自行运行：

运营方准备独立、有效的 WARP/WireGuard 出口，并为每个出口启动本地 HTTP 或 SOCKS5 监听（例如 127.0.0.1:1080、10.0.0.5:1081）。
确认监听地址能被 Telegram Panel 容器访问；容器内的 127.0.0.1 指向面板容器自身，访问宿主机监听时通常要使用 Docker 网络地址或 host.docker.internal。
在 代理管理 → 新增代理 → 外部 WireGuard WARP 中填写协议、主机、端口和可选认证，或批量导入：

wg-warp+socks5://user:password@host.docker.internal:1080
wg-warp+http://10.0.0.5:8080

保存后建议保持“保存后检测出口”。检测成功的判据是：代理行显示可用、存在公网出口 IP，且 Cloudflare Trace 报告 WARP 已启用；未检测成功的外部 WireGuard WARP 端点不能绑定账号或作为全局已有代理生效。成功后它会作为普通已有代理参与账号绑定、导入首次连接、账号列表出口展示、分类筛选和每 5 分钟出口巡检，不会创建 Docker WARP 容器或数据卷。

故障排查按边界分工处理：面板只负责保存连接参数、发起 HTTP/SOCKS 握手、验证 WARP 出口和绑定账号；wg 接口、路由表、gost/3proxy 进程、WARP 注册与私钥轮换由运营方负责。若检测失败，先在面板容器内确认能连到监听地址，再检查外部代理是否真的经 WARP 出口访问 https://www.cloudflare.com/cdn-cgi/trace。需要回滚时，把账号切换到其它已有代理/全局设置/直连，或删除对应外部 WireGuard WARP 代理记录；面板不会停止外部 WireGuard 或代理进程。

不支持的托管模式¶

当前服务托管用户态 wireproxy 进程，已移除旧 Docker WARP 容器管理。直接管理宿主 WireGuard 需要 root 级网络权限、路由表和防火墙改写，以及对 WARP 注册材料的生命周期保证；这些都超出当前面板服务权限，所以不会实现为“复制配置并改 key”的一键托管功能。

在统一列表管理 WARP（v1.31.83）¶

升级 Linux Docker 镜像后，“一键创建 WARP”直接创建轻量出口。出口名称可填写，也可留空由系统自动命名；该入口自动使用已接受的 Cloudflare WARP 条款。登录、导入及账号绑定的 “创建一对一 WARP”也使用同一运行器，固定 SOCKS5，无需为每个出口创建 Docker 容器。每个出口仍有独立注册材料、配置、端口与进程，独立注册不保证不同公网 IP。成功判据为本地监听、WARP 检测成功与出口 IP；账号绑定后还需真实 Telegram 验证。失败先核对镜像依赖和网络并保留注册材料。完整步骤见轻量 WARP 部署。

新建后直接查看下方代理列表，不再显示单独的轻量 WARP 列表。创建中和失败档案即使尚未生成代理编号也会显示，完成后合并到同一行。该行提供启动、停止、恢复、检测和账号绑定；期望启停、监听状态及 WARP 检测分别展示，监听成功不代表公网出口检测已经通过。

轻量出口可以只绑定一个账号，也可通过“已有代理”、批量绑定或全局代理显式共享；共享账号使用同一出口，流量和故障影响也会集中。导入的“自动分配已有 WARP”仍只选择已就绪、检测成功且无账号或全局占用的出口，并在首次连接期间独占领取；池为空时明确失败。尚未完成首次连接的临时出口不能共享。已被账号、启用的全局配置或临时租约占用的出口不可停止或删除。

v1.31.82 的代理行在绑定后显示“已绑定账号”，点击人物按钮或账号数量即可查看备注、昵称、手机号后四位和当前代理。点击账号的“解绑 / 换绑”，明确选择“解绑并直连”“解绑并使用全局代理” 或“解绑并绑定到指定代理”，再确认提交。全局代理必须已正确配置；轻量目标必须已就绪并允许共享，不要求无人使用。换绑直接提交新代理，不会先解绑为直连。原出口与注册材料保留，全部账号移走后可手动停止。空闲出口仍提供“绑定账号”入口。出口故障时也可查看绑定并迁往其他代理。

“已绑定账号”列表只显示显式绑定该代理的账号；全局继承使用人数另外显示，不应将两者视为同一列表。

v1.31.83 起，轻量代理可以勾选、多选并批量设置分类；行内提供单个删除，批量删除也包含轻量出口。删除前先移走全部绑定账号、解除全局引用并等待临时操作结束。服务确认进程已停止后，才删除本地代理记录和档案材料；这不保证注销 Cloudflare 远端设备。操作失败会保留可重试状态，批量删除逐项报告失败，不影响其他可删除项。尚无代理编号的档案也可勾选删除，但不参与需要代理编号的分类操作；创建任务或临时操作仍在占用档案时，删除会被拒绝，需等待结束后重试。

操作后账号应从原出口的绑定列表移除，新账号路由和原出口使用数量同步刷新。遇到绑定冲突或请求超时，先刷新并核对当前路由再操作，不能把超时视为未执行。需要撤销时在账号页面重新选择仍可用的原出口；应用回滚不会还原已经确认的账号路由。回退至 v1.31.82 或更早版本前，必须把共享和全局轻量路由迁回旧版支持的路由，并保留数据库与注册材料备份；否则旧版会拒绝这些路由，不会自动直连。

旧容器升级与故障处理¶

v1.31.82 已删除旧 WARP 状态、刷新和自动维护入口，也不再加载旧 WARP Compose 配置或 Docker Socket。历史 kind=warp 记录保留用于迁移识别，但不能继续承载账号或全局路由；残留引用会阻止连接，不会自动直连。

仍使用旧容器时，先在升级前为每个账号建立独立轻量出口并验证 Telegram 只读资料获取。确认全部账号已迁移、旧全局引用和直接绑定均清空后，再删除旧代理与容器。备份、逐账号验收和回滚步骤见轻量 WARP 部署。回滚面板至 v1.31.82 或更早版本须先迁走不受支持的共享及全局轻量路由，并保留注册材料，不能恢复指向已删除容器的旧数据库。

轻量出口失效时，在对应代理行执行“检测”确认出口状态，必要时使用“恢复”。先检查运行器依赖、持久目录权限、UDP/DNS 网络与上游状态；不要删除注册材料或反复创建新出口。进程异常退出由运行器处理，不能把旧容器的定时重启或巡检参数套用到轻量出口。

对接 Resin 动态代理¶

先按 Resin 中文文档部署网关，再在 代理管理 中新增 Resin：

主机和端口：Resin HTTP 或 SOCKS5 数据面地址。
Proxy Token：保存到代理密码字段，只用于数据面认证。
Platform：例如 Default。
管理地址和 Admin Token：用于检查控制面并回收粘性租约。

面板会为账号生成稳定身份。导入阶段使用临时身份验证出口，入库后通过 inherit-lease 把租约继承给正式账号身份。继承失败时账号会保持停用，避免正式连接改用未经确认的出口。

Resin 提供粘性租约，但不保证节点故障后 IP 永远不变。页面展示的是最近一次成功检测得到的出口快照。

模块不重复管理账号代理¶

模块对已入库账号执行 Telegram 操作时，应把 accountId 交给宿主账号服务。宿主客户端池会自动解析账号路由并应用代理，模块不应再保存代理凭据或自行创建 WTelegram.Client。

模块自己的 HttpClient、第三方 API 或其它网络连接不会自动继承账号代理。如果这类请求确实需要代理，应作为模块自己的独立网络能力设计。完整边界见模块开发文档。

代理行操作菜单（v1.31.84）¶

代理行的启动、停止、检测、恢复、查看绑定账号、添加绑定账号和删除操作统一放在“操作”下拉菜单；普通代理的检测、编辑和删除也使用同一入口。账号数量仍可直接点击。使用情况列独立换行，右侧固定操作列使用不透明背景，窄屏横向滚动时不叠加账号文字。

验收应在窄屏及宽屏展开菜单，确认账号数与操作按钮不重叠、菜单未被表格裁切，已有占用限制与删除确认保持有效。未读取运行状态时先刷新。此修改不涉及API或数据库；回滚前端恢复旧布局即可。

代理重命名与通用操作名称（v1.31.86）¶

在代理行的“操作 → 重命名”中修改显示名称，保存后刷新列表即可看到结果。普通代理、Resin、外部 WireGuard 代理和已生成代理记录的轻量 WARP 均支持；已绑定账号或被全局设置使用时也可修改。名称去除首尾空白后须为 1–80 个字符。创建中尚无代理记录的出口，请等待记录生成后再重命名。

重命名仅保存名称，不重启进程、不改变出口 IP、地址、密码或账号绑定。保存成功会同时刷新顶部全局代理名称，无需手动刷新整个页面。保存失败时弹窗保留输入，可核对错误后重试。 WARP 与普通代理的菜单统一显示“检测出口 IP”“删除出口”；WARP 仍执行专用联网检测和本地进程清理，使用中的删除限制及删除确认保持有效。

验收时重命名后刷新页面，核对代理及账号引用显示新名称且原绑定不变。若保存失败，检查名称长度、管理员登录状态和代理是否已被删除。回滚旧镜像保留数据卷即可，但旧版轻量运行态可能显示创建时名称。