私有笔记trilium

本机安装记录（2026-10-07 实测，NixOS max2）

客户端用中文汉化版 0.63.7（Nriver/trilium-translation 的桌面版产物）—— 与服务端同版本、同 syncVersion=32 ⇒ 同步门禁必然放行。

结论

  • 服务端 trilium.atibm.com = zadam Trilium 0.63.7 + 中文化补丁（实测 /etapi/app-info：appVersion 0.63.7 / dbVersion 228 / syncVersion 32 / buildDate 2024-05-30 / buildRevision 95d46b7＝zadam 原提交；登录页为中文，资源路径 assets/v0.63.7）。
  • 汉化来源 = Nriver/trilium-translation（Docker Hub nriver/trilium-cn，含 0.63.7 tag，259MB）。其 release v0.63.7_20240530 提供四份桌面产物：trilium-cn-linux-x64.zip（就是本机这份）、windows / mac / linux-server。
  • ⚠️ 上游官方 0.63.7 桌面版没有 i18n（源码树零翻译文件）⇒ 英文界面；中文 i18n 是 TriliumNext 才加的（有 zh-CN）。

安装位

项值
目录~/.local/opt/trilium-cn-0.63.7/（内层 trilium-linux-x64/ 已拉平）
主程序~/.local/opt/trilium-cn-0.63.7/trilium（166MB Electron，解释器 = /lib64/ld-linux-x86-64.so.2 → 靠 nix-ld）
命令~/.local/bin/trilium-cn（软链；localBinInPath = true 已在 PATH）
菜单项~/.local/share/applications/trilium-cn.desktop（Name=Trilium 中文版）
数据目录~/.local/share/trilium-data（独立本地库：config.ini / document.db）
下载物~/.hermes/cache/scratch/dl/trilium-cn-linux-x64.zip，sha256 03180c237fe3b3095e70c67ad8cc56812c80417a3ec4c2fb0667a417643660ec，143,422,582 B

为什么不装 FHS 包装

  • 本机 programs.nix-ld.enable = true，且库列表（glib / nss / nspr / dbus / atk / at-spi2* / cups / cairo / gtk3 / pango / libglvnd / libgbm / libdrm / expat / libxcb / libxkbcommon / alsa-lib / libsecret / X 系列）已覆盖 Electron 全套依赖 ⇒ 直接可跑。
  • max_user_namespaces=240178 ⇒ Electron 命名空间沙箱可用，不需要 --no-sandbox。
  • 启动日志仅有无害告警：appmenu-gtk-module / libcolorreload-gtk-module 的 GTK 模块符号告警、GetVSyncParametersIfAvailable() failed（X11 vsync）。

启动验证证据（首次运行日志）

DB not initialized, please visit setup page
{"appVersion":"0.63.7","dbVersion":228,"nodeVersion":"v18.15.0","syncVersion":32,
 "buildDate":"2024-05-30T06:59:06+02:00","buildRevision":"95d46b7ce7e0036eeb72b43e1815cc5c00dc214c",
 "dataDirectory":"/home/cat/.local/share/trilium-data"}
App HTTP server starting up at port 37840

⇒ 与服务端同版本、同 syncVersion（32），同步门禁必然放行。

首次使用：连服务端

Options → Sync → Sync server host = https://trilium.atibm.com ＋ 服务端账号密码 → 首次下载整库
⚠️ 是双向同步：本地编辑会推回生产；搜索对中文分词弱，日常用属性/标签检索

现状与将来固化方案

  • 现状：手动落位，不经 nix 管理（与 ~/.hermes/tools/node-26.7.0-linux-x64 同一模式）⇒ 不参与 nix GC / 升级；没有写进 /etc/nixos。
  • 可选固化：① 自建 derivation（fetchzip + hash + makeDesktopItem，约 30 行）；② pkgs.buildFHSEnv 包一层。两者都要自己维护 URL + hash。
  • 若要在本地跑中文副本的服务端：用 nriver/trilium-cn:0.63.7 —— 别用 latest（新线 syncVersion 递增，会被服务端门禁拒）。

相关

  • 本机细节文件（含完整命令与哈希）：~/.hermes/notes/trilium-desktop-cn.md
  • 写入纪律（全量覆盖 / 矩阵逐行 / <br> 换行 / 写前 read）：skill trilium-notes、trilium-update-ckeditor5