Trilium 介绍与选型指南

目标：全面介绍 Trilium（TriliumNext/Trilium）这款层级式个人知识库应用，并给出与 Obsidian、Joplin、Logseq、思源笔记、Notion 的量化选型对比。本篇全部结论来自官方站点、官方仓库与官方文档的联网溯源，逐条标注来源与查询日期（查询日期统一为 2026-10-22），不包含本地实测推断；部署实操见本专栏《Trilium v0.106.0 Docker Compose 部署指南》，配置见《Trilium v0.106.0 配置参数详解》，API 见《Trilium v0.106.0 常用 CLI 命令与工具详解》。

一、环境信息

• 溯源方式：仅联网检索官方一手资料，未混入本地实测结论。所有数据均可通过下列来源复核。
• 主要来源：官方文档站 docs.triliumnotes.org、官方仓库 github.com/TriliumNext/Trilium（v0.106.0 标签的 README/LICENSE/docker-compose.yml）、GitHub Releases API、Docker Hub 官方页 hub.docker.com/r/triliumnext/trilium、shields.io 徽章接口（星数与拉取量取证，未直连 api.github.com 计数接口）、repology.org 打包状态页。
• 查询日期：2026-10-22。
• 核心版本结论：官方最新稳定版为 v0.106.0，发布于 2026-09-25（来源：GitHub Releases 页与 Releases API，prerelease: false）；其后的 web-clipper-v1.2.0-rc1（2026-10-12）为浏览器剪藏扩展的 Pre-release，非主程序版本。
• 运行基线：官方 Docker 镜像内置 Node.js 24.21.0 运行时（来源：镜像构建元数据与 v0.106.0 官方镜像说明）；单机单服务架构，数据落 SQLite。

二、软件概述

2.1 定位与一句话简介

Trilium Notes 是一款免费开源、跨平台的层级式笔记应用，专注构建大型个人知识库（来源：v0.106.0 README 第 13 行原文："Trilium Notes is a free and open-source, cross-platform hierarchical note taking application with focus on building large personal knowledge bases"，查询日期 2026-10-22）。其显著特点是任意深度的笔记树、单笔记可克隆到树中多个位置、细粒度笔记加密、脚本与属性体系驱动的可扩展性，官方明确宣称"在可用性与性能上可扩展至 10 万条以上笔记"（来源：v0.106.0 README Features 节）。

2.2 上游沿革：zadam/trilium 停止维护与 TriliumNext 接棒（重要事实溯源）

这是选型前必须搞清楚的一件事，逐条标注来源：

• 原作者停止维护：Trilium 原作者 zadam（GitHub ID zadam）发布的最后一个主程序版本是 v0.63.7（来源：v0.106.0 README「Migrating from Zadam/Trilium?」节原文："the latest zadam/trilium version of v0.63.7"，查询日期 2026-10-22）。此后原作者不再推进主线开发。
• 社区延续项目：TriliumNext 是社区接续项目。v0.106.0 README「Why TriliumNext?」节原文："The original Trilium developer (Zadam) has graciously given the Trilium repository to the community project which resides at https://github.com/TriliumNext"——即原作者**把原仓库移交给社区项目**，而非简单归档冻结（来源：v0.106.0 README，查询日期 2026-10-22）。
• 原地址现状：GitHub API 访问 zadam/trilium 返回 301 重定向至 TriliumNext/Trilium（Repositories API 返回 "full_name":"TriliumNext/Trilium"、"archived":false、38,433 stars、最近 push 时间 2026-10-21），即旧仓库地址会自动跳转到社区延续仓库，星数也随仓库沿革延续（来源：GitHub Repositories API + shields.io 星数徽章，查询日期 2026-10-22）。
• 版本兼容与迁移：官方明确"从 zadam/Trilium 迁移到 TriliumNext/Trilium 没有特殊迁移步骤，按常规安装 TriliumNext 即可直接沿用既有数据库"；同时警示：TriliumNext v0.90.4 及之前版本与 zadam v0.63.7 同步兼容，更晚版本的 sync 版本已递增，无法与旧版 zadam 客户端直接同步（来源：v0.106.0 README 迁移节，查询日期 2026-10-22）。
• 维护方与治理：当前主仓库为 TriliumNext/Trilium，主开发者 Elian Doran（GitHub eliandoran），社区渠道为 Matrix（桥接 XMPP）、GitHub Discussions/Issues；接受 GitHub Sponsors/PayPal/Buy Me a Coffee 赞助（来源：v0.106.0 README「Discuss with us」「Support」节）。

