TG WS Proxy新手教程:3种方法快速连接Telegram Desktop(tg://proxy链接/手动配置/托盘应用)
TG WS Proxy是一款免费的本地 MTProto 代理服务器,专为 Telegram Desktop 设计,通过 WebSocket 连接转发流量来加速 Telegram 加载。数据全程加密传输,无需依赖任何第三方服务器。本文将通过 3 种简单方法,帮你在几分钟内完成 Telegram Desktop 代理连接。
工作原理:一句话看懂 TG WS Proxy
Telegram Desktop → 本地 MTProto 代理 (127.0.0.1:1443) → WebSocket → Telegram DC简单来说,TG WS Proxy 在本机127.0.0.1:1443启动一个 MTProto 代理,拦截 Telegram 的连接请求,自动识别数据机房(DC ID),并通过 TLS WebSocket 连接到对应的 Telegram 机房。核心逻辑位于 proxy/tg_ws_proxy.py,代理参数定义在 proxy/config.py。
💡 若 WebSocket 不可用(返回 302 重定向),程序会自动切换为 CfProxy 或直连 TCP,无需人工干预。
第一步:下载并启动托盘应用
打开仓库的 Releases 页面下载对应系统的安装包:
| 系统 | 安装包 | 要求 |
|---|---|---|
| Windows 10+ x64 | TgWsProxy_windows.exe | Windows 10+ x64 |
| Windows 10+ ARM64 | TgWsProxy_windows_arm64.exe | Windows 10+ ARM64 |
| Windows 7 | TgWsProxy_windows_7_64bit.exe/_7_32bit.exe | Windows 7 x64/x32 |
| macOS | TgWsProxy_macos | Intel 10.15+ / Apple Silicon 11.0+ |
| Linux | TgWsProxy_linux | x86_64,需 AppIndicator |
各平台详细步骤可参考官方文档:README.windows.md、README.macos.md、README.linux.md。
首次启动会弹出一个说明窗口,随后应用自动缩入系统托盘常驻运行:
方法一:tg://proxy 链接一键连接(推荐 ⭐)
这是最省事的自动配置方式,全程只需 3 次点击:
- 右键托盘图标,选择「Open in Telegram」(在 Telegram 中打开),即可自动完成配置;
- 若未生效,选择「Copy Link」(复制链接);
- 把链接发送到 Telegram 的「收藏夹/Saved Messages」,点击链接并确认连接即可。
链接格式形如tg://proxy?server=127.0.0.1&port=1443&secret=...,Secret 由程序自动生成,可在首启窗口或日志中查看。
方法二:Telegram Desktop 手动配置 MTProto 代理
如果链接方式不生效(例如未安装 Telegram Desktop 客户端),可以手动填写:
- 打开 Telegram →设置→高级设置(Advanced)→连接类型→代理;
- 点击添加,填入以下参数:
- 类型:
MTProto - 服务器:
127.0.0.1(或你自定义的地址) - 端口:
1443(或你自定义的端口) - Secret:在托盘应用首启窗口、设置界面或日志中复制
- 类型:
- 保存后 Telegram 即通过本地代理上网。
方法三:用托盘应用管理代理(免安装感体验)
TG WS Proxy 本体就是一个托盘应用,日常使用无需再打开任何窗口,右键托盘图标即可:
- Open in Telegram— 通过
tg://proxy链接自动配置代理 - Copy Link— 复制代理连接链接
- Restart Proxy— 不退出应用直接重启代理
- Settings...— 图形化配置编辑器(修改端口、DC IP 等)
- Open Logs— 打开日志文件排查问题
- Exit— 停止代理并退出
配置数据存放在:Windows 为%APPDATA%/TgWsProxy,macOS 为~/Library/Application Support/TgWsProxy,Linux 为~/.config/TgWsProxy,字段说明见 TrayConfig.md。
🌟 进阶技巧:
- 开机自启:Windows 配置文件中可开启
autostart,登录后代理自动运行; - 便携模式:在可执行文件旁建立
TgWsProxy_data文件夹(或加--portable参数),所有数据随程序走,适合 U 盘场景; - Docker 部署:服务端场景可参考 README.docker.md。
常见问题速查
❓ 照片/视频加载不出来?这通常发生在非 Premium 账户上。请在 Telegram 代理设置的DC → IP中只保留4:149.154.167.220,若无帮助则清空该字段。仍不生效可按 CfProxy.md 配置自己的 Cloudflare 域名。
❓ 杀毒软件误报病毒?打包器可能导致误报。可尝试下载功能完全相同的 Windows 7 版本,或临时关闭杀毒软件下载后添加排除项。
❓ 想自定义参数或了解源码?
- 项目结构总览:docs/README.md
- 托盘应用配置文件说明:docs/EN/TrayConfig.md
- 各平台打包配置:packaging/windows.spec、packaging/macos.spec、packaging/linux.spec
小结
| 方法 | 适用场景 | 难度 |
|---|---|---|
| tg://proxy 链接 | 日常一键连接 | ⭐ |
| 手动 MTProto 配置 | 链接失效时的兜底方案 | ⭐⭐ |
| 托盘应用管理 | 开机自启、参数调整 | ⭐⭐ |
按以上任一方法操作,3 分钟内即可用上 TG WS Proxy 加速你的 Telegram Desktop,告别加载慢!
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考