Trilium Notes 知识管理工具搭建教程

Trilium Notes 是一款功能强大的开源个人知识管理工具，以层级笔记树为核心结构，支持富文本编辑、笔记间关系映射、自定义属性、代码笔记和强大的脚本扩展能力。它特别适合构建个人知识库和第二大脑系统。本教程将在搬瓦工 VPS 上通过 Docker 部署 Trilium Notes 服务端。

一、Trilium Notes 核心特性

层级笔记树：无限层级的笔记树结构，笔记可以被克隆（出现在多个位置），实现灵活的知识组织。
丰富的笔记类型：支持富文本、代码（含语法高亮）、关系图、书籍、Mermaid 图表等多种笔记类型。
笔记属性系统：为笔记添加标签（label）和关系（relation），构建知识之间的语义网络。
关系图谱：可视化展示笔记之间的关联关系，直观理解知识结构。
Web Clipper：浏览器扩展支持快速保存网页内容到 Trilium。
脚本扩展：通过 JavaScript 脚本自定义功能，实现自动化工作流。
端到端加密：支持笔记的端到端加密保护，确保敏感内容安全。

二、环境准备

操作系统：Ubuntu 20.04+（推荐 Ubuntu 22.04）。
内存：至少 512MB RAM，推荐 1GB。
磁盘：至少 5GB 可用空间（取决于笔记数量）。
Docker：已安装 Docker 和 Docker Compose（参考 Docker 安装教程）。

购买搬瓦工 VPS 请参考全部方案，使用优惠码 NODESEEK2026 可享受 6.77% 折扣。

三、Docker 部署 Trilium

3.1 创建项目目录

mkdir -p /opt/trilium && cd /opt/trilium

3.2 使用 Docker Compose 部署

cat > docker-compose.yml <<'EOF'
version: '3.8'

services:
  trilium:
    image: triliumnext/notes:latest
    container_name: trilium
    restart: always
    ports:
      - "8080:8080"
    environment:
      TRILIUM_DATA_DIR: /home/node/trilium-data
    volumes:
      - trilium_data:/home/node/trilium-data

volumes:
  trilium_data:
EOF

3.3 启动 Trilium

docker compose up -d
docker compose logs -f trilium

启动完成后，访问 http://你的服务器IP:8080。首次访问需要设置密码，这个密码用于保护你的 Trilium 实例。

四、Nginx 反向代理

cat > /etc/nginx/sites-available/trilium <<'EOF'
server {
    listen 80;
    server_name notes.example.com;

    client_max_body_size 50m;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}
EOF

ln -s /etc/nginx/sites-available/trilium /etc/nginx/sites-enabled/
nginx -t && systemctl reload nginx
certbot --nginx -d notes.example.com

五、Trilium 使用指南

5.1 笔记组织

Trilium 使用树形结构组织笔记。在左侧面板创建文件夹和笔记，支持无限嵌套。独特的"克隆"功能允许一个笔记出现在多个文件夹中而不产生副本，非常适合交叉引用。例如一篇关于 Docker 部署的笔记可以同时出现在"Docker"和"服务器运维"两个分类下。

5.2 属性与关系

Trilium 的属性系统是其最强大的功能之一。你可以为笔记添加标签属性（如 #priority=high）和关系属性（如 ~relatedTo=另一篇笔记）。然后通过搜索功能快速查找具有特定属性的笔记。属性还可以继承，子笔记自动继承父笔记的属性。

5.3 关系图谱

创建"关系图"类型的笔记，可以可视化展示笔记之间的关联关系。图谱自动根据笔记间的关系属性和链接生成节点和连线，帮助你发现知识之间的隐含联系。

5.4 代码笔记与脚本

Trilium 支持多种编程语言的代码笔记，带有语法高亮。更强大的是，JavaScript 类型的笔记可以作为脚本运行，访问 Trilium 的内部 API。你可以编写脚本来自动化操作，例如批量修改笔记属性、生成报告或创建自定义界面组件。

5.5 桌面端同步

Trilium 提供桌面客户端（Windows、macOS、Linux），可以与服务端进行同步。桌面端在本地存储完整的笔记数据库，即使断网也可以正常工作，联网后自动同步变更。配置同步只需在桌面端输入服务器地址和同步密码。

六、数据备份

Trilium 使用 SQLite 数据库，内置自动备份功能，默认每天创建备份。你也可以手动备份：

# 备份 Trilium 数据
docker cp trilium:/home/node/trilium-data /opt/trilium/backup_$(date +%Y%m%d)

# 或者直接备份数据卷
docker run --rm -v trilium_data:/data -v /opt/trilium:/backup alpine \
  tar czf /backup/trilium_backup_$(date +%Y%m%d).tar.gz -C /data .

七、升级 Trilium

cd /opt/trilium
docker compose pull
docker compose down
docker compose up -d

Trilium 在启动时会自动执行数据库迁移。升级前建议先备份数据。

总结

Trilium Notes 是一款深度强大的个人知识管理工具，属性系统和脚本扩展能力使其远超一般笔记应用。如果你更偏好 Markdown 笔记，可以参考 SilverBullet；偏好图谱化知识管理的用户可以看看 Logseq。购买搬瓦工 VPS 请参考全部方案，使用优惠码 NODESEEK2026 可享受折扣。更多教程请访问搬瓦工VPS中文网。