EdgeTunnel

edgetunnel 是一个开源的边缘计算代理工具，基于 Cloudflare Workers/Pages 平台构建。它的主要功能是通过边缘网络处理流量，为用户提供科学上网能力。

本教程将指导你如何在 Fork 了 cmliu/edgetunnel 仓库后，通过 Cloudflare Pages + GitHub 联动 的方式部署属于自己的多功能边缘计算隧道面板。

📌 准备工作

在开始部署之前，请确保你已具备以下条件：

1. GitHub 账号：用于存放 Fork 的项目代码。
2. Cloudflare (CF) 账号：用于托管和运行 Pages 边缘服务。
3. 一个自定义域名：由于 Cloudflare 自带的 pages.dev 域名在国内部分地区可能存在被墙或无法解析的情况，强烈建议准备一个转入 Cloudflare 解析的自定义次级域名（例如 vpn.yourdomain.com）。

🛠 步骤一：Fork 项目仓库

1. 访问 edgetunnel 的官方 GitHub 仓库：https://github.com/cmliu/edgetunnel。
2. 点击页面右上角的 Fork 按钮。
3. 在弹出的页面中，保持默认设置，点击 Create fork。
4. （可选）顺手点一个 Star 🌟 也是对作者的鼓励。

🛠 步骤二：在 Cloudflare 中创建 Pages 项目

1. 登录你的 Cloudflare 控制台。
2. 在左侧导航栏中，依次点击 「Workers 和 Pages」 -> 「概述」。
3. 点击右侧的 「创建」 按钮，然后选择 「Pages」 标签页。
4. 点击 「连接到 Git」 按钮。
5. 选择 GitHub（如果第一次使用，需要按照提示授权 Cloudflare 访问你的 GitHub 账号）。
6. 在仓库列表中找到你刚刚 Fork 的 edgetunnel 仓库，选中它并点击 「开始设置」。

🛠 步骤三：配置环境变量与初次部署

在 「设置构建和部署」 页面，我们需要进行以下配置：

1. 项目名称：保持默认或自定义（该名称会决定你默认的 .pages.dev 网址）。
2. 框架预设：保持默认（无/None）。
3. 配置环境变量（核心步骤）：
   • 展开页面下方的 「环境变量（高级）」。
   • 点击 「添加变量」。
   • 变量名称 填写：ADMIN
   • 值 填写：你的管理员密码（此密码用于后续登录后台面板，请务必记牢）。
4. 完成后，点击页面的 「保存并部署」。
5. Cloudflare 将开始初次构建。等待 1-2 分钟，构建完成后点击 「继续处理站点」。

⚠️ 注意：此时虽然提示部署成功，但由于我们还没有绑定数据库（KV 命名空间），此时访问后台会报错。请继续看下一步。

🛠 步骤四：绑定 KV 命名空间

edgetunnel 需要使用 Cloudflare 的 KV（键值对）存储来保存节点配置。

1. 创建 KV 命名空间

1. 返回 Cloudflare 控制台主页，点击左侧导航栏的 「Workers 和 Pages」 -> 「KV」。
2. 点击右上角的 「创建命名空间」。
3. 命名空间名称可以随意填写（例如：edgetunnel_kv），然后点击 「添加」。

2. 将 Pages 项目与 KV 绑定

1. 回到你的 Pages 项目管理页面。
2. 点击顶部的 「设置」 选项卡。
3. 在左侧菜单中选择 「绑定」。
4. 在页面右侧找到 「KV 命名空间绑定」 区域，点击 「添加绑定」。
5. 变量名称 必须严格填写：KV
6. KV 命名空间 选择你刚刚创建的命名空间（例如 edgetunnel_kv）。
7. 点击 「保存」。

3. 重新部署以使绑定生效

1. 切换到 Pages 项目的 「部署」 选项卡。
2. 在最新的部署记录（通常是第一条）右侧，点击 「三个点 (…)」。
3. 选择 「重试部署」。等待部署重新完成。

🛠 步骤五：绑定自定义域名（关键）

Cloudflare Pages 默认分配的 *.pages.dev 域名由于众所周知的原因，国内连接极不稳定。必须绑定自定义域名才能稳定使用。

1. 在 Pages 项目管理页面，点击 「自定义域」 选项卡。
2. 点击 「设置自定义域」。
3. 输入你的次级域名，例如：lizi.yourdomain.com（切记：请勿直接使用根域名）。
4. 按照 Cloudflare 提示激活该域名：
   • 如果你的域名已经由 Cloudflare 解析，系统会自动帮你添加一条 CNAME 记录，指向 edgetunnel.pages.dev，你只需点击 「激活域」 即可。
   • 如果域名在其他第三方解析商，你需要手动去解析商后台添加一条 CNAME 记录。
5. 等待 SSL 证书生效（通常需要几分钟）。

🎉 步骤六：访问与使用面板

1. 证书生效后，在浏览器中访问：https://你的自定义域名/admin（例如：https://lizi.yourdomain.com/admin）。
2. 输入你在环境变量中设置的 ADMIN 密码，点击登录。
3. 登录成功后，你将进入功能强大的 edgetunnel 2.1 后台管理面板。在面板中，你可以：
   • 自动生成 VLESS / Trojan / Shadowsocks 节点。
   • 获取适配 Clash、Sing-box、Surge、Shadowrocket 等客户端的订阅链接。
   • 配合优选 IP API 或配置 PROXYIP 变量进一步优化网络速度。

💡 进阶技巧：如何同步更新代码？

由于你是通过 GitHub Fork 部署的，当原作者 cmliu 更新代码时，你只需要：

1. 访问你自己的 GitHub edgetunnel 仓库。
2. 如果原作者有更新，GitHub 会提示 This branch is behind cmliu/edgetunnel。
3. 点击 Sync fork -> Update branch。
4. 你的 GitHub 仓库更新后，Cloudflare Pages 会自动触发构建并完成更新部署，全程无需手动干预。