bretzel-app/crumbs

这是什么？

核心功能

• 01支持 Markdown、清单、图片附件和颜色主题
• 02提供 #标签、置顶、归档和回收站功能
• 03标题、正文和标签的全文搜索
• 04保存版本历史，可恢复旧版本
• 05PWA 支持离线使用，并通过 LWW CRDT 同步
• 06可选接入 Google、GitHub 和 OIDC 单点登录

适用场景

• 在自己的服务器上搭建私有的 Google Keep 替代品
• 在不把笔记交给第三方云服务的前提下记录个人想法
• 在同一个自托管实例中与团队或家人共享笔记
• 通过 MCP 服务让 AI 助手读取和管理笔记

快速上手

1. 1

   创建文件夹并进入

   mkdir crumbs && cd crumbs
2. 2

   下载 docker-compose.yml 文件

   curl -fsSLO https://raw.githubusercontent.com/bretzel-app/crumbs/main/docker-compose.yml
3. 3

   使用 Docker Compose 启动 Crumbs

   docker compose up -d
4. 4

   在浏览器中打开 http://localhost:3000 并创建管理员账户

使用前须知

• !从其他设备使用需要 HTTPS 并正确设置 ORIGIN；通过服务器 IP 使用普通 HTTP 无法保持登录状态。
• !第一个访问者会成为管理员，因此需要在开放端口之前创建账户。

收录于专题

标签

常见问题

crumbs 是什么？

基于 SvelteKit 构建的自托管、注重隐私的笔记应用，可作为 Google Keep 的替代方案。 Crumbs 是一款可自托管的笔记应用，用于记录想法、灵感和零散笔记。它基于 SvelteKit 和 SQLite 构建，可通过 Docker 或 Node.js 22 部署在自己的服务器上。

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

crumbs 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

crumbs 还在维护吗？

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

crumbs 适合用来做什么？

在自己的服务器上搭建私有的 Google Keep 替代品 在不把笔记交给第三方云服务的前提下记录个人想法 在同一个自托管实例中与团队或家人共享笔记 通过 MCP 服务让 AI 助手读取和管理笔记

crumbs 怎么安装和运行？

创建文件夹并进入: mkdir crumbs && cd crumbs 下载 docker-compose.yml 文件: curl -fsSLO https://raw.githubusercontent.com/bretzel-app/crumbs/main/docker-compose.yml 使用 Docker Compose 启动 Crumbs: docker compose up -d 在浏览器中打开 http://localhost:3000 并创建管理员账户

在哪里获取 crumbs？

源代码和安装说明在 GitHub 上：https://github.com/bretzel-app/crumbs