EdgeEver ： 基于cloudflare的开源免费 [ 印象笔记 ]

项目地址：无需服务器、0费用、原生支持 AI Agent 的开源自托管『印象笔记』

项目介绍

EdgeEver 是一个开源、自托管、Cloudflare-native 的现代笔记工作区。它保留经典印象笔记的三栏体验，同时提供清晰的数据模型、REST API、OpenAPI schema 和 MCP endpoint，原生支持 AI Agent 接入。

100% 免费 EdgeEver 采用纯 Serverless（无服务器）架构。直接运行在 Cloudflare 的免费额度内，个人日常使用 完全免费，0 费用，0 运维。

功能特性

• 零服务器，零运维，终身完全免费：基于 Cloudflare 无服务器架构与免费级配额，短笔记可达 15 万条，200KB 图片约可存放 5 万张，彻底免去云服务器租用和维护成本，并带来全球秒开的极速响应。
• 数据完全开放：笔记内容存放在基于标准 SQLite 的 Cloudflare D1 中，可通过 REST API、MCP 和 CLI 按需读取与管理，不用担心被单一笔记产品绑定。
• EdgeEver ZIP 导入与导出：同一份档案既包含便于直接阅读和迁移的 Markdown、Front Matter、嵌套笔记本结构与相对路径附件，也包含用于 EdgeEver 实例间完整恢复的版本化结构数据和历史版本。
• AI Agent 友好：原生支持 MCP，可让 Codex、Claude Code、Antigravity 等工具读取、整理和维护笔记，并可借助 MCP 与 Notion Database、飞书多维表格进行联动。
• 多端无缝同步且不限设备数：基于自建的 API 个人独享数据，摆脱商业笔记平台对登录设备数量的强制限制（如免费版只允许登录 2 台设备等），支持 PC、平板与手机无缝多端同步。
• 三栏布局：笔记本树、笔记列表、主编辑区。
• 无限级嵌套笔记本。
• 支持富文本编辑。
• 桌面端支持 Markdown 源码与富文本视图切换。
• 支持查看笔记历史版本，便于回溯内容变化。
• 笔记图片上传前支持 Web 端本地压缩，常见截图和大尺寸照片通常可减少约 50%-90% 体积，减少资源占用且不消耗 Cloudflare Images 额度。
• 多选合并笔记。
• 多选移动笔记，笔记本支持拖拽排序和调整层级。
• 已有笔记支持离线编辑草稿和本地同步队列。
• 支持单实例多账号，每个账号拥有隔离的个人笔记空间；管理员可创建、停用和重置成员账号，密码使用 PBKDF2-SHA256 hash。
• Chrome/Edge 网页裁剪插件已正式上架 Chrome Web Store。
• 支持安装为 PWA 应用，PC 和移动端均可流畅访问；原生移动端 App（iOS / Android）已开发完成并已提交上架审核，安卓用户可直接在 Release 页面下载 APK 抢先体验。

界面预览

安装部署

AI Agent 一键部署

将下方提示词复制给你的 AI 助手（Claude Code、Codex、OpenClaw、Antigravity、Cursor、Trae 等），它会完成首次安装并配置后续自动更新。

建议： 开始部署前，请先为 AI Agent 配置 GitHub 和 Cloudflare 的 MCP、插件或其他可用集成，以便 Agent 完成仓库 Fork、Cloudflare 资源创建、应用部署和 Workers Builds 自动部署连接。

请按以下流程操作：
1. Fork EdgeEver 上游仓库：https://github.com/tianma-if/edgeever
2. 使用 Fork 后的仓库创建 Cloudflare 资源并完成 EdgeEver 首次部署。
3. 运行 `bun run deploy:builds:setup`，通过 Cloudflare Workers Builds 将已部署的 Worker 连接到 Fork 仓库的 `main` 分支；如需 token，使用 User API Token，不要使用 Account API Token。
4. 后续 GitHub Sync fork 或任何推送到 `main` 的更新，都必须自动构建、执行 D1 migration 并发布该实例。

Agent 应优先按 AI Agent Cloudflare Deployment 执行。首次部署后，请参阅 Cloudflare Workers Builds 自动部署；官方实例和 Fork 使用同一套发布流程。

手动部署

1.Fork 官方仓库： 访问并 Fork 官方仓库：https://github.com/tianma-if/edgeever

2.Clone 你的 Fork 仓库

git clone <你的 Fork 仓库 URL>
cd edgeever

3.使用自动化辅助命令部署

# 复制配置文件模板
cp .env.local.example .env.local

# 安装依赖
bun install

# 执行部署初始化，默认登录账号密码为 admin / admin123
bun run deploy:setup

# 诊断部署环境与配置
bun run deploy:doctor

# 执行部署
bun run deploy

如果希望首次登录就使用自定义密码，可改为执行 EDGE_EVER_PASSWORD='<你的密码>' bun run deploy:setup。部署成功后也可以在个人中心修改密码

必须在执行 bun run deploy 之前，将 D1 创建命令返回的 database_id 和 R2 bucket 名称写入本机 .env.local。模板的初始登录账号密码为 admin / admin123；如需使用其他初始密码，可修改 EDGE_EVER_AUTH_PASSWORD。会话有效期建议保留模板中的 400 天；服务端也会把更大的值限制为 400 天。

bun run deploy 会构建 Web 应用、执行远程 D1 migration、部署 Worker，并将 EDGE_EVER_AUTH_PASSWORD 作为 Worker Secret 上传。首次登录成功后，EdgeEver 会将加盐的 PBKDF2-SHA256 哈希写入 D1。已有实例可以继续使用 EDGE_EVER_AUTH_PASSWORD_HASH；两个 Secret 同时存在时优先使用哈希。部署完成后，请使用 .env.local 中的 EDGE_EVER_AUTH_USERNAME 和配置的密码登录验证。

已有实例无需迁移。如果确实要从哈希配置切换为 EDGE_EVER_AUTH_PASSWORD，需要同时从 .env.local、Workers Builds 和 Worker 运行时 Secrets 中移除旧的 EDGE_EVER_AUTH_PASSWORD_HASH，否则旧哈希仍会优先生效。

开启自动更新

首次部署后，必须将 Worker 连接到 Fork 的 main 分支；Cloudflare Workers Builds 是所有 EdgeEver 实例的标准生产发布路径。请先按 Cloudflare Workers Builds 自动部署 创建仅供配置使用的 User API Token（不是 Account API Token），将它私下写入 .env.local 的 EDGE_EVER_BUILDS_API_TOKEN，然后执行：

bun run deploy:builds:setup

该命令会配置 Git 仓库连接、生产触发器、构建变量和 D1 migration 所需的部署 token。完成后，只需在 Fork 页面点击 Sync fork，或推送到 main；Cloudflare 会自动构建 Web、应用新的远程 D1 migration 并发布 Worker。不需要 GitHub Actions Secrets，也不需要本地重新部署。

请保留 bun run deploy 作为首次安装和紧急修复的入口。