EN 中文 RU

独立指南站点

TG WS Proxy
给 Telegram Desktop 更聪明的连接路径

TG WS Proxy 是本地 SOCKS5 代理。命中 Telegram DC 流量时优先走 WSS（`kws*.web.telegram.org`），异常时自动回退直连 TCP。

下载 Releases 查看源码

声明：本站为独立介绍站，不隶属于 Telegram 或项目维护者。

开源许可

MIT License

构建方式

GitHub Actions + PyInstaller

最新版本

v1.2.1 (2026-03-22)

工作原理

  1. Telegram Desktop 连接到本地 SOCKS5：127.0.0.1:1080。
  2. 代理识别 Telegram 目标 IP，并从 MTProto obfuscation init 包提取 DC 信息。
  3. 优先建立到 `kws*.web.telegram.org` 的 TLS WebSocket（binary 协议）连接。
  4. 按帧转发 MTProto 负载，减少握手包被错误合并导致的问题。
  5. 若 WS 出现 302/重定向类异常，自动降级到直连 TCP。
Telegram Desktop
  -> SOCKS5 127.0.0.1:1080
  -> TG WS Proxy
  -> WSS kwsN.web.telegram.org (/apiws)
  -> Telegram DC

桌面端友好

支持 Windows 托盘 GUI、macOS 应用包、Linux 包与 CLI 模式。

流量策略

识别 Telegram IP 段，并对 DC 与 media/non-media 流量进行路径分离。

可调参数

支持 `--port` 和多组 `--dc-ip`，可按网络环境做针对性调优。

稳定性机制

内置连接池、失败冷却和自动回退逻辑，降低频繁重连抖动。

快速上手

1. 下载程序

从 Releases 下载 `TgWsProxy_windows.exe`、`TgWsProxy_macos_universal.dmg` 或 `TgWsProxy_linux_amd64.deb`。

2. 启动代理

默认监听 127.0.0.1:1080。桌面版提供托盘控制与日志入口。

3. Telegram Desktop 设置 SOCKS5

服务器 127.0.0.1，端口 1080，用户名和密码留空。

tg-ws-proxy --port 1080 \
  --dc-ip 2:149.154.167.220 \
  --dc-ip 4:149.154.167.220 -v

最新版本更新

  1. 更新说明会从上游 GitHub Releases 自动加载。
  2. 若此处未及时刷新，请到上游仓库 release 页面查看最新信息。

Release 文件（v1.2.1）

合作推荐

NordVPN

适合同时需要额外隐私保护与跨区域访问工具的用户。

查看优惠

披露：本区块可能包含联盟营销链接。若你通过这些链接购买，我们可能获得佣金，但不会增加你的额外费用。

社区实践与观察

移动端现状

主线项目目前主要面向 Telegram Desktop。Android 上有社区方案（Termux/移植版），但兼容性会随设备与网络环境波动。

手机通过电脑接入（局域网）

维护者在讨论中给过可行路径：电脑端把 host 设为 0.0.0.0，手机 Telegram SOCKS 填电脑局域网 IP 和端口。

“聊天可用但媒体不加载”

社区高频现象之一是文本正常、媒体失败。常见排查动作是测试补充 DC 映射，如 `203:149.154.167.220`。

跨公网使用提醒

若跨网络接入，通常需要公网 IP 和端口转发。维护者观点是：这不是 SOCKS 的推荐默认使用方式。

FAQ

为什么有时提升不明显？

这属于“部分优化”方案，效果受线路、地区、运营商和 Telegram 侧状态影响。

需要远程第三方代理服务器吗？

不需要。它是本地进程，核心是把流量转发到 Telegram 的域名和节点。

杀毒软件报毒怎么办？

README 提到可能存在误报。请仅从官方 Releases 下载，并自行校验文件。

会影响 Telegram 账号安全吗？

它不会修改你的账号凭据或 Telegram 认证流程，本质上是本地流量转发。

会记录消息内容吗？

程序包含连接/调试日志。请把日志当作敏感运行数据，不要公开传播。

支持手机 Telegram 吗？

项目主要面向 Telegram Desktop 场景，移动端不是核心目标。