Flowseal/tg-ws-proxy
GitHub: Flowseal/tg-ws-proxy
一个本地运行的MTProto代理服务器，通过WebSocket协议转发流量来加速或部分绕过Telegram Desktop的网络限制。
Stars: 6637 | Forks: 323
##
# TG WS 代理
**本地 MTProto 代理**，适用于 Telegram Desktop，通过 WebSocket 连接重定向流量来**加速 Telegram**。数据以相同的加密形式传输，且无需第三方服务器即可运行。
## 目录
- **🚀 快速开始**
- **[Windows](./README.windows.md)**
- **[macOS](./README.macos.md)**
- **[Linux](./README.linux.md)**
- **[Docker](./README.docker.md)**
- [配置 Cloudflare Worker（CF 代理的免费替代方案）](./CfWorker.md)
- [配置 Cloudflare 域名（CF 代理）](./CfProxy.md)
- [Nginx 中的 Fake TLS + upstream](./FakeTlsNginx.md)
- [托盘应用程序配置文件](./TrayConfig.md)
- [从源代码安装](./BuildFromSource.md)
- [贡献者指南](../CONTRIBUTING.md)
## Windows：快速启动
前往[发布页面](https://github.com/Flowseal/tg-ws-proxy/releases)并下载：
- `TgWsProxy_windows.exe`（Windows 10+）
- `TgWsProxy_windows_7_64bit.exe`（Windows 7 x64）
- `TgWsProxy_windows_7_32bit.exe`（Windows 7 x32）
首次运行时，会打开一个窗口，显示连接 Telegram Desktop 的说明。**应用程序会最小化到系统托盘。**
### 托盘菜单
- **在 Telegram 中打开** — 通过 `tg://proxy` 链接自动配置代理
- **复制链接** — 复制连接链接
- **重启代理** — 不退出应用程序重启代理
- **设置...** — 配置文件的 GUI 编辑器（应用版本、可选的 GitHub 更新检查）
- **打开日志** — 打开日志文件
- **退出** — 停止代理并关闭应用程序
### 配置 Telegram Desktop
**自动配置**
右键单击托盘图标并选择**“在 Telegram 中打开”**。
如果不起作用（Telegram 未打开连接），请执行以下步骤：
1. 右键单击托盘图标并选择**“复制链接”**
2. 将链接发送到 Telegram 中的“收藏夹”，然后左键单击它
3. 连接
**手动配置**
1. Telegram → **设置** → **高级设置** → **连接类型** → **代理**
2. 添加代理：
- **类型：** MTProto
- **服务器：** `127.0.0.1`（或您自定义的地址）
- **端口：** `1443`（或您自定义的端口）
- **密钥：** 来自设置或日志
## 工作原理
```
Telegram Desktop → MTProto Proxy (127.0.0.1:1443) → WebSocket → Telegram DC
```
1. 应用程序在 `127.0.0.1:1443` 上启动 MTProto 代理
2. 拦截对 Telegram IP 地址的连接
3. 从 MTProto 混淆初始化数据包中提取 DC ID
4. 通过 Telegram 域名建立到相应 DC 的 WebSocket 连接（TLS）
5. 如果 WS 不可用（302 重定向）— 自动切换到 CfProxy / 直接 TCP 连接
## 自动化构建
项目包含 PyInstaller 规范（[`packaging/windows.spec`](../packaging/windows.spec)、[`packaging/macos.spec`](../packaging/macos.spec)、[`packaging/linux.spec`](../packaging/linux.spec)）和 GitHub Actions 工作流（[`.github/workflows/build.yml`](../.github/workflows/build.yml)）用于自动化构建。
当前二进制文件的最低支持操作系统版本：
- Windows 10+ 用于 `TgWsProxy_windows.exe`
- Windows 7 (x64) 用于 `TgWsProxy_windows_7_64bit.exe`
- Windows 7 (x32) 用于 `TgWsProxy_windows_7_32bit.exe`
- Intel macOS 10.15+
- Apple Silicon macOS 11.0+
- Linux x86_64（系统托盘需要 AppIndicator）
## 贡献者
感谢所有帮助发展此项目的人 ❤️
## 许可证
[MIT 许可证](../LICENSE)
标签：Cloudflare集成, MTProto协议, Nginx配置, Telegram代理, WebSocket技术, 二进制发布, 加密通信, 即时通讯, 开源工具, 本地代理服务器, 流量转发, 漏洞挖掘, 系统托盘, 绕过限制, 网络加速, 网络安全, 网络工具, 跨平台应用, 逆向工具, 隐私保护
