5分钟上手tg-ws-proxy-android：Telegram本地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.0（SDK 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（连接）标签页，新手只需要关注下面这几项：
| 设置项 | 推荐值 | 说明 |
|---|---|---|
| 路由模式 | Auto（CF enabled） | 自动经 Cloudflare 转发；切换 Direct 则直连数据中心 |
| 端口（Port） | 1443（默认） | 本地监听端口，被占用时会自动提示更换 |
| 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）
- 应用内自动更新：发现新版本时会主动弹窗提示，无需手动检查
- 一键生成问题报告：遇到问题时点「Собрать отчёт（生成报告）」，自动汇总系统版本、架构、设置与错误日志，方便反馈
❓ 常见问题（FAQ）
Q1：点了「应用到 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 | 安装 APK | 1 分钟 |
| 2 | 授予通知权限，点击「启动代理」 | 1 分钟 |
| 3 | 点击「应用到 Telegram」并确认 | 1 分钟 |
| 4 | 按需调整模式 / WS 池 / 自启 | 2 分钟 |
至此，一个运行在 Android 上的 Telegram 本地 MTProto 代理已经跑起来了。它结构简单但工程扎实——Rust 高性能引擎负责转发（src/proxy.rs），Kotlin + Compose 负责交互（MainActivity.kt），配合 CF 双路由与连接池，足以应对大多数移动网络下 Telegram 加载不稳的场景。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
