安装 Trilium 笔记后必须要做的操作，不做必后悔

shmaur

2025-09-10

- 字

trilium使用技巧

数据备份，这个事情一定要做。

一、备份的重要性

数据备份在防止数据丢失中起着不可替代的关键作用，主要体现在以下多个方面：

抵御硬件故障：硬盘或 SSD 等存储设备随时可能因各种原因损坏，如机械故障、电子元件老化等。一旦发生损坏，没有备份的数据将面临丢失风险，而备份数据能确保在硬件故障时重要文件依然可用。
应对系统崩溃：软件问题、系统更新失败或恶意软件攻击等都可能导致系统崩溃。此时，备份可帮助用户快速恢复重要资料，减少因系统故障导致的业务中断时间。
防范恶意软件威胁：勒索软件和病毒日益猖獗，它们可能会加密或删除用户数据，给用户带来巨大的经济和精神损失。有了备份，用户可以在遭受恶意软件攻击后迅速恢复数据，避免陷入困境。
防止人为误操作：人为因素是数据丢失的常见原因之一，例如误删文件、错误覆盖文件等。备份可以轻松恢复误操作导致的数据丢失，避免因一时疏忽造成不可挽回的后果。

二、服务器备份

1. 常规备份方式

（1）文件复制

Trilium 服务器版使用文档数据库存储数据，默认情况下，其数据目录通常位于特定位置。在 Linux 系统中，若通过常规安装，数据目录可能在~/.local/share/trilium-data ；

若使用 Docker 容器部署，数据目录则根据挂载目录配置，例如可能是 /root/trilium-data 。

在使用Docker的时候，一定要设置镜像文件。

docker run --net=mynet -d -p 127.0.0.1:8080:8080 -e "USER_UID=1001" -e "USER_GID=1001" -v ~/trilium-data:/home/node/trilium-data triliumnext/trilium:-latest

-v ~/trilium-data:/home/node/trilium-data 这个就是镜像文件，一定要记得做这一步操作

（2）硬链接备份

硬链接是一种在文件系统层面创建相同文件的不同引用方式，使用硬链接备份可以节省存储空间，且在恢复时操作相对简便。以 Windows 系统为例，假设 Trilium 数据目录为 C:\Users\username\AppData\Roaming\trilium-data ，要创建硬链接备份，可使用命令 < 代码开始 > mklink /h "C:\Backup\trilium\document-h.db" "C:\Users\username\AppData\Roaming\trilium-data\document.db" （这里的 "C:\Backup\trilium" 是备份路径，"document-h.db" 是备份文件名，"document.db" 是原数据库文件名）。通过硬链接备份后，当需要恢复时，只需将硬链接文件复制回原数据目录覆盖原有文件即可（需先停止 Trilium 服务）。

2. 自动化备份脚本

为了实现定期自动备份，提高备份的及时性和可靠性，可以编写自动化备份脚本。

（1）使用 Python 脚本结合 Trilium - Py 工具（适用于有编程基础用户）

首先需要安装 Trilium - Py 工具，可通过 pip 安装： pip install trilium - py 。
以下是一个简单的 Python 备份脚本示例

from trilium_py.client import ETAPI
import shutil
import os
import time

# 连接Trilium服务端
ea = ETAPI("http://localhost:8080", "your_token")
# 停止Trilium服务（假设通过系统命令停止，不同系统命令不同）

os.system("systemctl stop trilium")
# 备份数据目录到指定位置

backup_dir = f"/backup/location/trilium_backup_{int(time.time())}"
shutil.copytree("~/.local/share/trilium-data", backup_dir)

# 启动Trilium服务
os.system("systemctl start trilium")

在这个脚本中，先连接到 Trilium 服务端，然后停止服务，将数据目录复制到以当前时间戳命名的备份目录中，最后重新启动服务。你可以根据实际情况修改服务地址、认证令牌、数据目录路径和备份目录路径等参数。

三、客户端备份

1. 本地备份操作

（1）Windows 客户端

Windows 系统下，Trilium 默认将数据存储在 C:\Users < 用户名 >\AppData\Roaming\trilium-data 目录。

备份时，首先关闭 Trilium 客户端。然后，可选择将整个 trilium-data 目录复制到其他存储位置，如移动硬盘、U 盘或本地其他分区。

例如，将其复制到 D:\TriliumBackup 目录，可在文件资源管理器中找到源目录，右键选择 “复制”，再在目标目录中右键选择 “粘贴”。 Wdindow 客户端建议直接复制目录。

（2）Linux 客户端

在 Linux 系统中，数据目录一般为 ~/.local/share/trilium-data 。同样，先关闭 Trilium 客户端。接着，使用命令行工具进行备份，如 cp -r ~/.local/share/trilium-data/media/your_usb_drive/trilium_backup （这里 /media/your_usb_drive/ 是 USB 存储设备挂载路径，trilium_backup 是自定义的备份文件夹名）。

（3）MacOS 客户端

MacOS 下，Trilium 数据存储在 /Users/< 用户名 >/Library/Application Support/trilium-data 。关闭客户端后，可通过访达将该目录复制到备份位置，如外部硬盘。

2. 利用云盘实现同步备份

许多云盘服务，如 OneDrive、百度网盘、坚果云等，支持将本地文件夹与云端进行同步。可以利用这一功能实现 Trilium 客户端数据的备份与多设备同步。
以坚果云为例：

下载并安装坚果云客户端，登录账号。
在坚果云客户端中设置同步文件夹，选择一个本地文件夹作为同步目录，例如 <代码开始> D:\TriliumSync < 代码结束 > 。
关闭 Trilium 客户端，将 C:\Users < 用户名 >\AppData\Roaming\trilium-data （Windows 系统）目录下的所有文件和文件夹复制到坚果云同步目录 D:\TriliumSync 中。
打开 Trilium 客户端，在设置中找到数据目录相关设置，将数据目录路径修改为坚果云同步目录 D:\TriliumSync （不同系统路径设置方式可能略有不同）。
此后，当在 Trilium 客户端中进行笔记编辑等操作时，数据会自动同步到坚果云云端，同时在其他设备上登录坚果云并设置相同的 Trilium 数据目录后，也能实现数据同步和备份。

3. 自动备份设置

Trilium 提供了自动备份功能，可在软件内进行设置。打开 Trilium 客户端，点击左侧的菜单按钮，选择 “设置”。在设置页面中，找到 “备份” 相关选项，可设置自动备份的频率，如每每天、每周、每月。自动备份的文件会保存在软件默认的备份路径中，一般位于数据目录下的 backup 文件夹内。例如，在 Windows 系统中，自动备份文件路径可能为 C:\Users < 用户名 >\AppData\Roaming\trilium-data\backup 。虽然有自动备份功能，但建议还是定期手动检查备份文件的完整性，并结合云盘等方式进行额外备份，以确保数据的安全性。