tianma-if/edgeever
效率工具开源可自托管的笔记工作台,保留三栏编辑,支持多端同步、网页剪藏和 MCP 供 AI Agent 读写。
项目定位
EdgeEver 是一个开源的笔记与个人知识库工作台,保留经典三栏布局(目录树、笔记列表、编辑器),同时支持富文本与 Markdown 切换、表格、Mermaid 图表、思维导图和海报笔记。它面向希望获得云端笔记式即时多端同步、又不想绑定付费订阅的用户,数据以数据库和 Markdown 形式留存,可自行部署。官方提供 Web、macOS、Windows、Linux、iOS、Android 客户端,以及 Chrome、Edge、Firefox 浏览器剪藏扩展 客户端与扩展。
后端是一套 Hono/Zod 应用,同一份代码可运行在 Cloudflare Workers(D1 + R2)或 Docker 容器(SQLite + 本地或 S3 兼容存储)上。内置远程 MCP 端点,允许 Claude Code、Codex 等 Agent 在账号权限内读写笔记、笔记本、标签和附件 MCP 使用指南。
先试用
公开演示地址是 demo.edgeever.org,每天凌晨 3 点(中国标准时间)重置并恢复示例笔记,不要存放隐私内容。若只在本机开发,安装 Bun 后执行:
bun install
bun run dev
本地开发会自动登录,全新数据库使用 owner / edgeever-local-dev;需要测试登录页时退出即可 README 快速开始。
部署方式
推荐使用 Cloudflare 零服务器方案:Fork 仓库,创建 D1 与 R2 资源,新建 Worker,在连接 Fork 之前先把 EDGE_EVER_AUTH_PASSWORD 设为 Secret,然后运行 Update deployed EdgeEver 工作流,确认 /api/health 和 /api/openapi.json 可访问。README 还提供可交给 AI Agent 执行的完整提示词 Agent 部署文档 和七步网页手动部署说明 在线部署指南。
需要 VPS、NAS 或家用服务器时可选 Docker:前端、API、MCP 和迁移与 Cloudflare 版一致,存储改为 SQLite 加本地或 S3 兼容附件,镜像支持 amd64 和 arm64 Docker 部署文档。README 给出的安装命令是:
curl -fsSL https://edgeever.org/install.sh | bash
它会拉取 GHCR 镜像、生成管理员密码并通过 Docker Compose 启动;之后默认每天自动更新,也可在服务器上执行 ~/edgeever/update.sh 手动更新。
日常使用
部署完成后用 admin 和你设置的管理员密码登录(本地开发用 owner)。可以新建笔记本和笔记、上传最大 1 GiB 的附件(图片在客户端压缩)、通过网页剪藏扩展或手机分享面板收集内容。备份与迁移位于 Profile → Import and export:导出的 ZIP 含结构化元数据,解压后的 notes/ 目录保留明文 Markdown 与附件;原生一键导入支持 flomo、Evernote、Obsidian 和 Joplin,其他平台可通过 迁移指南 中的 MCP/Agent 方式处理。
要让 AI Agent 接入,在 Profile → API / MCP 创建令牌,把远程 MCP 配置粘贴到客户端即可。实例管理员可以在 Profile → User accounts 创建、停用或重置成员账号,每个成员拥有隔离的工作区和存储用量面板。
使用约束
- Cloudflare 免费额度是宣传的零成本路径,但 R2 需要先开通订阅并绑定支付方式才能享受免费额度 Cloudflare R2 说明。
- iOS 客户端需要非中国大陆地区的 Apple ID 才能下载。
- Docker 的附件存储和可选的 S3/OSS、图床配置需另行设置;更换存储不会迁移已有附件。
- 2FA、暴力破解防护和租户隔离在 README 中有说明,但实例由使用者自行运维,官方只在演示实例上托管内容 README 免责声明。
- 许可证为 AGPL-3.0;Fork 可以注明基于 EdgeEver,但不得暗示官方身份。
HotRepo 点评
2026-11-19 的 TypeScript 日榜上,EdgeEver 以当天新增 57 Star 排在第 8 位,当时累计 3,427 Star、1,779 Fork。Fork 数接近 Star 数一半,比例偏高,这与它鼓励「Fork 后部署到 Cloudflare」的使用路径相符:许多 Fork 可能是部署步骤而非代码贡献。站点没有记录到全部语言日榜名次,因此这里能依据的排名只有 TypeScript 日榜这一次快照,单次数据不足以判断趋势。项目的差异点在于把传统三栏笔记应用与原生 MCP 端点、两套共享同一代码库的部署形态放在一起,适合需要让 AI Agent 访问自己笔记、又不愿订阅托管服务的自托管用户评估。
本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。
相关推荐
- laurent22/joplin一款以 Markdown 存储、可把同步指向自有存储的跨平台笔记与待办应用。
- jessepinkman9900/claude-second-brain一条命令搭建由 Claude Code 维护的 Obsidian 知识库,自带本地混合检索与 Git 同步。
- Timaga/noda-local-ai-notes面向 Windows 的本地优先 Markdown 笔记应用,提供知识图谱、语义搜索和带引用来源的问答。
- Ciao1019/ArcMD用 Go 原生实现的 Markdown 富文本编辑器,彩色空间、分屏与本地 .md 文件,面向笔记写作。
- TriliumNext/Trilium面向自托管用户、支持深度关联的个人知识库笔记应用,数据掌握在自己手里。