Trilium笔记服务器在Linux下的安装与疑难排解指南

环境准备与安装方式选择

Trilium作为一款功能强大的分层笔记应用，在Linux系统下提供两种运行模式：桌面版（基于Electron）和服务器版（Node.js）。根据用户硬件环境的不同，需要选择适合的安装方式：

1. 桌面版：适合个人单机使用，提供完整的GUI界面
2. 服务器版：适合需要远程访问或多设备同步的场景

常见安装问题分析

1. 模块依赖缺失问题

在桌面版运行时出现的Cannot find module 'cls-hooked'错误，通常是由于Electron打包时依赖解析不完整导致。这属于Electron应用打包的常见问题，解决方案包括：

• 使用npm rebuild重新编译原生模块
• 检查node_modules目录完整性
• 确保系统已安装所有构建依赖（如gcc、make等）

2. Node.js版本冲突

服务器版运行时出现的NODE_MODULE_VERSION不匹配错误（如108与120版本冲突），这是由于系统Node.js版本与预编译二进制模块不兼容导致。深层原因在于：

• Node.js的ABI(应用二进制接口)在不同主版本间不兼容
• better-sqlite3等包含原生代码的模块需要针对特定Node版本编译

解决方案包括：

# 清除现有node_modules并重新安装
rm -rf node_modules package-lock.json
npm install

# 或针对特定Node版本重建原生模块
npm rebuild --target=21.6.2

3. 数据库初始化失败

当访问/setup页面出现空白时，通常伴随以下日志：

Error: Router not found for request GET /assets/v0.63.5/app/setup.js

这表明前端资源未能正确加载，可能原因包括：

• 构建过程不完整
• 静态文件路径配置错误
• 权限问题导致资源无法访问

推荐安装方案

从源码构建（最可靠方式）

1. 克隆官方仓库
2. 安装构建依赖：

npm install cheerio html2plaintext

3. 完整构建：

npm install && npm run build

4. 启动服务器：

npm run start-server

预编译版本使用要点

1. 下载对应架构的server版本压缩包
2. 解压后直接运行启动脚本：

./trilium.sh

3. 若出现模块版本问题，建议：

• 使用nvm管理Node.js版本
• 匹配预编译版本要求的Node环境

性能优化建议

对于低配置设备（如报告中的Intel Pentium N3700）：

1. 启用安全模式减少内存占用：

TRILIUM_SAFE_MODE=1 npm start

2. 调整数据库缓存大小
3. 禁用非必要插件
4. 定期优化数据库文件

总结

Trilium在Linux下的安装问题多源于运行环境配置不当。通过源码构建虽然步骤较多，但能确保所有依赖正确解析。对于生产环境使用，建议：

1. 固定Node.js版本
2. 使用systemd管理进程
3. 定期备份数据目录
4. 关注日志中的警告信息

遇到问题时，检查日志中的错误堆栈并匹配运行环境要求，通常能快速定位问题根源。对于嵌入式设备等特殊环境，可能需要考虑定制构建方案。