Trilium Notes 数据库迁移与备份策略：保障你的知识安全

Trilium Notes 数据库迁移与备份策略：保障你的知识安全

【免费下载链接】trilium Build your personal knowledge base with Trilium Notes 项目地址: https://gitcode.com/gh_mirrors/tr/trilium

引言：知识数据的安全困境

你是否曾因数据库迁移失败丢失过重要笔记？是否担心过硬盘损坏导致数年积累的知识体系化为乌有？ Trilium Notes 作为一款强大的个人知识库软件，其数据安全直接关系到用户的知识资产。本文将深入剖析 Trilium 的数据库架构演进、迁移机制及备份策略，提供一套完整的知识安全保障方案，帮助你构建坚不可摧的数字知识堡垒。

读完本文你将获得：

• 理解 Trilium 数据库结构及迁移原理
• 掌握手动与自动备份的完整流程
• 学会迁移失败的恢复技巧
• 构建适合个人需求的备份策略
• 了解数据加密与安全存储最佳实践

Trilium 数据库架构解析

核心数据模型

Trilium 使用 SQLite 数据库作为存储引擎，采用实体-属性-值（EAV） 模型组织数据，主要包含以下核心表结构：

-- 核心表结构简化版
CREATE TABLE notes (
  noteId TEXT PRIMARY KEY,
  title TEXT NOT NULL,
  blobId TEXT,
  isDeleted INTEGER DEFAULT 0,
  dateCreated TEXT NOT NULL,
  dateModified TEXT NOT NULL
);

CREATE TABLE attributes (
  attributeId TEXT PRIMARY KEY,
  noteId TEXT NOT NULL,
  type TEXT NOT NULL,
  name TEXT NOT NULL,
  value TEXT,
  FOREIGN KEY(noteId) REFERENCES notes(noteId)
);

CREATE TABLE branches (
  branchId TEXT PRIMARY KEY,
  noteId TEXT NOT NULL,
  parentNoteId TEXT NOT NULL,
  isExpanded INTEGER DEFAULT 0,
  FOREIGN KEY(noteId) REFERENCES notes(noteId),
  FOREIGN KEY(parentNoteId) REFERENCES notes(noteId)
);

2022年重大架构演进：Blob存储方案

2022年的架构升级中，Trilium 引入了Blob存储机制，将笔记内容从notes表分离到独立的blobs表，这一变更显著提升了性能和数据安全性：

-- 引入Blob存储的迁移SQL (db/migrations/0215__content_structure.sql)
CREATE TABLE IF NOT EXISTS "blobs" (
  `blobId` TEXT NOT NULL,
  `content` TEXT NULL DEFAULT NULL,
  `dateModified` TEXT NOT NULL,
  `utcDateModified` TEXT NOT NULL,
  PRIMARY KEY(`blobId`)
);

ALTER TABLE notes ADD blobId TEXT DEFAULT NULL;
ALTER TABLE note_revisions ADD blobId TEXT DEFAULT NULL;

CREATE INDEX IF NOT EXISTS IDX_notes_blobId on notes (blobId);
CREATE INDEX IF NOT EXISTS IDX_note_revisions_blobId on note_revisions (blobId);

这一架构调整带来的优势：

• 内容去重：相同内容只存储一次，节省存储空间
• 性能优化：笔记元数据查询与内容检索分离
• 版本控制：更高效的修订历史管理
• 备份效率：可针对性备份元数据或内容数据

数据库迁移全流程解析

迁移机制核心原理

Trilium 的数据库迁移采用版本化增量迁移策略，每个迁移脚本负责特定版本的结构变更和数据转换。迁移脚本命名遵循[版本号]__[描述].sql/js格式，确保执行顺序和功能清晰。

db/migrations/
├── 0215__content_structure.sql    # 结构变更：创建blobs表
├── 0216__move_content_into_blobs.js # 数据迁移：内容迁移到blobs表
├── 0217__drop_content_tables.sql   # 清理：删除旧内容表
├── ...
└── 0228__fix_blobIds.sql          # 修复：Blob ID一致性修正

关键迁移案例：内容迁移到Blob存储

2022年的0216__move_content_into_blobs.js迁移是 Trilium 历史上最重要的数据迁移之一，其核心逻辑如下：

// 迁移核心代码片段
module.exports = () => {
  const sql = require('../../src/services/sql.js');
  const utils = require('../../src/services/utils.js');
  const existingBlobIds = new Set();

  // 处理笔记内容
  for (const noteId of sql.getColumn(`SELECT noteId FROM note_contents`)) {
    const row = sql.getRow(`SELECT noteId, content, dateModified FROM note_contents WHERE noteId = ?`, [noteId]);
    const blobId = utils.hashedBlobId(row.content); // 基于内容生成哈希ID

    if (!existingBlobIds.has(blobId)) {
      existingBlobIds.add(blobId);
      // 插入新blob记录
      sql.insert('blobs', {
        blobId,
        content: row.content,
        dateModified: row.dateModified,
        utcDateModified: row.utcDateModified
      });
    }
    
    // 更新笔记的blobId引用
    sql.execute('UPDATE notes SET blobId = ? WHERE noteId = ?', [blobId, row.noteId]);
  }

  // 验证迁移完整性
  const notesWithoutBlobIds = sql.getColumn("SELECT noteId FROM notes WHERE blobId IS NULL");
  if (notesWithoutBlobIds.length > 0) {
    throw new Error("迁移失败: " + JSON.stringify(notesWithoutBlobIds));
  }
};

