Trilium知识库系统在NixOS上的安装与配置指南

前言

NixOS作为一个基于声明式配置的Linux发行版，为系统管理带来了全新的范式。本文将详细介绍如何在NixOS系统上安装和配置Trilium知识库服务器，这是一个功能强大的分层笔记应用，特别适合个人知识管理和团队协作。

系统要求

在开始安装前，请确保您已经：

1. 安装并运行了NixOS操作系统
2. 拥有管理员权限以修改系统配置文件

基础安装配置

Trilium在NixOS中作为一个系统服务模块提供，配置过程简洁明了。以下是基础配置步骤：

1. 打开您的NixOS系统配置文件（通常位于/etc/nixos/configuration.nix）
2. 添加以下基础配置项：

services.trilium-server.enable = true;

这个最简单的配置会启用Trilium服务，并使用以下默认参数：

• 数据目录：/var/lib/trilium
• 监听地址：127.0.0.1（仅本地访问）
• 服务端口：8080

自定义配置选项

Trilium模块提供了多个可配置参数，您可以根据实际需求进行调整：

数据目录配置

如果您希望将Trilium数据存储在非默认位置，可以取消注释并修改以下配置：

services.trilium-server.dataDir = "/var/lib/trilium-sync-server";

注意：更改数据目录后，请确保：

1. 新目录存在且Trilium服务用户有读写权限
2. 如果是从旧位置迁移数据，需要手动移动数据文件

网络访问配置

默认配置下Trilium仅监听本地回环地址，如需从其他设备访问，需要修改监听设置：

services.trilium-server.host = "0.0.0.0";  # 监听所有网络接口
services.trilium-server.port = 12783;      # 使用自定义端口

安全提示：当设置为0.0.0.0时，请确保配置了适当的防火墙规则和认证措施。

高级配置选项

除了上述基本配置外，NixOS的Trilium模块还支持更多高级选项，包括：

1. Nginx反向代理配置
2. 自定义服务用户和组
3. 资源限制设置
4. 自动备份配置

您可以通过NixOS的选项查询功能查看所有可用配置项。

服务管理

配置完成后，使用以下命令应用更改：

sudo nixos-rebuild switch

服务管理命令：

• 启动服务：systemctl start trilium-server
• 停止服务：systemctl stop trilium-server
• 查看状态：systemctl status trilium-server

首次访问与初始化

服务启动后，您可以通过浏览器访问：

• 本地访问：http://localhost:8080
• 远程访问：http://<服务器IP>:<配置端口>

首次访问时需要设置管理员账户和密码，请务必妥善保管这些凭证。

维护与升级

由于NixOS的独特包管理机制，Trilium的升级将通过系统升级一起完成。定期执行系统更新即可获取最新版本的Trilium：

sudo nixos-rebuild switch --upgrade

结语

在NixOS上部署Trilium知识库系统是一个简单而高效的过程，得益于NixOS的声明式配置，您可以轻松地重现和迁移您的Trilium服务环境。本文介绍了基础配置方法，您可以根据实际需求进一步探索更多高级配置选项。