简介什么是 Crumbs Crumbs是一个自托管的、离线优先的笔记应用专注于用户隐私保护。它可以帮助用户搭建私有的笔记服务替代Google Keep等商业笔记应用同时支持多用户协作和AI助手集成。主要特点隐私优先数据完全存储在自有服务器不依赖第三方云服务离线支持PWA应用支持离线使用通过IndexedDBLWW CRDT同步丰富的笔记功能支持Markdown、清单、图片附件和12种颜色主题智能组织使用#标签、置顶、归档和回收站管理笔记全文搜索支持标题、内容和标签的全文搜索版本历史可浏览和恢复笔记的历史版本协作分享支持在同一实例内的用户间分享笔记邮件通知可配置SMTP发送分享提醒、安全警报和账户事件通知AI 集成内置MCP服务器支持Claude Code等AI助手管理笔记多用户认证基于Argon2的密码认证支持Google、GitHub、OIDC等OAuth/SSO开源免费基于MIT协议开源可免费使用和修改应用场景个人知识管理搭建私有的笔记系统管理个人知识和想法团队协作多用户支持团队成员可分享和协作编辑笔记隐私敏感用户对数据隐私有高要求的用户避免使用商业云服务离线工作网络不稳定环境下仍可使用数据自动同步AI 辅助创作通过MCP服务器与AI助手集成提升笔记效率总的来说Crumbs是一个功能完整、隐私优先的自托管笔记解决方案适合对数据安全和隐私保护有要求的个人和团队使用。安装在群晖上以 Docker 方式安装。提示由于镜像托管在ghcr.io群晖Docker套件无法直接搜索需要通过命令行拉取镜像。本文写作时latest版本对应为0.24.0docker cli 安装如果你熟悉命令行可能用docker cli更快捷# 新建文件夹 crumbs 和 子目录mkdir-p/volume1/docker/crumbs/data# 进入 crumbs 目录cd/volume1/docker/crumbs# 修改目录权限chmodarw data# 一键启动dockerrun-d\--namecrumbs\--restartunless-stopped\-p3436:3000\-v$(pwd)/data:/data\ghcr.io/bretzel-app/crumbs:latestdocker-compose 安装也可以用docker-compose安装将下面的内容保存为docker-compose.yml文件version:3.8services:crumbs:image:ghcr.io/bretzel-app/crumbs:latestcontainer_name:crumbsrestart:unless-stoppedports:-3436:3000volumes:-./data:/data然后通过SSH登录到您的群晖执行下面的命令# 新建文件夹 crumbs 和 子目录mkdir-p/volume1/docker/crumbs/data# 进入 crumbs 目录cd/volume1/docker/crumbs# 修改目录权限chmodarw data# 将 docker-compose.yml 放入当前目录# 一键启动docker-composeup-d可选配置SSO 单点登录如需启用SSO添加以下环境变量environment:-ORIGINhttps://notes.example.com-AUTH_OIDC_ISSUERhttps://authentik.example.com/application/o/crumbs/-AUTH_OIDC_CLIENT_IDyour-client-id-AUTH_OIDC_CLIENT_SECRETyour-client-secret-AUTH_OIDC_DISPLAY_NAMEAuthentik邮件通知如需启用邮件通知添加SMTP配置environment:-SMTP_HOSTsmtp.example.com-SMTP_PORT587-SMTP_USERyour-username-SMTP_PASSyour-password-SMTP_FROMCrumbs noreplyexample.com运行在浏览器中访问http://群辉IP:3436即可进入Web界面。首次使用需要创建管理员账号邮箱和密码密码最少8位设置完成后即可开始使用需要登录登录成功后的主界面点Add a crumb增加笔记添加成功后支持通过AI助手管理笔记注意事项数据持久化确保/data卷正确挂载否则数据会在容器重启后丢失OAuth 限制OAuth登录采用邀请制用户需先由管理员创建账号才能使用OAuth登录HTTPS 建议生产环境建议使用HTTPS可通过反向代理如Nginx配置ORIGIN 环境变量生产环境部署时必须设置ORIGIN环境变量为实际访问地址否则CSRF保护和OAuth回调会失败备份建议定期备份/data卷中的数据库文件参考文档bretzel-app/crumbs: Crumbs by Bretzel - a self-hosted, privacy-first Google Keep alternative. Capture your thoughts, ideas and notes. Built with SvelteKit.地址https://github.com/bretzel-app/crumbsCrumbs - Your notes. Your server. Your rules.地址https://crumbs.bretzel.app/bretzel-app/crumbs - ghcr.io 镜像地址https://github.com/bretzel-app/crumbs/pkgs/container/crumbs
隐私优先的笔记应用Crumbs
简介什么是 Crumbs Crumbs是一个自托管的、离线优先的笔记应用专注于用户隐私保护。它可以帮助用户搭建私有的笔记服务替代Google Keep等商业笔记应用同时支持多用户协作和AI助手集成。主要特点隐私优先数据完全存储在自有服务器不依赖第三方云服务离线支持PWA应用支持离线使用通过IndexedDBLWW CRDT同步丰富的笔记功能支持Markdown、清单、图片附件和12种颜色主题智能组织使用#标签、置顶、归档和回收站管理笔记全文搜索支持标题、内容和标签的全文搜索版本历史可浏览和恢复笔记的历史版本协作分享支持在同一实例内的用户间分享笔记邮件通知可配置SMTP发送分享提醒、安全警报和账户事件通知AI 集成内置MCP服务器支持Claude Code等AI助手管理笔记多用户认证基于Argon2的密码认证支持Google、GitHub、OIDC等OAuth/SSO开源免费基于MIT协议开源可免费使用和修改应用场景个人知识管理搭建私有的笔记系统管理个人知识和想法团队协作多用户支持团队成员可分享和协作编辑笔记隐私敏感用户对数据隐私有高要求的用户避免使用商业云服务离线工作网络不稳定环境下仍可使用数据自动同步AI 辅助创作通过MCP服务器与AI助手集成提升笔记效率总的来说Crumbs是一个功能完整、隐私优先的自托管笔记解决方案适合对数据安全和隐私保护有要求的个人和团队使用。安装在群晖上以 Docker 方式安装。提示由于镜像托管在ghcr.io群晖Docker套件无法直接搜索需要通过命令行拉取镜像。本文写作时latest版本对应为0.24.0docker cli 安装如果你熟悉命令行可能用docker cli更快捷# 新建文件夹 crumbs 和 子目录mkdir-p/volume1/docker/crumbs/data# 进入 crumbs 目录cd/volume1/docker/crumbs# 修改目录权限chmodarw data# 一键启动dockerrun-d\--namecrumbs\--restartunless-stopped\-p3436:3000\-v$(pwd)/data:/data\ghcr.io/bretzel-app/crumbs:latestdocker-compose 安装也可以用docker-compose安装将下面的内容保存为docker-compose.yml文件version:3.8services:crumbs:image:ghcr.io/bretzel-app/crumbs:latestcontainer_name:crumbsrestart:unless-stoppedports:-3436:3000volumes:-./data:/data然后通过SSH登录到您的群晖执行下面的命令# 新建文件夹 crumbs 和 子目录mkdir-p/volume1/docker/crumbs/data# 进入 crumbs 目录cd/volume1/docker/crumbs# 修改目录权限chmodarw data# 将 docker-compose.yml 放入当前目录# 一键启动docker-composeup-d可选配置SSO 单点登录如需启用SSO添加以下环境变量environment:-ORIGINhttps://notes.example.com-AUTH_OIDC_ISSUERhttps://authentik.example.com/application/o/crumbs/-AUTH_OIDC_CLIENT_IDyour-client-id-AUTH_OIDC_CLIENT_SECRETyour-client-secret-AUTH_OIDC_DISPLAY_NAMEAuthentik邮件通知如需启用邮件通知添加SMTP配置environment:-SMTP_HOSTsmtp.example.com-SMTP_PORT587-SMTP_USERyour-username-SMTP_PASSyour-password-SMTP_FROMCrumbs noreplyexample.com运行在浏览器中访问http://群辉IP:3436即可进入Web界面。首次使用需要创建管理员账号邮箱和密码密码最少8位设置完成后即可开始使用需要登录登录成功后的主界面点Add a crumb增加笔记添加成功后支持通过AI助手管理笔记注意事项数据持久化确保/data卷正确挂载否则数据会在容器重启后丢失OAuth 限制OAuth登录采用邀请制用户需先由管理员创建账号才能使用OAuth登录HTTPS 建议生产环境建议使用HTTPS可通过反向代理如Nginx配置ORIGIN 环境变量生产环境部署时必须设置ORIGIN环境变量为实际访问地址否则CSRF保护和OAuth回调会失败备份建议定期备份/data卷中的数据库文件参考文档bretzel-app/crumbs: Crumbs by Bretzel - a self-hosted, privacy-first Google Keep alternative. Capture your thoughts, ideas and notes. Built with SvelteKit.地址https://github.com/bretzel-app/crumbsCrumbs - Your notes. Your server. Your rules.地址https://crumbs.bretzel.app/bretzel-app/crumbs - ghcr.io 镜像地址https://github.com/bretzel-app/crumbs/pkgs/container/crumbs
