Edgechat：0服务器成本！基于 Cloudflare Workers 的开源自托管聊天系统（Telegram 双向桥接 / 加密通信）

一、 这个项目到底是干什么的？（一分钟大白话看懂）

很多极客团队、初创小圈子或者家庭成员，都想拥有一个完全属于自己掌控的独立私密聊天室。然而，以往要搭建一个像 Slack、Discord 或微信那样的聊天服务，过程极其劝退：你不仅要每个月掏钱租一台 Linux 云服务器，还得折腾 MySQL 数据库、配置 Nginx 反代证书、搭建 WebSocket 常驻服务，一旦服务器欠费断网，整个聊天室就彻底瘫痪了。

Edgechat 彻底颠覆了传统的自建聊天模式！用通俗大白话来说：它让你不用购买和维护任何一台云服务器，完全白嫖借助 Cloudflare 的全球边缘算力，0 成本跑起一整套现代化的团队聊天系统！

它的所有数据（文字、语音、图片、大文件）全都保存在你自己的 Cloudflare 账号里（利用 Cloudflare 免费赠送的 Workers 边缘无服务器、D1 分布式数据库、KV 缓存与 R2 免费存储）。更绝的是，它原生支持与 Telegram（电报）群组双向绑定互通！即使你的朋友习惯在 Telegram 上聊天，只要在电报群里发消息，Edgechat 网页端就能实时收到；你在网页端回复，电报群也会同步呈现，两端无缝对话！

二、 为什么它能爆火？核心亮点与小白实用价值

• 💡 真正的零服务器运维（Serverless）：不需要装 Linux 系统，不需要配置 Docker，直接部署在 Cloudflare 全球 300+ 边缘机房节点上，自带免费抗 DDoS 与高防 HTTPS 加密，网站永久不宕机；
• ✈️ 原生打通 Telegram 双向桥接：群组一键关联 Telegram Bot，文字、高清表情包、图片、视频、语音全链路实时双向互传，且消息自带清晰的 TG 来源标记；
• 🔐 工业级端到端与服务端加密（AES-256-GCM）：每一条发送的新消息与上传的私密附件均经过强加密入库，管理员后台绝不提供任何窥探聊天正文的入口，把真正的隐私牢牢锁进产品骨子里；
• 🎙️ 现代全能交互体验：支持语音消息波形进度条与倍速播放、一对一 P2P 语音通话、Markdown 富文本排版，甚至原生集成了 WebMCP 接口，支持将 Claude、ChatGPT 或本地 AI 智能体直接拉进群当机器人聊天助攻！

三、 零基础小白保姆级极速上手（手把手实操指南）

按照下面的 4 个步骤操作，利用 GitHub Actions 即可实现 5 分钟全自动零代码部署：

1. 第一步：Fork 官方代码仓库到自己账号

   登录你的 GitHub 账号，访问官方仓库：https://github.com/aozorae/Edgechat，点击页面右上角的 Fork 按钮，将代码克隆一份到你的个人账号下。

2. 第二步：准备免费的 Cloudflare 凭证

   登录你的 Cloudflare 控制台，在右侧获取你的 Account ID（账号 ID）；接着在“我的个人资料 ➔ API 令牌”中创建一个具备 Workers/D1/KV/R2 编辑权限的 API Token。

3. 第三步：在 GitHub 仓库中配置机密变量

   回到你刚才 Fork 的 GitHub 仓库页面，点击 Settings ➔ Secrets and variables ➔ Actions，点击 New repository secret：

   • 添加 CLOUDFLARE_ACCOUNT_ID：填入你的 Cloudflare 账号 ID；
   • 添加 CLOUDFLARE_API_TOKEN：填入刚才生成的 API 令牌。
4. 第四步：一键触发 GitHub Actions 自动化部署

   点击仓库顶部的 Actions 标签页，点击左侧的 Deploy 工作流并点击 Run workflow。GitHub 会自动为你创建 D1 数据库、配置 R2 存储桶并将前端 Vue 界面打包推送到你的 Cloudflare Worker。部署成功后，你就会获得一个全球直连秒开的聊天专属网址（例如 https://my-edgechat.workers.dev），打开即可使用管理员初始建号并邀请好友畅聊！

四、 小白常见踩坑排错清单（避坑必读）

• ⚠️ 常见问题 1：部署后打开网页提示 D1 Database not found？
  ➔ 这是因为首次运行自动化工作流时 D1 数据库尚未完成建表。只需进入 Cloudflare 控制台的 Workers & Pages 页面，确认 D1 绑定名称是否与 wrangler.toml 一致，或者在 GitHub Actions 中重新点击一次“Re-run all jobs”即可自动修复。
• ⚠️ 常见问题 2：Telegram 消息无法同步到网页端？
  ➔ 检查你的 Telegram Bot Token 是否配置正确，以及是否在群设置中将 Bot 设置为了“管理员（Admin）”并给予了读取消息权限（Privacy Mode 需关闭）。
• ⚠️ 常见问题 3：免费版配额够不够日常使用？
  ➔ 完全绰绰有余！Cloudflare Workers 免费计划每天提供 100,000 次免费请求，D1 数据库每天提供 500 万次行读取，R2 存储提供 10GB 免费空间。对于小团队或私人圈子使用，根本用不完免费额度，真正做到长年 0 元稳定运转！