自己的聊天空间，不必从维护服务器开始。
基于 Cloudflare 的开源自部署团队聊天系统
实时群聊与私信 · Telegram 双向桥接 · 语音与文件 · 消息与附件服务端加密
EdgeChat 是一个运行在 Cloudflare 上的开源团队聊天系统。 你可以用它为团队、项目或小圈子搭建一个独立的聊天空间：讨论放进群组，私事留给私信，语音和文件也能随手分享。
它不需要你另外维护一台常驻服务器。应用与数据资源部署在你自己的 Cloudflare 账号下，通过 GitHub Actions 自动部署和更新。如果成员已经在使用 Telegram，也可以把两侧群组连接起来，继续使用各自习惯的聊天入口。
界面预览 · 在线演示 · Telegram 桥接 · 功能特性 · 隐私与加密 · 部署 · 本地开发
界面预览
| 聊天界面 | 管理后台 |
 |  |
在线演示
先看看界面，再决定是否部署。
演示站复用正式项目的 Vue 页面、路由、状态管理和实时消息逻辑，但 API、WebSocket、文件上传与 Telegram 回流均在浏览器内存中模拟，不是连接真实后端的多人聊天室。
刷新页面或点击右上角「重置演示数据」即可恢复初始状态。演示操作不会访问正式 Worker，也不会写入 D1、KV 或 R2。
|
✈️ Telegram 双向桥接 群组一键绑定 Telegram 群，文字、图片、视频、语音、文件双向同步。Telegram 成员无需注册账号，消息带 TG 来源标识。
|
🌐 跨实例群组互联 两个独立部署的 EdgeChat 站点可绑定同一个群，新消息双向同步。邀请码一次性、10 分钟有效，双方管理员确认后生效。 |
|
🤖 WebMCP 站点工具 兼容的 AI 客户端可直接登录站点、查询会话、读取和发送消息，让 AI 助手成为聊天室的一等公民。 |
🎙️ 语音沟通 语音消息支持录制、波形进度与倍速播放；私信支持一对一语音通话，默认 P2P 直连，失败时自动回落 TURN 中继。 |
|
🔐 消息与附件加密 新消息正文和新上传附件使用 AES-256-GCM 服务端加密，密钥版本化管理，支持一键增量轮换，旧密文不受影响。 |
🙈 后台不看正文 管理员后台不提供任何消息正文的搜索或会话查看入口，只展示消息数量等聚合统计，把隐私边界做进产品里。 |
|
☁️ 零服务器运维 全部运行在你自己的 Cloudflare 账号里。GitHub Actions 自动部署，并可每日检查上游稳定版与安全更新、自动合并发布。 |
🛡️ 邀请制与精细管控 不开放自助注册，由管理员创建账号或发送邀请；支持永久封禁与按天/时/分钟设置的临时封禁，到期自动解除。 |
|
🔔 Telegram 离线提醒 成员可在设置中绑定 Bot，网页关闭时也能收到私信和 @ 提醒，且提醒中不包含消息正文，不泄露内容。 |
🪟 全端一致的体验 Liquid Glass 风格界面，适配桌面与移动端；支持 PWA 安装，并提供可自填服务地址的 Android 客户端。 |
Telegram 双向桥接
2.8.0起，Telegram 与实例桥接均只转发本站账号原创消息；来自另一条桥的消息不会继续跨桥扩散。
不用把所有人都搬进同一个应用。
管理员可以在后台查看 EdgeChat 的公开与私有群组，并将任一群组与 Telegram 群组绑定。Telegram Bot 会双向转发消息：在网页里发出的消息可以同步到 Telegram，Telegram 群里的消息也会回到 EdgeChat；一对一私信不会进入桥接。
适合已经有 Telegram 群、同时又需要一个独立网页聊天入口的团队和社区。
两个聊天入口，同一段讨论。
隐私与加密
EdgeChat 对新写入的消息正文和新上传的附件使用 AES-256-GCM 服务端静态加密。历史明文数据保持原状，读取时兼容新旧数据，不会在部署或后台任务中批量回填加密。
管理员后台不提供群组或私信消息正文的查看入口，仍可查看消息数量等聚合统计。
[!NOTE] 这是服务端加密，不是端到端加密。 Worker 在通过会话权限校验后解密内容，Cloudflare 运行环境和掌握密钥的部署方仍需要被信任。后台没有消息查看入口，不代表部署者在技术上无法访问内容。
开启 Telegram 桥接后，被转发的消息也会进入对应的 Telegram 会话。
密钥管理与轮换说明
GitHub Actions 会管理服务端加密 Worker Secrets。首次部署时，如果目标 Worker 尚无加密 Secret，工作流会自动生成随机 32 字节 AES 密钥，以独立的版本化 Secret 注入，并记录当前 active key ID。后续普通部署只检查这些 Secret 是否存在，不会重新生成、覆盖或轮换。
生产环境已经存在的 EDGECHAT_ENCRYPTION_KEYRING JSON 密钥环会被原样保留并继续兼容。
需要手动指定密钥时，可创建名为 EDGECHAT_ENCRYPTION_KEYRING 的 GitHub Repository Secret：
{"activeKeyId":"v1","keys":{"v1":"BASE64_ENCODED_32_BYTE_KEY"}}首次部署会直接采用该值。
已有 Worker 需要自动增量轮换时，手动运行 Deploy Worker 并勾选 rotate_encryption_key。工作流只新增一个版本化密钥 Secret，并把 active key ID 切换到新版本；所有旧 Secret 和旧 JSON 密钥环都保持不变。新消息使用新密钥，旧密文继续使用各自信封中的 key ID 解密。
apply_encryption_keyring 是备用的手动覆盖入口。使用时，Repository Secret 中必须是完整 JSON 密钥环，keys 需要保留所有仍被历史密文引用的旧 key ID，再增加新 key 并更新 activeKeyId。
删除旧 key 会导致对应历史密文永久无法读取。 apply_encryption_keyring 与 rotate_encryption_key 不能在同一次运行中同时启用。
技术栈
| 部分 | 技术 |
|---|---|
| 前端 | Vue 3、Vue Router、Vite |
| 后端 | Cloudflare Workers、Hono |
| 实时通信 | Durable Objects、WebSocket Hibernation |
| 数据库 | Cloudflare D1 |
| 会话存储 | Cloudflare KV |
| 文件存储 | Cloudflare R2 |
| 构建与部署 | Wrangler、GitHub Actions |
更多实现说明见 TECHNICAL.md。
部署
首次登录：没有默认管理员密码，建表 SQL 不会创建账号，也不开放公开注册。 Actions 部署请配置 EDGECHAT_ADMIN_USERNAME / EDGECHAT_ADMIN_PASSWORD Repository Secrets；手动部署请生成并执行管理员初始化 SQL。完整命令及漏配处理见首次管理员初始化。管理员登录后可创建用户或注册邀请。
GitHub Actions 自动部署
推荐使用仓库内置的 GitHub Actions 工作流进行部署和后续更新。Sync Upstream 每天检查两次，仅自动合并带 EdgeChat-Update: stable / security 尾行标记的上游发布并显式触发部署；首次启用、同步令牌及 MESSAGE_RETENTION_DAYS 配置见自动更新说明。
按照文档完成 Cloudflare 授权与仓库配置后，可以手动运行 Deploy Worker，也可以通过向 master 或 main 分支推送代码触发部署。工作流文件为 .github/workflows/deploy-worker.yml。
手动部署与 Docker
本地手动部署的资源准备、配置方法和注意事项见 部署文档。
Docker 相关说明见 DOCKER.md。
Android 客户端
查看客户端、安装与构建说明
capacitor/ 客户端的 APK 内置 Vue Web UI，并通过少量 Kotlin 对接系统文件选择、通知、麦克风权限、通知会话跳转和外部链接。包名为 com.aozorae.edgechat.web，首次登录时填写自己的 EdgeChat HTTPS 服务地址，不绑定固定部署。
- 安装包：从 GitHub Releases 下载
edgechat-*.apk，并核对SHA256SUMS.txt。 - 首次使用：填写自己的 EdgeChat HTTPS 服务地址、账号和密码。
- 本地构建：准备 JDK 21 与 Android SDK 36 后，运行
npm run build:capacitor。 - Debug APK：
capacitor/android/app/build/outputs/apk/debug/app-debug.apk。 - CI：
.github/workflows/capacitor-android-ci.yml上传edgechat-capacitor-debug。 - 发布：推送
android-v*标签或手动运行Android Release，使用四个ANDROID_KEYSTORE_*Secrets 构建签名 APK/AAB。 - 服务切换：退出登录后可以修改地址；切换实例时自动清理旧实例令牌。
当前不包含 Room 离线数据库、WorkManager Outbox 或 FCM；应用停止接收消息时，不承诺后台即时通知。
原生 android/ Kotlin + Jetpack Compose 客户端暂时弃用，不再作为默认发行版。源码、API v1 契约与独立 CI 暂时保留。
完整说明见 Android 客户端文档。
本地开发
# 获取源码
git clone https://github.com/aozorae/Edgechat.git
cd Edgechat
# 安装依赖
npm install
# 启动纯前端演示，无需先部署云端资源
npm run dev:demo连接实际后端进行开发或部署前，请先按照文档准备对应的 Cloudflare 资源与配置。
# 前端开发
npm run dev:frontend
# 本地构建
npm run build
# 本地手动发布
npm run deploy演示站构建、部署与 CI 环境变量
# 独立构建演示站
npm run build:demo
# 部署独立演示 Worker
npm run deploy:demo演示站使用 wrangler.demo.toml 和 .github/workflows/deploy-demo.yml，Worker 名称为 edgechat-demo。GitHub Actions 仅支持手动触发，并读取 DEMO_CLOUDFLARE_ACCOUNT_ID、DEMO_CLOUDFLARE_API_TOKEN，不会改变现有生产部署工作流。
在非交互环境下部署时，需要提前设置 CLOUDFLARE_API_TOKEN。
后台更新检查会在构建时自动记录当前 GitHub 仓库、分支和提交。为了获得准确结果，手动部署应在 Git 仓库内基于已经推送的干净提交构建；源码仓库需要保持公开，浏览器才能直接调用 GitHub Compare API，整个过程不会创建定时任务。
PowerShell 示例：
$env:CLOUDFLARE_API_TOKEN = "your-token"
npm run deploy项目结构
查看主要目录
Edgechat/
├─ assets/previews/ # 界面预览
├─ frontend/ # Vue 前端与浏览器内演示
├─ worker/
│ ├─ schema.sql # 数据库结构
│ ├─ migrations/ # 数据库迁移
│ └─ src/ # API、认证与 Durable Objects
├─ capacitor/ # 基于 Web UI 的 Android 客户端
├─ android/ # 暂时保留的原生 Android 客户端
├─ .github/workflows/ # 自动部署与 CI
├─ wrangler.toml
├─ wrangler.demo.toml
├─ package.json
├─ README.md
├─ README.en.md
├─ README.ja.md
└─ LICENSE交流与贡献
遇到问题、想讨论功能，或者有自己的使用方式，欢迎提交 Issue，也欢迎加入 Telegram 社区。
代码、文档、翻译与问题反馈都可以帮助项目继续完善。欢迎提交 Pull Request。
感谢所有为 EdgeChat 提供帮助的贡献者：
特别感谢 @fix221 提交 PWA 支持 PR #31。
Star History
协议说明
本项目采用 GNU GPL v3.0 or later，详见 LICENSE。
鸣谢
✨ 特别鸣谢
|
VenLac（Venlacy） 项目早期贡献了大量核心代码，为 EdgeChat 的整体架构奠定了基础； 同时凭借自身在社区中的影响力，为项目推广做出了突出贡献。让更多开发者认识并使用了 EdgeChat。 |
感谢 linux do 在推广方面为本项目做出的贡献。
免责声明
EdgeChat 是一个自部署的开源项目。项目维护者仅提供软件本身，不运营、控制或管理任何由用户自行部署的实例。
实例的部署者和使用者应自行对其部署方式、使用行为及其中产生的内容和数据负责。
项目维护者不对任何独立部署实例的使用或滥用承担责任。