2.3 版本节奏（官方 Releases 实查）

来源：GitHub Releases API（repos/TriliumNext/Trilium/releases），查询日期 2026-10-22。

解读：约 1~2 个月一个 minor 版本、重要缺陷随时补丁，另有每日构建的 nightly 标签（来源：README「Download」节："Nightly build – unstable development version, updated daily"）。生产部署建议锚定稳定版 tag（如 v0.106.0）而非 latest，官方 compose 文件自身也注释提醒"Using latest may cause unintended updates"（来源：v0.106.0 仓库根 docker-compose.yml 注释）。

三、核心架构

3.1 技术栈组成（官方声明）

来源：v0.106.0 README「Shoutouts」节（查询日期 2026-10-22）。Trilium 明确点名其依赖的底层技术：

运行时：Node.js（官方 Docker 镜像内置 Node 24.21.0，来源：镜像构建元数据，查询日期 2026-10-22）；存储：SQLite 单库 document.db（来源：官方服务器安装文档与数据目录结构，目录内含 document.db/document.db-wal/document.db-shm，备份产出 backup-<名称>.db，查询日期 2026-10-22）。

3.2 部署形态

3.3 同步模型

Trilium 采用自托管同步服务器模型：一台服务器作为同步中心，桌面端/移动端与之同步（来源：README Features："Synchronization with self-hosted sync server"；docs.triliumnotes.org 同步章节，查询日期 2026-10-22）。首次启动服务器实例时官方界面提供两个选项：New document（作为新文档/同步服务器） 或 Sync from server（从既有服务器同步种子数据）（来源：docs.triliumnotes.org 服务器安装文档对初始化选项的说明，查询日期 2026-10-22）。第三方托管同步服务在官方文档中亦有列举（来源：README 同步小节链接）。

💡 技术拓展：个人知识库的同步模型不止「自托管同步服务器」一种，常见选项对比——

同步模型	原理/特点	代表产品
自托管同步服务器	私有服务器作同步中心，数据主权完全自持	Trilium、Joplin Server、思源
网盘/文件层同步	笔记即文件，靠 Dropbox/iCloud 等文件同步	Obsidian（配合网盘）、Logseq
端到端加密 SaaS	官方云托管，免运维但数据在第三方	Notion（云端）、Obsidian Sync

Trilium 实际采用「自托管同步服务器」模型，并以 sync 版本号机制保证客户端与服务器协议一致——这也是上文"v0.90.4 之后无法与 zadam v0.63.7 直接同步"的原因。

四、功能特性

来源均为 v0.106.0 README「Features」节与 v0.106.0 Release Notes（查询日期 2026-10-22）。

4.1 笔记与编辑

• 笔记树任意深度，单笔记可克隆（clone）到树中多个位置；
• 富文本所见即所得编辑器（表格、图片、数学公式，支持 Markdown 自动格式化）；
• 代码笔记（语法高亮，CodeMirror）；
• 笔记版本管理（note revisions）无缝内建；
• 属性（attributes）体系：标签与关系可用于组织、查询与高级脚本；
• 全文搜索与**笔记提升（hoisting）**导航；
• 画布（Excalidraw）、思维导图（Mind Elixir）、关系图/链接图、地理地图（Geo map，含位置标记与 GPX 轨迹）。

4.2 安全与共享

• 细粒度笔记加密（protected notes，按笔记粒度）；
• 服务端 OpenID 与 TOTP 双因素登录集成（docs.triliumnotes.org user-guide/setup/server/mfa）；
• 分享（Sharing）：把单棵笔记子树发布到公网；
• 会话 cookie 有效期、可信反代等服务器安全项可在 config.ini 控制（详见《Trilium v0.106.0 配置参数详解》）。

4.3 自动化与运维

