Release 下载cmliu/edgetunnel · GitHub Release 历史版本 · 三路反代镜像
本区块同步 cmliu/edgetunnel 的官方 GitHub Release，并为最近版本生成 三路反代镜像加速下载通道。 默认展开最新正式版；如果项目只有预发布版，会在版本旁单独标注。下载按钮会先进入本站确认页，可继续下载或复制真实链接。
暂无公开 Release 资产，请到 cmliu/edgetunnel Releases 页 查看后续发布。
edgetunnel 的价值不是“永久免费主力线路”，而是让你用很低成本验证一套 VLESS 客户端配置。下面按 Worker 部署、vless 链接、客户端导入和常见错误排查走一遍。
edgetunnel 适合你吗？先看这张表
| 使用场景 | 更适合 edgetunnel | 更适合 VPS |
|---|---|---|
| 临时测试 VLESS 客户端 | 是 | 不必先买 |
| 日常主力、大流量 | 不建议 | 是 |
| 需要 UDP | 不支持 | 看协议和服务端配置 |
| 想学习 Workers 代码 | 是 | 不是重点 |
| 想用 Reality / Hysteria 2 / TUIC | 不适合 | 是 |
edgetunnel 是”跑通”的工具。验证 v2rayN、v2rayNG、Clash Verge Rev、Mihomo Party 这些客户端能不能正确识别 VLESS WS，它很好用；长期跑大流量，就不该只看部署成本。
和 VPS 部署 VLESS Reality 差在哪里？
| 维度 | edgetunnel（Cloudflare Workers） | VPS（如 mack-a 脚本部署 Reality） |
|---|---|---|
| 成本 | 可从免费档开始 | 通常 3-10 美元/月 |
| 部署时间 | 约 5-10 分钟 | 约 30 分钟起 |
| 流量限制 | 受请求次数、CPU 时间和平台规则影响 | 受 VPS 带宽与服务商策略影响 |
| 协议 | VLESS over WebSocket | VLESS Reality / Vision / Hysteria 2 / TUIC 等 |
| UDP | 不支持 | 取决于协议和服务器配置 |
| IP 形态 | Cloudflare Anycast 入口 | VPS 独立 IP |
| 维护重点 | Worker 代码、UUID、host/sni | 系统、证书、内核、脚本更新 |
如果你只是要一个备用入口，Workers 足够轻。若你要长期主力线路、多个设备同时跑，VPS 或托管订阅通常更省心。
Cloudflare Workers 怎么部署 edgetunnel？
1. 创建 Worker
打开 dash.cloudflare.com，进入 Workers & Pages，选择 Create，再用 Hello World template 创建一个 Worker。名称可以先用 my-vless 这类容易识别的短名。
2. 复制 edgetunnel 代码
从 github.com/cmliu/edgetunnel 复制 _worker.js 内容。不要只复制片段，Worker 编辑器里需要用它替换默认示例代码。
3. 生成 UUID
macOS / Linux 可以直接运行：
uuidgen也可以用可信的 UUID 生成工具。UUID 是客户端鉴权用的标识，不要把别人文章里的示例 UUID 原样粘进去。
4. 修改 userID
在 _worker.js 顶部找到类似这一行：
let userID = '00000000-0000-0000-0000-000000000000';把引号里的内容换成你刚生成的 UUID。只改 UUID，不要顺手改其他变量；第一次部署先把变量保持简单，出错时更容易定位。
5. Save and Deploy
进入刚创建的 Worker，点 Edit code，粘贴修改后的 _worker.js，再点 Save and Deploy。部署成功后，Cloudflare 会给你一个 workers.dev 域名。
6. 打开配置页
浏览器访问：
https://my-vless.your-account.workers.dev/your-uuid页面能返回 vless 链接，说明 Worker 代码和 UUID 至少已经跑通。复制这条链接，再导入代理客户端。
vless 链接里哪些字段最容易填错？
一个常见链接长这样：
vless://[email protected]:443?encryption=none&security=tls&sni=my-vless.workers.dev&type=ws&host=my-vless.workers.dev&path=%2F#workers-vless重点看 5 个字段：
| 字段 | 应该填什么 | 常见错误 |
|---|---|---|
| UUID | Worker 代码里的 userID | 客户端和 Worker 不一致 |
| address | workers.dev 域名或优选 IP | 域名拼错、协议头没删 |
| port | 443 | 写成 80 后仍开 TLS |
| host | Worker 域名 | 填成优选 IP |
| sni | Worker 域名 | 留空或填成别的域名 |
| path | / 或项目生成的路径 | 漏掉斜杠 |
如果你用 CloudflareSpeedTest 找到优选 IP，address 可以换成 IP，但 host 和 sni 仍然保留 Worker 域名。
哪些客户端可以直接导入？
把 vless 链接复制到这些客户端的“从剪贴板导入”或“添加分享链接”里：
Clash / Mihomo 系客户端不一定都能直接吃单条 vless 分享链接。如果导入后节点为空，确认客户端是否要求 Clash YAML 订阅格式，而不是继续改 Worker 代码。
速度慢时要不要用 CloudflareSpeedTest？
默认 workers.dev 域名会命中 Cloudflare 接入点，但不同网络环境下结果差异很大。你可以用 CloudflareSpeedTest 先测 443 端口：
./CloudflareST -tl 100 -tp 443拿到 result.csv 里表现较好的 IP 后，把 vless 链接里的 address 换成该 IP：
vless://[email protected]:443?encryption=none&security=tls&sni=my-vless.workers.dev&type=ws&host=my-vless.workers.dev&path=%2F注意：address 可以是 IP，host / sni 仍然必须是 Worker 域名。很多“优选后反而连不上”的问题，就是把三处一起改成 IP 导致 TLS 校验失败。
自定义域名、多 UUID、反代 VPS 怎么处理？
自定义域名
把自己的域名 CNAME 到 Worker 域名：
nodes.example.com CNAME my-vless.workers.dev然后在 Cloudflare Workers Routes 里把 nodes.example.com/* 绑定到对应 Worker。客户端 address、host、sni 都可以改成这个自定义域名，后续迁移 Worker 时也更好管理。
多 UUID
cmliu 版本支持把 userID 写成数组：
let userID = [
'uuid-1-here',
'uuid-2-here',
'uuid-3-here'
];每个 UUID 对应一套客户端链接。多人或多设备使用时，建议一人一个 UUID；某个设备出错时，可以直接看它对应的配置。
反代 VPS
部分版本的 Worker 代码可以配置 proxyIP：
let proxyIP = 'your-vps-ip';这种玩法是让 Worker 转发到后端 VPS。它比纯 Workers 多一层依赖，第一次部署不建议同时打开，确认纯 Workers 链路能通，再加反代变量。
常见报错先按什么顺序查？
| 表现 | 更可能的原因 | 检查 |
|---|---|---|
| 访问配置页 404 | URL 后面的 UUID 不对 | 浏览器地址和 userID 是否一致 |
| 客户端导入后节点为空 | 客户端不支持单条链接或格式不兼容 | 换支持 VLESS 分享链接的客户端测试 |
| 连接时报 TLS / handshake 错误 | host 或 sni 错 | host/sni 是否仍为 Worker 域名 |
| 偶尔出现 1101 / 1102 | Worker 代码异常或 CPU 时间触发限制 | Cloudflare Worker 日志和最近改动 |
| 能连但速度慢 | 接入点质量差或线路拥塞 | 先测 CloudflareSpeedTest，再改 address |
排错时一次只改一项，用浏览器确认配置页可访问，再用 v2rayN 或 v2rayNG 这类直接支持 vless 链接的客户端测试，最后再迁移到 Clash / Mihomo 配置。
什么时候该换成配套订阅？
edgetunnel 的痛点通常不是“部署不了”，而是后面维护琐碎：Workers 配额、UUID 管理、host/sni、优选 IP、客户端格式，每一项都可能在不同设备上出错。
如果你已经有 3 台以上设备、需要给家人或同事导入，或者不想每次客户端升级后重新排查格式，可以把自建 Workers 留作备用，把配套订阅线路放在主力客户端里承载日常使用。
| 场景 | 建议 |
|---|---|
| 学习 VLESS WS 和 Workers | 用 edgetunnel |
| 临时备用 | 用 edgetunnel |
| 多设备长期使用 | 用托管订阅或 VPS |
| 不想维护 Worker 代码 | 用托管订阅 |
| 想完全掌控服务端 | 用 VPS |
如何确认已经部署成功？
按这 4 个信号判断：
- 浏览器访问
https://worker-domain/uuid能看到配置页。 - v2rayN 或 v2rayNG 导入后能显示 VLESS 节点。
- 客户端日志里没有 UUID mismatch、TLS handshake、WebSocket path 相关错误。
- 换网络环境测试时，host 和 sni 不需要反复修改。
满足前 3 条，说明 edgetunnel 本身已经跑通。第 4 条不稳定时，优先看 Cloudflare 接入点和客户端格式，不要急着重建 Worker。