edgetunnel README

The project's README from github.com/cmliu/edgetunnel. As one markdown file: README.md.

🚀 edgetunnel 2.1

后台页面

Stars Forks License Telegram YouTube zread Ask DeepWiki

📖 项目简介

edgetunnel 是一个基于 CF Workers/Pages 平台的边缘计算隧道解密方案。它能够高效地处理网络流量，并提供强大的管理面板和灵活的节点配置能力。

✨ 核心特性

💡 快速部署

[!TIP] 📖 详尽图文教程：edgetunnel 部署指南

[!WARNING] ⚠️ Error 1101问题：视频解析

⚙️ Workers 部署

「 Workers 部署文字教程 」

  1. 部署 CF Worker：

    • 在 CF Worker 控制台中创建一个新的 Worker。
    • 将 worker.js 的内容粘贴到 Worker 编辑器中。
    • 在左侧的 设置选项卡中，选择 变量 > 添加变量。 变量名称填写ADMIN，值则为你的管理员密码，后点击 保存即可。

  2. 绑定 KV 命名空间：

    • 在 绑定选项卡中选择 添加绑定 + > KV 命名空间 > 添加绑定，然后选择一个已有的命名空间或创建一个新的命名空间进行绑定。
    • 变量名称填写KV，然后点击 添加绑定即可。

  3. 给 Workers绑定 自定义域：

    • 在 workers控制台的 触发器选项卡，下方点击 添加自定义域。
    • 填入你已转入 CF 域名解析服务的次级域名，例如:vless.google.com后 点击添加自定义域，等待证书生效即可。

  4. 访问后台：

    • 访问 https://vless.google.com/admin 输入管理员密码即可登录后台。

🛠 Pages 上传 部署方法 最佳推荐!!! 图文教程

「 Pages 上传文件部署文字教程 」

  1. 部署 CF Pages：

    • 下载 main.zip 文件，并点上 Star !!!
    • 在 CF Pages 控制台中选择 上传资产后，为你的项目取名后点击 创建项目，然后上传你下载好的 main.zip 文件后点击 部署站点。
    • 部署完成后点击 继续处理站点 后，选择 设置 > 环境变量 > 制作为生产环境定义变量 > 添加变量。 变量名称填写ADMIN，值则为你的管理员密码，后点击 保存即可。
    • 返回 部署 选项卡，在右下角点击 创建新部署 后，重新上传 main.zip 文件后点击 保存并部署 即可。

  2. 绑定 KV 命名空间：

    • 在 设置选项卡中选择 绑定 > + 添加 > KV 命名空间，然后选择一个已有的命名空间或创建一个新的命名空间进行绑定。
    • 变量名称填写KV，然后点击 保存后重试部署即可。

  3. 给 Pages绑定 CNAME自定义域：视频教程

    • 在 Pages控制台的 自定义域选项卡，下方点击 设置自定义域。
    • 填入你的自定义次级域名，注意不要使用你的根域名，例如： 您分配到的域名是 fuck.cloudns.biz，则添加自定义域填入 lizi.fuck.cloudns.biz即可；
    • 按照 CF 的要求将返回你的域名DNS服务商，添加 该自定义域 lizi的 CNAME记录 edgetunnel.pages.dev 后，点击 激活域即可。

  4. 访问后台：

    • 访问 https://lizi.fuck.cloudns.biz/admin 输入管理员密码即可登录后台。

🛠 Pages + GitHub 部署方法

「 Pages + GitHub 部署文字教程 」

  1. 部署 CF Pages：

    • 在 Github 上先 Fork 本项目，并点上 Star !!!
    • 在 CF Pages 控制台中选择 连接到 Git后，选中 edgetunnel项目后点击 开始设置。
    • 在 设置构建和部署页面下方，选择 环境变量（高级）后并 添加变量 变量名称填写ADMIN，值则为你的管理员密码，后点击 保存并部署即可。

  2. 绑定 KV 命名空间：

    • 在 设置选项卡中选择 绑定 > + 添加 > KV 命名空间，然后选择一个已有的命名空间或创建一个新的命名空间进行绑定。
    • 变量名称填写KV，然后点击 保存后重试部署即可。

  3. 给 Pages绑定 CNAME自定义域：视频教程

    • 在 Pages控制台的 自定义域选项卡，下方点击 设置自定义域。
    • 填入你的自定义次级域名，注意不要使用你的根域名，例如： 您分配到的域名是 fuck.cloudns.biz，则添加自定义域填入 lizi.fuck.cloudns.biz即可；
    • 按照 CF 的要求将返回你的域名DNS服务商，添加 该自定义域 lizi的 CNAME记录 edgetunnel.pages.dev 后，点击 激活域即可。

  4. 访问后台：

    • 访问 https://lizi.fuck.cloudns.biz/admin 输入管理员密码即可登录后台。

🔑 环境变量说明

变量名 必填 示例 详细备注
ADMIN ✅ 123456 后台管理面板登录密码
KEY ❌ CMLiussss 快速订阅路径密钥，访问 /CMLiussss 即可快速获取节点
UUID ❌ 90cd4a77-141a-43c9-991b-08263cfe9c10 强制固定UUID，只支持UUIDv4标准格式
PROXYIP ❌ proxyip.cmliussss.net:443 全局自定义反代 IP
URL ❌ https://cloudflare-error-page-3th.pages.dev 默认主页伪装地址（可填写网页 URL 或 1101）
GO2SOCKS5 ❌ blog.cmliussss.com,*.ip111.cn,*google.com 强制走 SOCKS5 的名单 (* 为全局，域名用逗号分隔)
DEBUG ❌ 1或true 开发者模式，默认关闭调试日志功能（console.log），设置1或true则开启调试日志功能
OFF_LOG ❌ 1或true 默认开启KV日志记录功能，设置1或true则关闭日志记录功能
BEST_SUB ❌ 1或true 默认关闭作为优选订阅生成器的功能，设置1或true则开启该功能
PRELOAD_RACE_DIAL ❌ 1或true 默认关闭作为预加载竞速拨号的功能，设置1或true则开启该功能
TCP_CONCURRENT_DIAL ❌ 2 TCP 并发拨号数，默认值为2；设置后不再根据中国移动网络自动降为单路
PROXY_CONCURRENT_DIAL ❌ 1 反代并发拨号数，默认值为1；数值越高连接速度越快，但 IP 切换也越频繁

