CF-Workers-TGProxy 简单来说,这是一个让你“不用开梯子/VPN软件”,也“不用自己掏钱买服务器”,就能直接在手机和电脑上正常使用 Telegram(电报)的开源工具。
项目地址(去给大佬点个Star):https://github.com/ToiCF/CF-Workers-TGProxy
以前怎么用 Telegram?
在网络受限环境下,以前使用 Telegram 通常有两种方式:
- 方式 A(外挂梯子): 手机/电脑后台必须常驻一个 VPN 或代理软件(如 Clash、v2ray 等),耗电、占后台,而且关掉软件电报就断连。
- 方式 B(应用内内置代理): 在电报里填 MTProto 或 Socks5 代理。虽然不用开 VPN 了,但通常需要你自己每个月花钱买一台境外云服务器(VPS)来搭建,或者蹭别人公开的代理(很不稳定,还容易失效)。
CF-Workers-TGProxy 做了什么?
Telegram 最近支持了一种新的代理协议叫 WebProxy(网页级代理)。而这个项目的作者写了一段代码,把代理服务端架设到了 Cloudflare Workers 上。
相当于:
- 你不需要买服务器: Cloudflare(全球最大的网络加速服务商,常被戏称为“赛博菩萨”)提供免费的轻量代码托管平台(Cloudflare Workers),你把项目代码粘上去就能永久免费运行。
- 搭好后变成一个链接: 部署好后会生成一个类似
https://t.me/webproxy?server=...的专属链接。你把它发给任何人,对方点一下,电报就自动配置好代理并连上网了。
为什么大家觉得它很厉害?
- 彻底白嫖(零成本): 以前自建代理每年至少花几十甚至几百块买云服务器,现在完全依靠 Cloudflare 的免费额度,一分钱不花。
- 免后台挂梯(纯净体验): 你的手机只要连着普通网络,打开 Telegram 就能像微信一样直接收发消息、传图片和大文件,后台不需要挂任何辅助软件。
- 抗封锁能力较好: 流量伪装成了普通的网站网页流量(走 Cloudflare 的 CDN 网络),比起传统的代理协议更不容易被墙精准阻断;如果连不上,还可以通过绑定自己的域名、挑选更快的节点(优选 IP)来提速。
有什么局限或需要注意的?
- 客户端版本要求: 目前安卓端和电脑桌面端的较新版本已经支持该协议,但 iOS(苹果手机)端还在测试阶段,部分普通苹果用户可能还需要等待官方 App 更新。
- 需要一个小门槛: 虽然不用买服务器,但因为 Cloudflare 自带的免费域名在国内很多地区被墙,所以文案建议自己买一个几块钱的便宜域名绑定进去,才能实现稳定“直连”。
- 额度限制: Cloudflare 免费版每天有 10 万次请求额度,个人日常聊天、看频道绝对够用,但如果用来狂刷海量超大视频,可能会跑满免费额度。
🚀 零基础教程:手把手教你搭建 Telegram 专属免翻代理 CF-Workers-TGProxy
准备工作
- 一个 Cloudflare 账号(全球最大的免费 CDN 平台,官网注册,免费版即可)。
- 一个自己的域名(可选但强烈推荐:由于 Cloudflare 自带的
workers.dev免费域名在国内被墙,建议准备一个托管在 Cloudflare 上的域名,哪怕是几块钱一年的便宜域名)。 - 最新版 Telegram 客户端(电脑端、安卓端请升级到最新版;iOS 用户如提示协议不支持,需等待官方版本更新或加入测试版)。
第一步:准备两个“密码”(密钥)
这个项目需要两个环境变量:SECRET 和 BOOT。为了小白操作方便,不需要在电脑终端敲命令,直接用在线工具或浏览器生成:
- 生成
SECRET(必须是 32 位的小写字母和数字):- 打开任意在线随机字符生成器(如生成 16 字节的 Hex/十六进制字符串),或者打开浏览器按
F12打开控制台(Console),粘贴回车运行这行代码:Array.from(crypto.getRandomValues(new Uint8Array(16))).map(b => b.toString(16).padStart(2, '0')).join('') - 你会得到一串类似
a8f5c378e9b0429f9e1234567890abcd的 32 位字符,复制并保存好。
- 打开任意在线随机字符生成器(如生成 16 字节的 Hex/十六进制字符串),或者打开浏览器按
- 生成
BOOT(16 位以上的任意随机字符串):- 随便打一串复杂且大于 16 位的字符,或者再次用上面的方式生成一串备用,复制并保存好。
第二步:创建 Cloudflare Worker
- 登录 Cloudflare 控制台。
- 在左侧菜单栏点击 “Workers 和 Pages”(Workers & Pages) ➔ 点击 “创建”(Create Application) ➔ 选择 “创建 Worker”。
- 随意起一个名字(比如
tg-proxy),点击右下角 “部署”(Deploy)。 - 部署完成后,点击页面上的 “编辑代码”(Edit code)。
第三步:填入项目代码
- 打开项目的 GitHub 代码文件:telegram_webproxy.js 源码地址。
- 把网页里的全部代码完整复制下来。
- 回到刚才 Cloudflare Worker 的代码编辑页面,清空左侧原有的示例代码,将复制的代码粘贴进去。
- 点击右上角的 “保存并部署”(Save and deploy)。
第四步:配置环境变量
代码部署好后,还需要把第一步准备的两个密码绑定进去,否则服务无法启动:
- 点击左上角的箭头返回到当前 Worker 的管理主页。
- 切换到顶部的 “设置”(Settings)选项卡。
- 在左侧子菜单找到 “变量和密钥”(Variables and Secrets)。
- 点击 “添加”(Add)环境变量,依次添加两条:
- 变量名:
SECRET
值: 粘贴你在第一步生成的 32 位字符串 - 变量名:
BOOT
值: 粘贴你在第一步生成的 16 位以上随机字符串
- 变量名:
- 添加完成后,点击 “保存并部署”。
第五步:绑定自定义域名(国内直连的关键)
⚠️ 为什么一定要这一步?
Cloudflare 默认分配的xxx.workers.dev域名国内大多无法直接访问。绑定自定义域名才能实现“不挂梯子直接连”。
- 依然在当前 Worker 的 “设置”(Settings)页面。
- 找到 “域和路由”(Domains & Routes)。
- 点击 “添加” ➔ 选择 “自定义域”(Custom Domain)。
- 输入你的二级域名(例如你的根域名是
abc.com,这里可以输入tg.abc.com),点击绑定。 - 等待 1~2 分钟,状态显示为绿色的“有效(Active)”即可。
第六步:生成连接并一键开启 Telegram
根据你绑定的域名和生成的 SECRET,拼接出你的专属代理链接:
https://t.me/webproxy?server=你的自定义域名&secret=你的SECRET
示例:
https://t.me/webproxy?server=tg.abc.com&secret=a8f5c378e9b0429f9e1234567890abcd
连接方法:
- 把拼好的这行链接发给自己的任意聊天框(或者直接在电脑/手机浏览器中打开)。
- 点击链接,会自动唤起 Telegram 客户端,弹窗提示你 “启用代理”(Enable Proxy)。
- 点击开启后,无需再挂后台翻墙软件,Telegram 就能直接收发消息、加载图片视频了!
💡 常见问题与避坑指南
- 为什么访问或测试返回 500 错误?
- 检查第四步的
SECRET和BOOT变量名大小写是否写错,或者有没有漏填;只要缺少任意一个就会直接报 500。
- 检查第四步的
- 连接一直转圈连不上?
- 检查手机/电脑网络是否能 ping 通你的自定义域名。如果当地运营商对 Cloudflare 节点有干扰,可在域名解析处配合“优选 IP(Cloudflare SaaS)”来提速。
- iPhone(iOS)为什么点开没反应?
- iOS 端的 Telegram 官方正式版对 WebProxy 协议的适配仍在推进中,苹果手机建议使用最新版或等待下个大版本更新推送。
- 不要把专属链接公开给太多人:
- Cloudflare 免费版账号每天有 10 万次 请求额度,自己和家人日常使用完全绰绰有余;但如果公开给万人大群使用,额度可能会很快耗尽。
评论 0 条
暂无评论,来种下第一颗种子。