EdgeTunnel 部署指导

Leawsic 发布于 10 小时前 2 次阅读


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 变量。
江畔何人初见月?江月何年初照人?灯火葳蕤处……
最后更新于 2026-09-12