Standard Notes Linux 客户端无需安装,直接下载签名 AppImage、chmod +x 后运行即可启用端到端加密;自建私有服务器则必须使用 PostgreSQL(不支持 SQLite),且客户端同步地址须含 /v3 路径。

Standard Notes 在 Linux 上没有“安装”概念——它不走包管理器,也不写系统路径,本质是运行一个自包含的 AppImage 文件。直接下载、加执行权、运行即可用端到端加密,别折腾 apt install standard-notes,那装的不是官方版。
怎么获取并运行官方 AppImage
官网只提供签名过的 Standard-Notes-*.AppImage,其他渠道(比如 AUR、第三方 repo)要么没维护,要么无签名,风险不可控。
- 去
standardnotes.com/download点 “Linux”,下载最新Standard-Notes-*.AppImage(例如Standard-Notes-4.12.4.AppImage) - 终端执行:
chmod u+x Standard-Notes-*.AppImage(缺这步双击会静默失败) - 运行:
./Standard-Notes-*.AppImage,或双击图形界面启动 - 首次运行会解压临时资源到
$HOME/.local/share/Standard Notes,之后每次启动都复用
如遇 libfuse.so.2 missing 错误,说明系统缺 fuse2:sudo apt install libfuse2(Ubuntu/Debian)或 sudo dnf install fuse(Fedora)
为什么登录后看不到旧笔记?密钥根本没同步
Standard Notes 的端到端加密是纯客户端行为:密钥(包括主密码派生逻辑)从不上传服务器,只传加密后的数据块。所以你在 Web 或手机上建的账户,Linux 客户端默认拿不到密钥。
- 必须手动恢复:Web 端 Settings → Account → Export Account,得到 JSON 格式的
Account Backup - 或输入 Recovery Key(32 字符 hex 字符串),在 Linux 客户端设置里粘贴
- 若启用了 Passcode Lock,Linux 客户端不支持该功能,会卡住——需先在 Web 端关掉
-
Account Backup文件本身是 AES-256 加密的,解密口令就是你的 Master Password,别和备份文件存一起
想自建私有服务器?PostgreSQL 是硬门槛
桌面客户端连的是官方 sync.standardnotes.com;要切到自建服务,必须部署后端,且它**不支持 SQLite**——DATABASE_URL 只认 PostgreSQL 连接串,填 sqlite:///db.sqlite 会报 Error: Unsupported database type。
- 确保已装
postgresql-14+(Ubuntu/Debian)或postgresql-server(CentOS/RHEL),初始化集群并启用服务 - 创建数据库和用户:
createdb standardnotes+createuser -P standardnotes - 克隆后端代码:
git clone https://gitcode.com/gh_mirrors/ap/app && cd app -
.env中必须含:DATABASE_URL=postgresql://standardnotes:yourpass@localhost:5432/standardnotes和PORT=3000 - 启动命令在
packages/api目录下:yarn install && cd packages/api && yarn build && yarn start(不是项目根目录)
客户端改同步地址时,必须带 /v3 路径,比如 http://localhost:3000/v3,否则返回 404 Not Found —— 这个版本前缀容易漏掉,但 API 路由强制校验。
/v3 和 postgresql:// 这两个字符串。


















