Docker 一键部署 Trilium Notes，轻松搭建大型知识库

还在用 Notion、语雀，笔记数据不在自己手里？Trilium Notes（TriliumNext 社区版）是一款 免费开源、可自托管的层级笔记应用——支持深度笔记树、富文本 / Markdown / 代码笔记、全文搜索、笔记地图、思维导图、加密保护、多设备同步，官方宣称可支撑 10 万+ 笔记 规模的知识库。单容器即可运行，无需 MariaDB / Redis，一条 docker run 就能上线。

不用装桌面客户端，一条 docker run 启动，浏览器完成初始化向导。本文带你完成 TriliumNext 一条命令 Docker 部署：从镜像拉取、创建数据目录、docker run 一键启动，到浏览器跟做首次向导（语言 → 新建知识库 → 设置密码 → 登录），再浏览日记、搜索、笔记地图、保护会话与 AI / 同步设置——全程零基础可跟做，下文附 17 张实测截图。

部署要点：TriliumNext 容器内数据目录为 /home/node/trilium-data（非旧版 zadam/trilium 的 /data）。轩辕镜像页部分示例仍写 /data，请以本文为准。

一、Trilium Notes 是什么？

Trilium Notes（现由 TriliumNext 社区维护）是一款 免费开源、跨平台的层级笔记应用，专为构建和管理 大型个人知识库 设计。Docker 镜像为 triliumnext/trilium。

典型使用场景：个人 大型知识库、学术研究笔记、项目文档、敏感信息加密存储。

与 Memos 的区别：Memos 偏轻量时间线随手记；Trilium 偏 深度层级组织 + 知识图谱 + 脚本自动化，适合笔记量大、结构复杂的用户。

架构示意：

浏览器 ──HTTP:8080──▶ Trilium 容器（内置 SQLite）
Trilium 容器 ──挂载卷──▶ 宿主机 trilium-data/（笔记数据库与附件）
桌面 / 移动客户端 ──同步协议──▶ 同一 Trilium 服务器

二、环境要求

验证 Docker：

docker --version
docker compose version

若尚未安装 Docker，可使用轩辕镜像一键脚本：

