TG WS Proxy Android：TG 本地代理

项目简介

TG WS Proxy Android 是一款运行在 Android 手机上的本地 MTProto 代理应用，是 Flowseal 的 tg-ws-proxy 的 Android 分支版本。它把 Telegram 的流量通过受保护的 CloudFlare WebSocket 连接（或直接连接 Telegram 数据中心）转发出去，用于部分绕开 Telegram 的加载问题，并在某些场景下加快收发速度。

应用基于 Kotlin + Jetpack Compose（Material 3）构建界面，代理核心为 Rust 原生引擎。

主要功能

• 本地 MTProto 代理：默认监听 127.0.0.1:1443，配合自动生成的密钥接管 Telegram 的本地连接。
• 一键应用到 Telegram：通过 tg://proxy 链接把代理配置传给兼容客户端（AyuGram、Plus Messenger、NekoGram 等）。
• 后台运行：使用 Foreground Service 与常驻通知，并附加连接保持逻辑，减少被系统回收的概率。
• 实时日志查看器：内置日志视图，可查看连接、路由与连接池状态。
• 主题与配色：支持 Android 12+ 的动态取色（Dynamic Colors），旧设备也可使用内置调色板。
• 应用内自动更新：新版本发布后应用内会提示更新，无需手动查看 Release。
• 内置帮助：包含设置说明、CloudFlare 相关细节、WS 连接池与手动配置数据中心的说明。
• 一键收集报告：应用内可直接生成诊断报告，便于提交 issue。

工作原理

Telegram Android → 本地 MTProto（默认 127.0.0.1:1443）→ TG WS Proxy → WSS（经 CloudFlare 或直连）→ Telegram DC

1. 应用通过 Rust 原生引擎启动本地 MTProto 代理。
2. 通过本地端口和生成的密钥接管 Telegram 的连接。
3. 从原始数据包中解析 DC ID，与对应数据中心建立加密 WebSocket（TLS）连接，必要时经 CloudFlare 中转。
4. 使用连接池、keepalive 与 fallback 机制，提升真实网络环境下的稳定性。

安装与使用

1. 从 Releases 页面 下载最新的 APK。
2. 安装到 Android 手机（支持 Android 5 及以上）。
3. 打开 TG WS Proxy Android，先阅读应用内的帮助说明。
4. 点击「启动代理」，出现后台运行通知。
5. 点击「在 Telegram 中应用」，跳转到 Telegram 客户端后确认连接即可。

官方还提供了视频教程：YouTube | Telegram

注意事项

• 应用针对移动网络做过适配，但受系统限制或网络环境影响，后台运行仍可能出现问题。
• 遇到崩溃或异常时，可在应用内点击「收集报告」，把结果附到 issue 中；代理正常工作时日志里的细小报错可以忽略。
• 数据中心 IP 与配置细节可参考 Flowseal 文档 与 相关 issue。
• 本项目以 GPLv3 分发；原始 tg-ws-proxy 代码由 Flowseal 以 MIT 许可发布。

本作品整理自 GitHub 开源项目 amurcanov/tg-ws-proxy-android，原作者 @amurcanov，许可证 GPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。