aozorae/Edgechat

这是什么？

核心功能

• 01基于 WebSocket 的群聊与私信实时更新
• 02Telegram 群组双向桥接，支持文字、图片、视频、语音和文件
• 03不同 EdgeChat 实例之间通过邀请码互联群组
• 04新消息和附件使用 AES-256-GCM 服务端加密，支持密钥轮换
• 05邀请制账号管理，支持永久和临时封禁
• 06基于 Cloudflare Workers、D1、KV、R2 与 Durable Objects 运行，通过 GitHub Actions 部署

适用场景

• 不想维护服务器的小团队或社区，需要自建聊天空间
• 已有 Telegram 群、同时需要独立网页聊天入口的团队
• 两个组织需要通过各自实例共享同一个群组
• 希望通过 WebMCP 让 AI 助手参与聊天室的开发者

快速上手

1. 1

   克隆仓库

   git clone https://github.com/aozorae/Edgechat.git
2. 2

   进入项目目录

   cd Edgechat
3. 3

   安装依赖

   npm install
4. 4

   启动纯前端演示（无需云端资源）

   npm run dev:demo

使用前须知

• !加密是服务端加密而非端到端加密，需要信任 Cloudflare 和部署方。
• !部署真实后端前需要先准备 Cloudflare 资源与配置。
• !未自定义时，消息默认 15 天后自动删除。

标签

常见问题

Edgechat 是什么？

基于 Cloudflare 运行的自部署团队聊天系统，支持实时消息、Telegram 双向桥接和服务端加密。 EdgeChat 是一个完全运行在 Cloudflare 上的开源团队聊天系统，提供群组聊天、私信、语音消息、文件分享以及私信一对一语音通话。应用和数据资源部署在你自己的 Cloudflare 账号下，通过 GitHub Actions 完成部署和更新，无需另外维护常驻服务器。

Edgechat 可以免费使用吗？用的什么许可证？

Edgechat 以 GPL-3.0 许可证开源。用于商业产品前，请先确认许可证条款。

Edgechat 还在维护吗？

活跃维护中。Edgechat 最近一次提交是在 2026年10月18日。

Edgechat 适合用来做什么？

不想维护服务器的小团队或社区，需要自建聊天空间 已有 Telegram 群、同时需要独立网页聊天入口的团队 两个组织需要通过各自实例共享同一个群组 希望通过 WebMCP 让 AI 助手参与聊天室的开发者

Edgechat 怎么安装和运行？

克隆仓库: git clone https://github.com/aozorae/Edgechat.git 进入项目目录: cd Edgechat 安装依赖: npm install 启动纯前端演示（无需云端资源）: npm run dev:demo

在哪里获取 Edgechat？

源代码和安装说明在 GitHub 上：https://github.com/aozorae/Edgechat