迁移流程可视化

迁移操作实战指南

手动触发迁移（适用于开发或故障排除）

# 克隆官方仓库
git clone https://gitcode.com/gh_mirrors/tr/trilium.git
cd trilium

# 安装依赖
npm install

# 手动执行迁移（开发模式）
npm run start -- --migrate

迁移前的准备工作

1. 完整备份：执行迁移前必须备份整个数据目录

   # 默认数据目录位置
   # Windows: %APPDATA%\Trilium Notes
   # macOS: ~/Library/Application Support/Trilium Notes
   # Linux: ~/.local/share/Trilium Notes
   
   # 手动备份示例(Linux)
   cp -r ~/.local/share/Trilium\ Notes ~/.local/share/Trilium\ Notes_backup_$(date +%Y%m%d)
   

2. 检查迁移脚本完整性：

   # 验证迁移脚本数量
   ls -1 db/migrations/ | wc -l
   

3. 关闭 Trilium 所有实例：确保迁移过程中没有其他进程访问数据库

迁移后验证

# 检查blobs表是否有数据
sqlite3 ~/.local/share/Trilium\ Notes/trilium.db "SELECT COUNT(*) FROM blobs;"

# 验证笔记表与blobs表关联完整性
sqlite3 ~/.local/share/Trilium\ Notes/trilium.db "
  SELECT COUNT(*) FROM notes 
  LEFT JOIN blobs ON notes.blobId = blobs.blobId 
  WHERE blobs.blobId IS NULL AND notes.isDeleted = 0;"

正常情况下，第二个查询应返回0，表示所有非删除状态的笔记都有有效的blob引用。

备份策略：构建知识安全网

备份系统架构

Trilium 的备份系统基于多层级策略设计，结合了自动与手动备份、本地与远程存储，形成完整的数据安全保障体系：

自动备份机制详解

Trilium 的自动备份功能由src/services/backup.js实现，支持三种周期的备份策略：

// 自动备份核心逻辑
function regularBackup() {
  cls.init(() => {
    periodBackup('lastDailyBackupDate', 'daily', 24 * 3600);    // 每日备份
    periodBackup('lastWeeklyBackupDate', 'weekly', 7 * 24 * 3600); // 每周备份
    periodBackup('lastMonthlyBackupDate', 'monthly', 30 * 24 * 3600); // 每月备份
  });
}

备份配置与管理

1. 配置自动备份： 通过 UI 界面设置（设置 > 备份）或直接修改配置文件：

   # config.ini 备份相关配置
   [Backup]
   dailyBackupEnabled=true
   weeklyBackupEnabled=true
   monthlyBackupEnabled=true
   maxBackups=30
   

2. 备份文件命名规则：

   backup-daily.db      # 最新每日备份
   backup-daily-20231001.db  # 带日期的每日备份
   backup-weekly.db
   backup-monthly.db
   

3. 默认备份位置：

   • Windows: %APPDATA%\Trilium Notes\backups
   • macOS: ~/Library/Application Support/Trilium Notes/backups
   • Linux: ~/.local/share/Trilium Notes/backups

手动备份完全指南

使用内置备份功能

1. 通过界面操作：设置 > 备份 > 创建备份
2. 通过 API 调用：

   # 使用curl触发备份（需启用ETAPI）
   curl -X POST http://localhost:37840/etapi/backups \
     -H "Authorization: Token YOUR_ETAPI_TOKEN"
   

命令行高级备份

# 1. 数据库文件直接备份
sqlite3 ~/.local/share/Trilium\ Notes/trilium.db ".backup backup_$(date +%Y%m%d_%H%M%S).db"

# 2. 使用官方dump工具（支持加密备份）
cd dump-db
npm install
node dump-db.js --source ~/.local/share/Trilium\ Notes/trilium.db --output ~/backups/trilium_dump_$(date +%Y%m%d).zip --password "your_secure_password"

dump-db工具提供以下高级功能：

• 数据加密：使用AES-256加密备份内容
• 增量备份：仅备份变更数据
• 压缩优化：采用高压缩比算法减小备份体积

备份策略设计

3-2-1备份法则实施

遵循3-2-1备份法则构建你的备份策略：

