字节笔记本
2026年5月25日
edgetunnel：基于 Cloudflare Workers 的开源隧道解密管理面板
本文介绍 edgetunnel，一个基于 Cloudflare Workers/Pages 平台的边缘计算隧道解密方案。它内置可视化后台管理面板，支持 VLESS、Trojan、Shadowsocks 等主流代理协议，帮助用户快速搭建和管理自己的网络隧道节点。
项目简介
edgetunnel 是一个开源的 CF Workers/Pages 边缘隧道工具，由 cmliu 开发维护。截至目前，该项目在 GitHub 上已获得 35.5k Stars，拥有 32.5k Forks，使用 JavaScript 编写，基于 GPL-2.0 许可证开源。
该工具基于 Cloudflare 的边缘计算平台，将 Workers/Pages 作为隧道入口，实现高效加密传输。内置管理面板让用户可以实时查看节点状态、修改配置、查看流量统计，无需额外搭建后端服务。
核心特性
- 多协议支持：支持 VLESS、Trojan、Shadowsocks 等主流代理协议，深度集成加密传输。
- 可视化管理面板：内置功能完整的后台管理页面，支持实时配置修改、日志查看及流量统计。
- 灵活部署：完整适配 CF Workers 及 CF Pages 两种部署方式，支持 GitHub 自动部署和 ZIP 上传部署。
- 智能订阅系统：内置自动订阅地址生成及混淆转换，兼容 Clash、Sing-box、Surge 等主流客户端。
- 性能加速：支持自定义 ProxyIP、SOCKS5/HTTP 链式代理及优选 API，有效优化网络延迟。
- 全平台兼容：完美适配 Windows、Android、iOS、MacOS 及各类软路由固件。
技术栈
| 技术 | 用途 |
|---|---|
| Cloudflare Workers | 边缘计算执行环境 |
| Cloudflare Pages | 静态站点部署 |
| Cloudflare KV | 配置与数据持久化存储 |
| JavaScript | 主要开发语言 |
| VLESS / Trojan / Shadowsocks | 代理协议支持 |
部署方式
edgetunnel 提供三种部署方式，用户可根据需求选择：
Workers 部署
在 CF Worker 控制台创建新 Worker，将 _worker.js 内容粘贴到编辑器，添加 ADMIN 环境变量设置管理密码，绑定 KV 命名空间，配置自定义域名即可使用。
Pages 上传部署（推荐）
下载项目 ZIP 包，在 CF Pages 控制台上传部署，设置 ADMIN 环境变量，绑定 KV 命名空间，绑定自定义域名后即可通过 /admin 路径访问后台。
Pages + GitHub 部署
Fork 项目后连接 CF Pages 到 GitHub 仓库，设置环境变量并绑定 KV，配置自定义域名即可自动部署。
环境变量配置
| 变量名 | 必填 | 说明 |
|---|---|---|
| ADMIN | ✅ | 后台管理面板登录密码 |
| KEY | ❌ | 快速订阅路径密钥 |
| UUID | ❌ | 强制固定 UUID（UUIDv4 格式） |
| PROXYIP | ❌ | 全局自定义反代 IP |
| GO2SOCKS5 | ❌ | 强制走 SOCKS5 的域名名单 |
使用示例
基础使用
部署完成后访问 https://你的域名/admin，输入管理员密码即可进入后台管理面板，查看节点状态和连接信息。
动态切换代理方案
edgetunnel 支持通过 URL 路径动态切换底层代理方案：
# 指定 PROXYIP
/proxyip=proxyip.example.com
# 指定 SOCKS5
/socks5=user:password@127.0.0.1:1080
# 指定 HTTP 代理
/http=user:password@127.0.0.1:1080订阅地址管理
通过 KEY 变量配置快速订阅路径，访问 https://你的域名/KEY 即可快速获取节点配置，自动转换为适配 Clash、Sing-box、Surge 等客户端的订阅格式。
项目链接
- GitHub 仓库：cmliu/edgetunnel
- 在线演示：https://EDT-Pages.github.io/admin
- 部署教程：edgetunnel 部署指南