🔧 高级实用技巧

如需修改 订阅地址里的TOKEN 和 用于节点验证的UUID ，可通过修改变量

  1. 修改ADMIN或KEY变量的值，可以随机修改 订阅地址里的TOKEN 和 用于节点验证的UUID
  2. 设置UUID变量可以强制固定 订阅地址里的TOKEN 和 用于节点验证的UUID，注意必须是UUIDv4标准格式，否则会导致节点无法使用。

本工具支持通过 PATH路径 动态切换底层代理方案：

💻 客户端适配情况

平台 推荐客户端
Windows v2rayN、Hiddify、FlClash、mihomo-party、Clash Verge Rev、Clashmi、FlyClash、Karing、Bettbox
Android v2rayNG、ClashMetaForAndroid、FlClash、Clashmi、Hiddify、NekoBox、FlyClash、Karing、Bettbox
iOS Surge、Shadowrocket、Stash、Hiddify、Loon、Egern、Clashmi、Karing、Quantumult X
macOS FlClash、mihomo-party、Clash Verge Rev、Surge、Clashmi、Karing、FlyClash
鸿蒙 ClashBox

⭐ 项目热度

Stargazers over time

🙏 特别鸣谢

💖 赞助支持 - 提供云服务器维持订阅转换服务

🛠 开源代码引用

⚠️ 免责声明

  1. 本项目（"edgetunnel"）仅供教育、科学研究及个人安全测试之目的。
  2. 使用者在下载或使用本项目代码时，必须严格遵守所在地区的法律法规。
  3. 作者 cmliu 对任何滥用本项目代码导致的行为或后果均不承担任何责任。
  4. 本项目不对因使用代码引起的任何直接或间接损害负责。
  5. 建议在测试完成后 24 小时内删除本项目相关部署。

如果您觉得项目对您有帮助，请给一个 Star 🌟，这是对我最大的鼓励！

edgetunnel (cmliu/edgetunnel)

Searching Database…

47.7K ·GitHub
Edgetunnel
这是干什么用的?edgetunnel 是一个运行在 Cloudflare Workers 或 Pages 上的代理服务:它从边缘节点提供 VLESS、Trojan 和 Shadowsocks 节点,内置管理面板,还能自动生成订阅。
它是需要安装的应用,还是部署到云端的服务?它运行在云端:你只需把一个 worker.js 脚本部署到 Cloudflare Worker,或者把 main.zip 压缩包上传到 Cloudflare Pages,然后通过网页管理面板进行一切管理。
要把它跑起来需要做哪些事?把 worker.js 粘贴到 Workers 编辑器里完成部署(或者把 main.zip 上传到 Pages),设置一个 ADMIN 变量填入你的密码,绑定一个 KV 命名空间,再绑定自定义域名,然后登录面板即可。
部署之前我需要准备什么?需要一个 Cloudflare 账号,并创建一个用于存放配置和日志的 KV 命名空间;另外还要在 Cloudflare DNS 上有自己的子域名,以便绑定自定义域名——不需要自备服务器。
有什么容易踩的坑吗?如果你固定了 UUID 变量,它必须是标准的 UUIDv4,否则节点会失效;README 里还专门有一篇笔记,讲解部署后如何修复 Error 1101。
我可以在哪些设备上使用它?支持 Windows、Android、iOS、macOS、鸿蒙以及软路由固件;推荐客户端:电脑端有 v2rayN 和 Hiddify,iOS 上有 Shadowrocket 和 Surge,Android 上有 v2rayNG。
许可证或使用条款方面有什么需要注意的?代码采用 GPL-2.0,但免责声明把用途限定为教育、研究和个人安全测试,要求遵守当地法律,并要求你在测试完成后 24 小时内删除部署。
我的设备具体怎么获取节点列表?它内置了订阅系统,可以生成带转换的链接,适配 Clash、Sing-box、Surge 等主流客户端;设置好 KEY 变量后,访问对应的路径(例如 /CMLiussss)就能拿到节点。
可以通过我自己的上游代理进行链式转发吗?可以——你可以设置全局 ProxyIP,使用 SOCKS5/HTTP 链式代理(还能通过 GO2SOCKS5 域名列表强制指定流量走 SOCKS5),按 URL 路径切换协议,并调整并发拨号数。
这是原版的 edgetunnel 吗?不是——这是一个继续维护 zizifn/edgetunnel 的分支项目,同时也致谢了 EDtunnel、cloudflare-worker-vless-ip 以及它所借鉴的其他开源项目。
What are similar projects?BPB-Worker-Panel, clash, Open-Box, Cloudflare-vless-trojan, panda-vpn-pro, CFNext, v2rayfree, Xray-core
Which topics is it in?cloudflare-pages, surge, subscription, admin-panel, sing-box, xray, proxy-server, mihomo, vmess, vless, clash, trojan
Creator
cmliu
Size
23 MB
Stars
47.7K
Updated
CommitOct 08
Age
2y
Commits · 90 Days