5分钟上手tg-ws-proxy-androidTelegram本地MTProto代理安装、启动与一键配置完整指南tg-ws-proxy-android是一款运行在 Android 手机上的本地 Telegram MTProto 代理工具Telegram WS Proxy可将 Telegram 流量通过 Cloudflare WebSocket 加密通道转发或在无 CF 时直连数据中心帮助解决消息加载慢、卡在路由、媒体打不开等网络问题。本教程面向新手用 5 分钟带你完成安装、启动与一键配置。 它是什么能解决什么问题简单来说tg-ws-proxy-android 在你的手机内部启动一个本地 MTProto 代理服务器Telegram 客户端把流量交给它再由它走加密 WebSocket 通道送达 Telegram 数据中心。Telegram 客户端 ↓ 本地 MTProto 代理默认 127.0.0.1:1443 ↓ TG WS Proxy 引擎Rust 编写 ↓ WSS 加密通道经 Cloudflare 或直连 ↓ Telegram 数据中心DC它的核心卖点⚡双路由模式可走 Cloudflare 加密 WebSocket 通道也可关闭 CF 直连数据中心视网络情况切换一键导入点一下「Apply in Telegram应用到 Telegram」自动通过tg://proxy深链接把代理写入兼容的 Telegram 客户端原版客户端及众多 Fork 客户端均支持后台常驻基于前台服务Foreground Service运行通知栏实时显示流量与会话数连接池预热WS 连接池 keepalive 机制减少首次连接和加载媒体时的延迟️现代界面Material 3 Jetpack Compose 打造支持动态取色、深浅主题↩️开机自启重启手机后自动恢复代理部分机型需解锁后触发 更多细节可参考项目说明文档README.md 五分钟快速上手安装与启动第 1 步下载并安装 APK获取最新版本的 APK 安装包项目以多架构发布universal 通用版、arm64-v8a 版、armeabi-v7a 版手机上允许「安装未知来源应用」点击 APK 完成安装应用要求 Android 7.0SDK 24及以上覆盖绝大多数设备第 2 步启动本地代理打开Telegram WS Proxy应用你会看到简洁的主界面Proxy 页点击「Запустить прокси启动代理」按钮系统会弹出通知权限请求点击允许通知栏出现「Proxy is running代理运行中」即代表本地代理已在127.0.0.1:1443端口就绪启动逻辑由前台服务 ProxyService.kt 承载而真正的代理引擎是 Rust 编写的原生库libtgwsproxy.so通过 NativeProxy.kt 调起入口实现在 src/lib.rs 的StartProxy导出函数中。第 3 步一键应用到 Telegram这是最省心的部分——代理启动后点击「Применить в Telegram应用到 Telegram」按钮系统自动跳转到 Telegram 客户端弹出「添加代理」确认框点击确认/添加Telegram 即开始使用本地代理整个过程不需要手动填写主机、端口和密钥这就是「一键配置」的由来。按钮的跳转逻辑可在 ExternalLinks.kt 中查看。⚙️ 一键配置详解关键设置项在Connection连接标签页新手只需要关注下面这几项设置项推荐值说明路由模式AutoCF enabled自动经 Cloudflare 转发切换 Direct 则直连数据中心端口Port1443默认本地监听端口被占用时会自动提示更换WS 连接池2~4预热的 WebSocket 连接数越大首次加载越快但后台占用略增密钥Secret key保持不变16 字节 MTProto 加密密钥仅在密钥泄露时才需更换开机自启Autostart按需开启重启后自动拉起代理适合长期使用者模式怎么选移动网络不稳定、加载卡顿时优先使用CF 模式Auto流量走 Cloudflare 的 WebSocket 域名路由通常更稳定CF 模式下反而变慢时切换到Direct 模式连接将直达 Telegram 数据中心地址解析与调度逻辑见 src/cfproxy.rs 和 src/balancer.rs️ 进阶小功能让体验再上一台阶快捷设置磁贴从通知栏下滑在 Quick Settings 中添加 tg-ws-proxy 磁贴无需打开 App 即可一键开关代理实现在 ProxyTileService.kt实时日志面板切换到 Logs 标签页可实时查看连接事件、路由与连接池状态出问题时一目了然面板代码LogsTab.kt应用内自动更新发现新版本时会主动弹窗提示无需手动检查一键生成问题报告遇到问题时点「Собрать отчёт生成报告」自动汇总系统版本、架构、设置与错误日志方便反馈❓ 常见问题FAQQ1点了「应用到 Telegram」却提示找不到 Telegram说明手机上未安装兼容的 Telegram 客户端。应用支持的客户端列表可在 AndroidManifest.xml 的queries节点中看到包含原版及常见 Fork 客户端。Q2连接很久不完成通常不是 App 崩溃而是当前路由不通。快速重启代理并对比 CF 开/关两种模式的表现保留更快的那一种。Q3日志里有零星报错正常吗如果代理工作正常个别小错误可以忽略确认为故障时请使用「生成报告」功能收集信息再反馈。Q4想从源码自己构建克隆仓库git clone https://gitcode.com/gh_mirrors/tg/tg-ws-proxy-android cd tg-ws-proxy-android然后按 Windows 批处理脚本 build_so.bat 先编译 Rust 原生库再用 build_apk.bat 打包出三种 APK。 总结步骤操作耗时1安装 APK1 分钟2授予通知权限点击「启动代理」1 分钟3点击「应用到 Telegram」并确认1 分钟4按需调整模式 / WS 池 / 自启2 分钟至此一个运行在 Android 上的 Telegram 本地 MTProto 代理已经跑起来了。它结构简单但工程扎实——Rust 高性能引擎负责转发src/proxy.rsKotlin Compose 负责交互MainActivity.kt配合 CF 双路由与连接池足以应对大多数移动网络下 Telegram 加载不稳的场景。创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考