• 3份数据副本：原始数据 + 本地备份 + 远程备份
• 2种不同存储介质：硬盘 + SSD/U盘
• 1份异地备份：云存储或异地服务器

实施示例：

不同用户场景的备份计划

用户类型	备份频率	推荐方案	存储空间需求
轻度用户	每周1次完整备份	自动每周备份 + 月度手动备份	500MB-2GB
中度用户	每日备份 + 每周完整备份	自动每日+每周备份 + 季度云备份	2GB-10GB
重度用户	实时备份 + 每日完整备份	WAL日志实时备份 + 自动每日备份 + 加密云同步	10GB-50GB
企业用户	连续数据保护	数据库复制 + 每小时增量备份 + 异地灾备	50GB以上

数据恢复与灾难应对

恢复操作全流程

从自动备份恢复

1. 定位备份文件：

   # 列出所有备份并按修改时间排序
   ls -lt ~/.local/share/Trilium\ Notes/backups/
   

2. 停止 Trilium 服务：确保所有 Trilium 进程已关闭

3. 执行恢复：

   # 替换当前数据库文件
   cp ~/.local/share/Trilium\ Notes/backups/backup-daily.db \
      ~/.local/share/Trilium\ Notes/trilium.db
   

4. 验证恢复结果：启动 Trilium 并检查笔记完整性

迁移失败的恢复

当数据库迁移失败时，按以下步骤恢复：

WAL日志恢复示例：

# SQLite Write-Ahead Logging恢复
sqlite3 ~/.local/share/Trilium\ Notes/trilium.db "PRAGMA wal_checkpoint(RESTART);"

# 如果上述命令失败，尝试：
sqlite3 -line ~/.local/share/Trilium\ Notes/trilium.db "
  PRAGMA integrity_check;
  PRAGMA wal_checkpoint(FULL);
  VACUUM;"

常见故障排除

数据库锁定问题

# 查找锁定数据库的进程
fuser ~/.local/share/Trilium\ Notes/trilium.db

# 终止锁定进程（谨慎操作）
kill -9 <进程ID>

备份文件损坏修复

# 检查备份文件完整性
sqlite3 backup_daily.db "PRAGMA integrity_check;"

# 尝试修复损坏的数据库
sqlite3 corrupted.db ".output fixed.db" ".dump"
sqlite3 fixed.db ".read dump.sql"

数据安全高级实践

数据库加密

Trilium 支持透明数据加密（TDE），保护你的敏感知识数据：

1. 启用数据库加密：

   # 通过命令行启用加密
   npm run start -- --encrypt-db --password "your_secure_password"
   

2. 加密原理：

安全存储最佳实践

1. 数据目录权限设置：

   # 限制数据目录访问权限
   chmod 700 ~/.local/share/Trilium\ Notes
   chmod 600 ~/.local/share/Trilium\ Notes/trilium.db
   

2. 备份文件加密：

   # 使用GPG加密备份文件
   gpg -c ~/.local/share/Trilium\ Notes/backups/backup-daily.db
   
   # 加密后删除原始备份
   rm ~/.local/share/Trilium\ Notes/backups/backup-daily.db
   

3. 使用安全的云存储：

   • 选择支持端到端加密的云存储服务
   • 使用加密文件系统如Cryptomator
   • 避免将未加密的备份文件直接上传到云存储

结论与最佳实践总结

知识安全保障清单

•  实施3-2-1备份策略
•  定期测试恢复流程（建议每季度1次）
•  启用数据库加密保护敏感内容
•  配置自动备份并验证其完整性
•  迁移前执行完整备份
•  监控备份存储健康状态
•  建立备份文件命名规范
•  定期清理过时备份文件

进阶路线图

1. 自动化监控：设置备份失败通知

   # 简单的备份监控脚本示例
   # 添加到crontab每日执行
   if ! sqlite3 ~/.local/share/Trilium\ Notes/backups/backup-daily.db "PRAGMA integrity_check;"; then
     echo "Trilium备份损坏" | mail -s "备份警报" your@email.com
   fi
   

2. 备份分析工具：开发自定义脚本分析备份内容

3. 多设备同步策略：结合同步与备份构建完整数据安全体系

4. 灾难恢复演练：定期模拟数据丢失场景测试恢复能力

通过本文介绍的迁移与备份策略，你已经拥有了保护知识数据的完整工具箱。记住，数据安全是一个持续过程，而非一次性任务。定期审查和改进你的备份策略，让你的知识资产在数字时代坚不可摧。

下期预告：《Trilium高级使用技巧：构建个人知识网络》—— 探索如何利用Trilium的关系图谱和属性系统构建真正的个人知识第二大脑。

如果你觉得本文有价值，请点赞、收藏并关注获取更多Trilium使用技巧和数据安全实践。如有任何问题或建议，欢迎在评论区留言讨论。

【免费下载链接】trilium Build your personal knowledge base with Trilium Notes 项目地址: https://gitcode.com/gh_mirrors/tr/trilium