• ETAPI：官方 REST API 用于自动化（docs.triliumnotes.org user-guide/advanced-usage/etapi），容器内附带 OpenAPI 规范文件；
• v0.106.0 启动日志显示已内建 MCP server（注册于 /mcp 路径，需 ETAPI token），可直接被 MCP 客户端调用；
• Metrics 指标端点 + Grafana Dashboard（README Features 末条与 docs metrics 章节）；
• 数据库备份、每日自动备份机制（服务器数据目录 backup/ 子目录，官方文档备份章节）。

4.4 v0.106.0 版本亮点（Release Notes 实查）

• 看板（Kanban）大改版：列支持图标/颜色/卡片上限/折叠归档，新增 Inbox 列、模板创建卡片、全键盘操作；
• 搜索显著增强：标点感知精确匹配、模糊容差按词长分级、Google 风格结果卡片、点击结果跳转到匹配处；
• Geo map 内建地点搜索、当前位置指示与形状绘制（路径/区域/矩形/圆）；
• 模板可定义新笔记默认父级（~template:newNoteDefaultParent 关系）；
• OCR 同时支持扫描图像型与矢量型 PDF；
• 内建加载屏（替代白屏）、文本笔记可插入图标。

4.5 生态

• 官方浏览器Web Clipper 剪藏扩展（Chrome/Firefox，随 v0.106 提供 v1.x 独立版本节奏）；
• 社区精选 awesome-trilium（第三方主题/脚本/插件）与社区站 TriliumRocks!（教程与指南）；
• 翻译社区 Weblate（支持简繁中文等 20+ 语言，README 语言切换器）。

五、快速开始（最小可用示例）

以下均为官方文档给出的官方推荐路径（来源标注；本篇不含本地实测结论，完整实测部署流程见《Trilium v0.106.0 Docker Compose 部署指南》）。

5.1 路径 A：桌面版（个人本地使用）

从 GitHub Releases「Latest release」下载对应平台压缩包，解压后运行 trilium 可执行文件（来源：v0.106.0 README「Windows / MacOS」与「Linux」节）。Linux 发行版亦可通过发行版包安装（repology 打包状态徽章覆盖 Debian/Arch/Fedora 等渠道，来源：README repology.org 徽章链接）。

5.2 路径 B：服务器 Docker 部署（自托管同步/Web 使用，官方推荐自托管形态）

官方 Docker 安装文档给出的最小步骤（来源：docs.triliumnotes.org/user-guide/setup/server/installation/docker，查询日期 2026-10-22）：

# 1. 获取官方 docker-compose.yml（来源：官方 Docker 安装文档原命令）
wget https://raw.githubusercontent.com/TriliumNext/Trilium/master/docker-compose.yml

# 2. 后台启动（官方原命令）；默认数据目录 ~/trilium-data，默认端口 8080
docker compose up -d

官方 compose 的核心约定：镜像 triliumnext/trilium:latest（可用版本 tag 替换，官方注释建议锚定版本）；环境变量 TRILIUM_DATA_DIR=/home/node/trilium-data；数据卷挂载 ${TRILIUM_DATA_DIR:-~/trilium-data}；端口 8080:8080（来源：v0.106.0 仓库根 docker-compose.yml 原文）。官方同时提醒：Trilium 容器需要 root 权限运行；数据目录若在 SMB/CIFS 共享上需加 nobrl、noperm 挂载选项（来源：官方 Docker 安装文档 Prerequisites 节）。

5.3 初始化与登录

浏览器访问服务器 8080 端口后，首次进入会出现官方初始化选择页：New document（新建文档） 或 Sync from server（从服务器同步）——作为同步服务器或全新个人库选前者；作为已有服务器的从属实例选后者（来源：docs.triliumnotes.org 服务器安装/同步文档，查询日期 2026-10-22）。选择 New document 后按界面提示设置登录密码即可进入主界面（官方文档「Setting up a new sync / Setting up the desktop」流程说明）。

六、适用场景与限制

6.1 适用场景

• 大型个人知识库：官方明确定位（10 万条笔记量级可用性，README Features）；
• 多设备自托管同步：桌面 + 移动浏览器/原生客户端经自建服务器同步，数据完全自持；
• 对外发布/剪藏归档：Sharing 子树发布 + Web Clipper 网页剪藏；
• 自动化与集成：ETAPI REST + 内建 MCP + 脚本体系，可接 Grafana 监控实例指标；
• 敏感内容管理：按笔记粒度加密 + 服务端 TOTP/OIDC。

