type
status
date
slug
summary
tags
category
icon
password
菜单级别
Place
Verification
Owner
EdgeTunnel 是一个基于 Cloudflare Worker 的轻量级代理工具,通过简单的配置即可快速部署使用。本文将详细介绍完整的部署和配置流程。
前置准备
在开始部署之前,请确保你已经:
- 拥有一个 Cloudflare 账号
- 已将域名转入 Cloudflare 进行 DNS 解析(如需绑定自定义域名)
- 准备好 worker.js 文件内容
部署步骤
1. 部署 CF Worker
首先需要在 Cloudflare 控制台创建并配置 Worker:
创建 Worker
- 登录 Cloudflare 控制台
- 进入 Workers & Pages 页面
- 点击「创建应用程序」或「创建 Worker」
- 为你的 Worker 命名(例如:edgetunnel)
配置 Worker 代码
- 在 Worker 编辑器中,将 worker.js 的完整内容粘贴进去
- 点击右上角「保存并部署」按钮
设置环境变量
- 在 Worker 详情页面,点击左侧「设置」选项卡
- 选择「变量」部分
- 点击「添加变量」按钮
- 变量名称:填写
ADMIN
- 值:设置你的管理员密码(请使用强密码)
- 点击「保存」完成配置
2. 绑定 KV 命名空间
KV 命名空间用于存储 Worker 的持久化数据:
创建或选择 KV 命名空间
- 在 Worker 设置页面,找到「绑定」选项卡
- 点击「添加绑定」按钮,选择「KV 命名空间」
- 如果还没有 KV 命名空间,可以点击「创建新命名空间」创建一个
- 如果已有命名空间,直接从下拉列表中选择
配置绑定
- 变量名称:必须填写
KV(大写)
- 选择对应的 KV 命名空间
- 点击「添加绑定」完成配置
3. 绑定自定义域名
为了更好的访问体验,建议绑定自定义域名:
添加自定义域名
- 在 Worker 控制台中,找到「触发器」选项卡
- 向下滚动到「自定义域」部分
- 点击「添加自定义域」按钮
配置域名
- 填入你已转入 Cloudflare 的次级域名
- 点击「添加自定义域」
- 等待 SSL 证书自动签发和生效(通常需要几分钟)
💡 新手提示:如果你是小白用户,完成到这一步就可以直接使用了!后续的高级配置可以根据需要再进行调整。
4. 访问管理后台
部署完成后,即可访问管理后台:
- 访问你配置的自定义域名,例如:
worker.yourdomain.com/admin
- 在登录页面输入你之前设置的 ADMIN 管理员密码
- 成功登录后即可进入后台管理界面
常见问题
Worker 部署失败怎么办?
- 检查 worker.js 代码是否完整复制
- 确认代码中没有语法错误
- 查看 Cloudflare 控制台的错误提示信息
KV 绑定后无法使用?
- 确认变量名称是否为大写的
KV
- 检查 KV 命名空间是否创建成功
- 尝试重新部署 Worker
自定义域名证书一直不生效?
- 确认域名已正确解析到 Cloudflare
- 检查域名的 DNS 记录是否正确
- 通常需要等待 5-15 分钟,耐心等待即可
无法登录管理后台?
- 确认 ADMIN 变量已正确设置
- 检查密码输入是否正确
- 尝试清除浏览器缓存后重试
安全建议
- 使用强密码作为管理员密码,建议包含大小写字母、数字和特殊字符
- 定期更换管理员密码
- 如果不需要公开访问,可以考虑添加 IP 白名单限制
- 定期检查 Worker 的访问日志,确保没有异常访问
总结
通过以上步骤,你已经成功部署了 EdgeTunnel Cloudflare Worker。整个过程包括:
- ✅ 创建并配置 Worker
- ✅ 设置管理员密码
- ✅ 绑定 KV 命名空间
- ✅ 配置自定义域名
- ✅ 访问管理后台
现在你可以开始使用 EdgeTunnel 的各项功能了。如果在使用过程中遇到问题,可以参考项目的 GitHub 页面获取更多帮助信息。
附录:worker.js 完整代码
EdgeTunnel 的核心代码文件 worker.js 包含了完整的 Worker 逻辑实现。你可以从项目的 GitHub 仓库获取最新版本的代码。
代码说明
worker.js 文件实现了以下核心功能:
基础功能
- WebSocket 连接处理和数据转发
- VLESS 协议支持
- Trojan 协议支持
- 自动 HTTP 到 HTTPS 重定向
高级特性
- SOCKS5 代理支持
- HTTP 代理支持
- 反向代理 IP 配置
- 优选 IP 订阅生成
- 订阅转换支持
- TLS 分片功能
管理功能
- 基于 Cookie 的身份验证
- KV 存储配置管理
- 访问日志记录
- Telegram 通知推送
- Cloudflare 用量统计
安全特性
- MD5 双重加密
- 证书验证选项
- 访问控制
- 白名单机制
获取代码
访问 GitHub 项目页面,在代码仓库中找到
worker.js 文件,复制完整内容即可用于部署。项目持续更新中,建议定期查看仓库获取最新版本和功能改进。
- 作者:Orz
- 链接:https://blog.1567890.xyz/technology/edgetunnel-cloudflare-worker-guide
- 声明:本文采用 CC BY-NC-SA 4.0 许可协议,转载请注明出处。