bash <(wget -qO- https://xuanyuan.cloud/docker.sh)

更多安装说明见轩辕镜像使用手册：

https://xuanyuan.cloud/usage

镜像标签对照：

三、拉取镜像并一键启动

3.1 创建数据目录

Trilium 必须将宿主机目录挂载到容器内 /home/node/trilium-data，否则重启后数据丢失。官方容器默认以 UID 1000 写数据：

sudo mkdir -p /www/wwwroot/trilium/trilium-data
sudo chown -R 1000:1000 /www/wwwroot/trilium/trilium-data
cd /www/wwwroot/trilium

权限踩坑：若日志出现 EACCES，执行 sudo chown -R 1000:1000 /www/wwwroot/trilium/trilium-data 后 docker restart trilium。

3.2 拉取镜像

docker pull docker.xuanyuan.run/triliumnext/trilium:main

成功时终端类似输出（Ubuntu 24.04 实测）：

main: Pulling from triliumnext/trilium
55afa1ecc21d: Pull complete
...
Status: Downloaded newer image for docker.xuanyuan.run/triliumnext/trilium:main

3.3 启动容器

docker run -d \
  --name trilium \
  --restart unless-stopped \
  -p 8080:8080 \
  -v /www/wwwroot/trilium/trilium-data:/home/node/trilium-data \
  -e TZ=Asia/Shanghai \
  docker.xuanyuan.run/triliumnext/trilium:main

成功时返回容器 ID，例如：

c9d7c5cb8cb25d73b6686c1a275b3cb20e0e01a82c245fb63f8c8904571a9fcd

各参数说明：

8080 已被占用时改 -p 8081:8080，浏览器访问 :8081。

3.4 验证启动

docker ps
docker logs -f trilium
curl -I http://127.0.0.1:8080

docker ps 中状态为 Up，且 curl 返回 HTTP 200 或 302 即表示启动成功。

四、浏览器首次初始化

浏览器打开（将 IP 换成你的服务器地址）：

http://你的服务器IP:8080

以下按实测向导顺序跟做。

4.1 选择语言

首次进入弹出 语言 选择，推荐 简体中文，点击 继续。

图 1：选择简体中文后点击「继续」

4.2 新建知识库

点击 新建知识库（从一个全新的知识库开始）。若已有其他 Trilium 服务器或桌面版，可选 连接到现有服务器 / 连接桌面应用 同步。

图 2：全新部署选「新建知识库」

4.3 演示内容 or 空白

推荐首次体验选 包含演示内容，快速了解 Trilium 能力；熟悉后可删演示笔记。从零开始选 空白。

图 3：推荐选「包含演示内容」快速上手

4.4 等待知识库准备

选择后会出现 正在准备你的知识库 加载页，稍等片刻。

图 4：初始化加载中

4.5 设置密码

填写 登录密码 与确认密码，点击 设置密码。Trilium 网页版为单实例单密码，非多用户账号体系。

图 5：设置强密码并妥善保存

安全提示：若对公网开放 8080，务必尽快完成初始化。生产环境建议关闭公网直连，改用反向代理 HTTPS。

4.6 登录

输入刚才设置的密码，可勾选 记住我，点击 登录。

图 6：登录 Trilium Notes

五、主界面与核心功能

登录成功后进入主界面。若选了演示内容，左侧会出现 Journal（日记）与 Trilium Demo 等节点。

5.1 日记与日历视图

Journal 按年 / 月 / 日组织笔记，中央可切换 日 / 周 / 月 / 年 / 列表 视图。

图 7：Journal 月历视图

5.2 创建笔记

在任意节点下 新建笔记，支持 文本 / 画布 / 代码 / Markdown / 集合 / 模板 等类型，顶部工具栏提供富文本格式化能力。

图 8：新建笔记，可切换笔记类型

5.3 全文搜索

点击左侧 搜索 图标，输入关键词或标签（如 #calendarRoot）进行全文检索，结果支持分页。

图 9：全文搜索与标签筛选

5.4 快速搜索

弹出 快速搜索 overlay：按名称或类型搜索，查看最近访问，或 Ctrl + Enter 触发全文搜索。

图 10：快速搜索与最近访问

5.5 笔记地图

笔记地图 以节点与箭头可视化笔记间链接，适合梳理知识结构。

图 11：Note Map 知识图谱

5.6 最近修改

点击 最近修改 查看按时间排序的编辑历史，快速回到刚改过的笔记。

图 12：最近修改时间线

六、安全、设置与扩展

6.1 保护会话

访问加密笔记时，需输入密码进入 保护会话。点击左侧盾牌图标 → 开始保护会话。

图 13：保护会话二次验证

6.2 外观设置

选项 → 外观：切换应用主题、配色方案（跟随系统 / 浅色 / 深色）、版面样式等。

图 14：外观与深色模式

6.3 AI / LLM 与 MCP

选项 → AI / LLM：添加 LLM 提供商，启用 AI 对话；可开启 MCP 服务器 供 AI 助手读写笔记（默认仅本地访问）。

图 15：AI 提供商与 MCP 配置

6.4 同步设置

选项 → 同步：填写 服务器地址，桌面版与移动版可与此 Docker 实例同步。内网测试可填 http://服务器IP:8080。

图 16：多设备同步服务器地址

6.5 代码笔记设置

选项 → 代码笔记：配置自动换行、制表符宽度、Vim 快捷键、CodeMirror 主题等。

图 17：代码笔记编辑器配置

七、生产环境简要说明

个人试用用第三节 单容器 docker run 即可。长期运行建议改用 Docker Compose，并配合 Nginx / Caddy 反向代理 HTTPS、定期备份 trilium-data/ 目录。

Compose 最小示例（生产建议将 main 换为固定版本如 v0.91.6）：

services:
  trilium:
    image: docker.xuanyuan.run/triliumnext/trilium:v0.91.6
    container_name: trilium
    restart: unless-stopped
    environment:
      - TRILIUM_DATA_DIR=/home/node/trilium-data
      - TZ=Asia/Shanghai
    ports:
      - "8080:8080"
    volumes:
      - ./trilium-data:/home/node/trilium-data
      - /etc/timezone:/etc/timezone:ro
      - /etc/localtime:/etc/localtime:ro

cd /www/wwwroot/trilium
docker compose up -d

从旧版 zadam/trilium 迁移：停止旧容器 → 用同一数据目录挂载到新镜像的 /home/node/trilium-data → 启动即可。v0.90.4 以上同步协议有变，跨版本迁移需查阅 TriliumNext 文档。

Nginx 反向代理文档（复制打开）：

https://docs.triliumnotes.org/user-guide/setup/server/installation/nginx-proxy-setup

八、常见问题 FAQ

Q1：轩辕镜像页写挂载 /data，为什么本文用 /home/node/trilium-data？

TriliumNext 官方镜像数据目录为 /home/node/trilium-data。/data 是旧版 zadam/trilium 写法。挂载错误会导致 数据未持久化，容器重建后笔记丢失。

Q2：8080 端口被占用怎么办？

将 -p 8080:8080 改为 -p 8081:8080，浏览器访问 http://服务器IP:8081。

Q3：数据存在哪里？

宿主机 /www/wwwroot/trilium/trilium-data，容器内 /home/node/trilium-data。删除该目录会丢失全部笔记。

Q4：权限报错 EACCES 怎么办？

sudo chown -R 1000:1000 /www/wwwroot/trilium/trilium-data
docker restart trilium

Q5：如何升级 Trilium？

先备份 trilium-data/，再：

docker pull docker.xuanyuan.run/triliumnext/trilium:v0.91.6
docker stop trilium && docker rm trilium
# 再执行第三节 docker run（数据卷不变）

Q6：容器启动后浏览器无法访问？

依次检查：docker ps 是否为 Up；docker logs trilium 是否报错；本机 curl -I http://127.0.0.1:8080 是否通；云服务器 安全组 / 防火墙 是否放行 8080。

Q7：忘记密码怎么办？

Trilium 无内置「忘记密码邮件」流程，需在服务器数据目录中重置，或参考 TriliumNext 官方文档。建议使用强密码并妥善保存。

九、命令速查

总结

Trilium Notes = 私有化大型层级知识库，单容器、一条命令就能跑：

• 使用轩辕镜像加速拉取 triliumnext/trilium:main
• 数据目录挂载到 /home/node/trilium-data（勿用旧版 /data）
• 一条 docker run 映射 8080 并持久化 trilium-data
• 浏览器完成初始化向导 → 设置密码 → 登录使用
• 支持日记、搜索、笔记地图、加密保护、AI 与多设备同步
• 长期运行可改用 Compose，配合备份与反向代理 HTTPS

延伸阅读（复制打开）：

TriliumNext 轩辕镜像页：

https://xuanyuan.cloud/zh/r/triliumnext/trilium

官方 Docker 文档：

https://docs.triliumnotes.org/user-guide/setup/server/installation/docker

TriliumNext 文档索引：

https://triliumnext.github.io/Docs/

GitHub 源码：

https://github.com/TriliumNext/Trilium

Docker Hub 镜像：

https://hub.docker.com/r/triliumnext/trilium

同步说明：

https://docs.triliumnotes.org/user-guide/setup/server/synchronization

备份说明：

https://docs.triliumnotes.org/user-guide/setup/server/backup

轩辕镜像首页：

https://xuanyuan.cloud

如果你在拉取 Docker 镜像时遇到速度慢、超时等问题，可以试试轩辕镜像的加速服务。欢迎收藏 triliumnext/trilium 镜像页，获取最新标签与更新说明：

https://xuanyuan.cloud/zh/r/triliumnext/trilium

Compose 完整配置、迁移说明、环境变量与更多 FAQ，详细步骤请查看：

https://xuanyuan.cloud/blog/docker-trilium

本文基于 triliumnext/trilium:main 镜像，Ubuntu 24.04 服务器实测（访问端口 8080）