6.2 限制与注意（全部官方来源，查询日期 2026-10-22）

• 单用户定位：Trilium 是个人知识库应用，不是多用户协作 SaaS，无实时协同编辑能力（官方文档定位描述；与 Notion 类产品的核心差异）；
• 移动端形态：官方移动方案为移动 Web 前端与第三方客户端；README 特别提示 TriliumDroid 用户应关闭服务器自动更新，因为 Trilium 与 TriliumDroid 的 sync 版本必须匹配（README「TriliumDroid」节）；
• 容器需 root：官方 Docker 镜像要求 root 权限运行（官方 Docker 安装文档）；非 root 场景官方提供 rootless 变体镜像 triliumnext/notes:rootless（仓库根 docker-compose.rootless.yml）；
• 网络文件系统限制：数据目录放 SMB/CIFS 需 nobrl+noperm 挂载参数（官方 Docker 安装文档，引用上游 issue #415）；
• 上游沿革风险自查：v0.90.4 之后 sync 版本与 zadam 时代不再互通，跨"大版本代际"升级需按官方升级文档逐级处理（README 迁移节；docs 升级章节「Upgrading TriliumNext」）。

七、同类选型对比

7.1 量化对比表

星数取证方式：shields.io GitHub Stars 徽章 JSON 接口（如 https://img.shields.io/github/stars/TriliumNext/Trilium.json），查询日期统一为 2026-10-22；许可证取证：shields.io license 徽章与官方 LICENSE 文件。

关键差异解读：若数据主权与自托管是硬条件，Notion 直接出局；Obsidian 与 Logseq 是"本地文件"流派（Markdown 文件 + 文件同步），Trilium/Joplin/思源是"应用内库"流派（SQLite 或自有存储 + 应用层同步）。Trilium 的差异化在任意深度的笔记树 + 克隆多挂载 + 属性/脚本自动化，适合把知识库当"可编程个人数据库"用的用户。

7.2 上游归档/社区接续事实对选型的影响

• 原仓库 zadam/trilium 自 v0.63.7 后停止维护，社区延续项目 TriliumNext 接棒并继承原仓库地址与星数（来源与机制见 2.2 节，查询日期 2026-10-22）——评估"项目活跃度"时应以 TriliumNext/Trilium 的 Release 节奏（2.3 节，近 8 个月 8 个发布）与 push 时间（2026-10-21）为准；
• 若从 zadam 时代老版本（≤v0.63.7）升级，可直接安装 TriliumNext 沿用数据库，但同步协议代际（sync version）需按官方升级文档处理，不要让新版服务器与旧版 zadam 客户端直连同步（README 迁移节警示）。

7.3 「如果…则…」选型建议

• 如果要强树形层级 + 克隆 + 脚本自动化 + 完全自托管 → Trilium；
• 如果要纯本地 Markdown 文件 + 丰富插件生态，接受付费官方同步 → Obsidian；
• 如果要跨平台移动端体验 + Markdown + 多种自托管同步后端（含 WebDAV） → Joplin；
• 如果要大纲/白板式非线性思考 → Logseq；
• 如果要块级引用与中文生态优先 → 思源笔记；
• 如果要多人实时协作与开箱即用且可接受数据上云 → Notion。

八、参考链接

• 官方文档站：https://docs.triliumnotes.org/
• 官方仓库（社区延续主仓库）：https://github.com/TriliumNext/Trilium
• 原作者仓库地址（现重定向至社区仓库）：https://github.com/zadam/trilium
• 官方 Releases 页：https://github.com/TriliumNext/Trilium/releases
• 官方 Docker 镜像页：https://hub.docker.com/r/triliumnext/trilium/
• 官方 Docker 安装文档：https://docs.triliumnotes.org/user-guide/setup/server/installation/docker
• 官方 ETAPI 文档：https://docs.triliumnotes.org/user-guide/advanced-usage/etapi
• repology 打包状态：https://repology.org/project/trilium/versions
• 社区精选：https://github.com/Nriver/awesome-trilium；社区站：https://trilium.rocks/
• 本专栏实操篇：《Trilium v0.106.0 Docker Compose 部署指南》、《Trilium v0.106.0 配置参数详解》、《Trilium v0.106.0 常用 CLI 命令与工具详解》