notesd：自托管离线笔记

项目简介

notesd 是一个可自托管的笔记服务。你可以在便宜的 VPS、家里的服务器或树莓派上运行它：一个内置 SQLite 的二进制文件，不需要额外配置。它提供 Web 应用，以及可离线使用的 Android 和 iPhone 原生应用，适合希望把笔记数据放在自己服务器上的用户。

主要功能

• 离线优先：Android、iPhone 应用以及可选的 Web 应用会保存完整笔记副本；两台设备同时编辑时会合并，或保留为单独副本。
• 全文搜索：可搜索标题和正文。
• 标签：在笔记任意位置写 #work，支持用 / 嵌套，如 #home/garden。
• Spaces：将工作、个人等不同场景分开。
• 锁定笔记：在设备上以 AES-256-GCM 加密，服务器只保存密文；可用密码、Web 上的 passkey，或指纹、Face ID 解锁。
• Markdown：笔记以 Markdown 存储，可导出，也可以在写作时同步维护一个 .md 文件文件夹。
• 多账户：一个服务器可创建几个账户，供家人或朋友使用，每个账户有独立笔记。
• macOS 桌面端：最新版提供 Tauri 桌面应用，可连接用户自己的 notesd 服务器，并支持 Touch ID 解锁锁定笔记。

安装与使用

在服务器上运行 Docker：

docker run -d --name notesd --restart unless-stopped \
  -p 127.0.0.1:8080:8080 \
  -v notesd-data:/data \
  ghcr.io/cassiozen/notesd:latest

创建账户：

docker exec -it notesd notesd create-owner --username YOUR_USERNAME

然后按快速开始指南用 Caddy 或 Tailscale 在 127.0.0.1:8080 前配置 HTTPS，再写第一条笔记并连接手机。不用 Docker 时，可按文档用 systemd 运行二进制。

Android 应用需要 Android 9 或更高版本，通过 APK 安装；iPhone 应用需要 iOS 26 或更高版本，使用 Xcode 构建。

注意事项

• 普通笔记在服务器上不加密；如有需要请启用磁盘加密，并对公网访问使用 HTTPS。锁定笔记为端到端加密，限制见安全模型。
• 所有数据在服务器的一个数据目录中，包括保存笔记和图片的 SQLite 数据库；备份方式见文档。
• notesd 没有分析统计，也不会主动连接其他服务，除非开启需要外部服务的功能（如用邮件发送笔记，或从设置中检查更新）。
• 服务器支持 64 位 Linux（x86-64 或 ARM64）和 Apple silicon Mac。

本作品整理自 GitHub 开源项目 cassiozen/notesd，原作者 @cassiozen，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。