Linux怎么安装和配置Trilium Linux开源个人知识库详解

在Linux上部署Trilium，最稳妥、最可控的方案永远是Docker Compose，而不是直接运行二进制包或配置systemd服务。后者常常因为glibc版本、libstdc++.so.6库缺失或路径硬编码等问题而失败。Docker镜像已经预装了兼容的运行时环境，能彻底规避这些底层的ABI冲突。

部署核心要点：使用Docker Compose；必须正确配置端口映射、数据卷（需用绝对路径）和环境变量；首次访问务必设置密码并手动切换界面语言为中文；备份需先停止容器或使用sqlite3命令导出，避免使用NFS等网络存储。

那么，为什么说直接运行trilium-cn-linux-x64-server.zip这类包是个隐患呢？

为什么不推荐直接运行官方二进制包

这个包本质上是将Electron桌面版封装成了服务端，它严重依赖宿主机上特定版本的C++运行时。在Ubuntu 22.04或CentOS 8等较新的系统上，你大概率会遇到这个报错：error while loading shared libraries: libstdc++.so.6: cannot open shared object file。手动去替换系统级的libstdc++.so.6库风险极高，而且每次系统更新都可能让之前的努力白费。相比之下，Docker方案提供了隔离且确定性的环境，一劳永逸。

Docker Compose配置中必须修改的三个关键项

很多官方示例配置过于理想化，忽略了实际部署环境的差异。以下三项必须根据你的实际情况调整，否则部署后可能无法访问或数据丢失：

• 端口映射（ports）：不要想当然地写成8080:8080。如果服务器的8080端口已经被Nginx或其他服务占用，直接修改映射的前半部分即可，例如- "9088:8080"。
• 数据卷（volumes）：映射路径必须使用绝对路径。使用相对路径如./trilium-data，在非交互式Shell（例如通过systemd启动）环境下可能会解析失败，导致数据存到意想不到的地方。正确的写法应该是：/opt/trilium/trilium-data:/root/trilium-data。
• 环境变量（environment）：TRILIUM_DATA_DIR这个环境变量的值，必须与上面volume映射中容器内的路径（即/root/trilium-data）完全一致。如果两者不匹配，容器启动后数据可能会写入一个临时目录，重启容器后所有记录就消失了。

首次启动后，必须立刻完成的两件事

容器成功运行只是第一步，如果不执行以下操作，后续可能会无法登录或界面一直是英文：

• 用浏览器访问http://<你的服务器IP>:9088（端口换成你实际映射的）。在首次打开的页面上，会立即弹出一个设置密码的对话框，你必须在此完成设置——这个密码没有找回机制，即使在trilium-data目录里也找不到明文存储。
• 设置密码并登录后，立刻点击右上角的头像，进入Options → Language，选择zh-CN，然后刷新页面。仅依靠Docker镜像自带的locale环境变量，通常无法自动完成界面语言的切换。

关于数据安全与备份的务实建议

很多人以为只要配置了volume数据卷就高枕无忧了。然而，trilium-data目录中的核心是一个SQLite数据库文件trilium.sqlite。它在写入时会被锁定，直接使用cp或rsync命令进行热备份，很可能得到一个正在被写入的、不完整的损坏副本。

• 最可靠的备份方式：先停止容器再进行文件拷贝。例如：docker compose down && cp -r /opt/trilium/trilium-data /backup/trilium-$(date +%F)。
• 在线备份方案：如果不想停止服务，可以使用sqlite3的导出功能：docker exec trilium-notes sqlite3 /root/trilium-data/trilium.sqlite ".dump" > backup.sql（注意，这里的容器名需要与你docker-compose.yml中定义的container_name保持一致）。
• 一个重要提醒：尽量避免将trilium-data目录挂载到NFS或者其他高延迟的网络存储上。SQLite对fsync操作的延迟非常敏感，网络存储可能导致编辑卡顿，甚至事务提交失败。

说到底，Trilium的价值不在于安装部署的速度有多快，而在于你积累的知识数据能否长期、安全地保存和迁移。用Docker部署只是一个稳健的开始，真正关键的是理解trilium-data目录的结构，以及哪些操作会破坏数据的原子性。备份不验证、密码不记录、路径不绝对——这三件事只要做错任何一件，都可能让数百个日夜的知识沉淀在瞬间变得无法恢复。