edgetunnel 是一个基于 CF Workers/Pages 平台的边缘计算隧道解密方案。它能够高效地处理网络流量,并提供强大的管理面板和灵活的节点配置能力。
在 Cloudflare 的 Workers & Pages 页面选择 Continue with GitHub(即“连接到 Git”)是官方支持的标准部署方式之一。这种方式能实现自动化部署,GitHub 仓库的每次更新,Cloudflare 都会自动同步。
GitHub 集成部署流程
1. 在 GitHub 上 Fork 项目
首先,登录 GitHub 账号,访问项目地址,点击右上角的 Fork 按钮,将项目复制到自己的账号下。
2. 在 Cloudflare 连接仓库
- 登录 Cloudflare 控制台,进入 Workers & Pages。
- 点击 创建应用程序 → Pages → 连接到 Git。
- 授权 Cloudflare 访问 GitHub 账号,然后从列表中选择刚才 Fork 的
edgetunnel仓库,点击 开始设置。
3. 配置构建与部署
在“设置构建和部署”页面,按以下要求配置:
- 项目名称:自定义一个名称。
- 生产分支:保留默认的
main分支。 - 构建命令:留空(项目无需构建步骤)。
- 构建输出目录:留空。
- 环境变量(高级):点击展开,添加变量名
ADMIN,值为管理员密码,然后点击 保存并部署。
🔧 部署后的关键配置
首次部署完成后,还需要进行两项关键配置才能使服务正常运行:
1. 绑定 KV 命名空间
这是必需步骤,用于持久化存储配置。
- 进入项目的 设置 → 绑定 → 添加 → KV 命名空间。
- 变量名称必须填写
KV(区分大小写)。 - KV 命名空间选择“创建新的命名空间”,创建一个后选中并保存。
2. 重新部署使配置生效
完成 KV 绑定后,回到项目的 部署 页面,点击 创建新部署。可以选择“重新部署”或“重试部署”,使新的绑定和变量生效。
注意事项与常见问题
- 自动同步更新:项目内置了
sync.yml工作流,Fork 的仓库会每日自动同步上游cmliu/edgetunnel的更新。配合 Cloudflare 的自动部署,服务能始终保持最新。 - 部署失败或无限循环:如果连接 GitHub 时卡住或反复跳转,可以尝试到 GitHub 的 Settings → Applications 中找到 Cloudflare Pages,先卸载再重新授权。
- 环境变量不生效:在 Pages 中修改环境变量后,必须重新部署才能生效。确保在“生产环境”下添加了
ADMIN变量。

Comments NOTHING