Trilium Notes：开源层级笔记知识库安装与使用指南

官方信息

项目背景

Notion 好看但贵、数据在云端；Obsidian 强大但文件散落、同步要自己折腾；Logseq 大纲式但对大知识库不够友好。Trilium Notes 走的是第三条路——深度层级树状结构，一棵笔记树可以撑到 10 万+ 笔记，全文搜索、关系、属性、脚本、加密、多端同步全内置。

项目原作者 zadam 维护多年后，社区接手成立了 TriliumNext 团队持续开发，在 GitHub 上收获 30k+ Star。它的核心卖点是：单文件 SQLite 数据库、不需要 PostgreSQL/Redis 等任何外部依赖、Docker 一条命令跑起来、桌面端（Win/Mac/Linux）+ Web 端 + 移动端都有、笔记间双向链接、笔记地图（思维导图）、单笔记加密、JS 脚本自动化。

它特别适合程序员、研究者、笔记重度用户——你可以把整个文档库、读书笔记、代码片段、日记都组织成一棵大树，通过标签和关系在树外再建网状引用。

核心特性

• 深层树状结构：无限嵌套笔记，支持 10 万+ 规模。
• 富文本 + Markdown + 代码笔记：三种编辑模式随意切。
• 全文搜索：基于 SQLite FTS，秒级搜遍整个知识库。
• 双向链接与笔记关系：类似 Obsidian 的 backlink。
• 笔记地图：自动生成思维导图 / 关系图。
• 单笔记加密：AES-256 加密敏感笔记。
• JS 脚本自动化：可以写脚本批量处理笔记、定时任务。
• 多端同步：自建同步服务器，桌面端 + Web + 手机互相同步。
• REST API：外部程序可以读写笔记。

环境要求

• Docker（推荐）或 Node.js 16+（裸机部署）。
• 512MB 内存即可跑，数据量大了再升级。
• 磁盘：SQLite 单文件，1 万笔记大约占几百 MB。
• 开放端口 8080。

详细部署步骤

方式一：Docker 单容器（最推荐）

mkdir -p ~/trilium-data
docker run -d \
  --name trilium \
  --restart unless-stopped \
  -p 8080:8080 \
  -v ~/trilium-data:/home/node/trilium-data \
  -e TZ=Asia/Shanghai \
  triliumnext/trilium:latest

各参数说明：-v 把容器内数据目录挂载到宿主机，防止容器删了笔记丢了；--restart unless-stopped 开机自启；容器内路径是 /home/node/trilium-data（注意：旧版 zadam/trilium 是 /root/trilium-data，新版改了，别照抄老教程）。

方式二：Docker Compose

mkdir trilium && cd trilium
cat > docker-compose.yml <<'EOF'
services:
  trilium:
    image: triliumnext/trilium:latest
    restart: unless-stopped
    ports:
      - '8080:8080'
    volumes:
      - ./trilium-data:/home/node/trilium-data
      - /etc/timezone:/etc/timezone:ro
      - /etc/localtime:/etc/localtime:ro
EOF
docker compose up -d

方式三：rootless 镜像（生产推荐）

容器默认以 root 跑，更安全的做法是用 rootless 镜像：

docker run -d --name trilium \
  -p 8080:8080 \
  --user $(id -u):$(id -g) \
  -v ~/trilium-data:/home/trilium/trilium-data \
  triliumnext/trilium:rootless

首次访问与初始化

浏览器打开 http://服务器IP:8080。首次进入会引导你：

1. 选择语言（有简体中文）。
2. 新建知识库。
3. 设置密码——这个密码非常重要，丢了就找不回来，笔记里的加密内容也解不开。

没有默认账号密码，第一次就是你自己设的。

常见坑

• 国内拉镜像慢：用阿里云/ DaoCloud 加速器，或 docker pull docker.xuanyuan.run/triliumnext/trilium:latest。
• 权限报错：如果用 rootless 镜像，宿主机数据目录要先 chown -R 1000:1000 ~/trilium-data。
• 不要用 latest tag 跑生产：升级时可能跨版本不兼容，建议锁版本号如 triliumnext/trilium:v0.91.6。
• 备份：直接打包 ~/trilium-data 目录即可，里面就是 SQLite 文件。

使用方法示例

• 左侧树状栏右键 → New Note 新建笔记，支持无限嵌套。
• 笔记正文里用 [[笔记名]] 双向链接其他笔记。
• 右键笔记 → Protect Note 设置密码加密。
• 顶部菜单 → Tree → Note Map 查看笔记关系图。
• 桌面端：从官网下载 Win/Mac 安装包，登录同一同步服务器即可多端同步。

常见问题（FAQ）

Q1：和 Obsidian 比哪个好？
A：Obsidian 是本地 Markdown 文件 + 插件生态；Trilium 是服务端集中存储 + 自带多端同步 + 层级树。喜欢文件可控选 Obsidian，喜欢"一个服务器管所有设备"选 Trilium。

Q2：密码忘了怎么办？
A：Trilium 的密码是加密主密钥的一部分，忘了就真的进不去了，笔记里的加密内容也解不开。务必用密码管理器存好。

Q3：能装多少笔记？
A：官方宣称 10 万+ 笔记没问题，SQLite FTS 搜索依然很快。超过这个量级再考虑迁到服务端多实例。

Q4：手机怎么访问？
A：浏览器直接开 Web 端即可，响应式设计；也有第三方 Android 客户端。桌面端从官网下载。

跳转链接

• GitHub 仓库：https://github.com/TriliumNext/Trilium
• 官方网站：https://triliumnotes.org/
• Docker 镜像：triliumnext/trilium
• 桌面端下载：Get Started