还在用 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`。

| 能力 | 说明 |
|------|------|
| 层级笔记树 | 任意深度树状结构；单条笔记可通过 **克隆** 出现在多个位置 |
| 富文本 / Markdown | WYSIWYG 编辑器，支持表格、图片、LaTeX 公式 |
| 代码笔记 | 多语言语法高亮，可选 Vim 快捷键 |
| 笔记地图 | 可视化展示笔记间链接关系（知识图谱） |
| 日记（Journal） | 按年 / 月 / 日自动组织 |
| 加密保护 | 笔记级加密 + **保护会话** |
| 多设备同步 | 自托管服务器 + 桌面 / 移动客户端 |
| AI / MCP | 可配置 LLM；支持 MCP 供 AI 助手读写笔记 |

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

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

架构示意：

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

---

## 二、环境要求

| 项目 | 建议 |
|------|------|
| 操作系统 | Linux（本文 Ubuntu 24.04） |
| Docker | 已安装 Docker 与 Docker Compose V2 |
| 内存 | ≥ 1 GB（推荐 2 GB；大型知识库建议 4 GB） |
| CPU | 双核即可 |
| 磁盘 | ≥ 2 GB（镜像 + 笔记数据与附件） |
| 端口 | **8080**（Trilium 默认 Web 端口） |
| 工作目录 | `/www/wwwroot/trilium`（独立目录，勿与其他项目混用） |

验证 Docker：

```bash
docker --version
docker compose version
```

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

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

**镜像标签对照**：

| 标签 | 适用场景 |
|------|----------|
| `main` | 本文实测标签，**适合试用** |
| `v0.91.6` 等版本号 | **生产推荐**，固定版本便于备份与回滚 |
| `latest` | 可能自动升级，**不建议生产**（尤其有同步客户端时） |

---

## 三、拉取镜像并一键启动

### 3.1 创建数据目录

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

```bash
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 拉取镜像

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

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

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

| 官方镜像 | 轩辕镜像加速拉取 |
|----------|------------------|
| `triliumnext/trilium:main` | `docker pull docker.xuanyuan.run/triliumnext/trilium:main` |
| `triliumnext/trilium:v0.91.6` | `docker pull docker.xuanyuan.run/triliumnext/trilium:v0.91.6` |

### 3.3 启动容器

```bash
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，例如：

```text
c9d7c5cb8cb25d73b6686c1a275b3cb20e0e01a82c245fb63f8c8904571a9fcd
```

各参数说明：

| 配置 | 说明 |
|------|------|
| `-p 8080:8080` | 对外暴露 Web 访问端口 |
| `-v ...:/home/node/trilium-data` | **必须挂载**，持久化笔记数据库与附件 |
| `-e TZ=Asia/Shanghai` | 时区 |
| `--restart unless-stopped` | 宿主机重启后自动拉起 |

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

### 3.4 验证启动

```bash
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 选择语言

首次进入弹出 **语言** 选择，推荐 **简体中文**，点击 **继续**。
![Trilium 首次访问：语言选择，推荐简体中文](https://developer.qcloudimg.com/http-save/yehe-2813964/b8cb5e2e11bd3ca3d962ca7d406544d1.png)


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

### 4.2 新建知识库

点击 **新建知识库**（从一个全新的知识库开始）。若已有其他 Trilium 服务器或桌面版，可选 **连接到现有服务器** / **连接桌面应用** 同步。
![Trilium 初始化：选择新建知识库](https://developer.qcloudimg.com/http-save/yehe-2813964/d47879fd1adbc1134a5a8d36d5353df9.png)


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

### 4.3 演示内容 or 空白

推荐首次体验选 **包含演示内容**，快速了解 Trilium 能力；熟悉后可删演示笔记。从零开始选 **空白**。
![Trilium 初始化：包含演示内容或空白知识库](https://developer.qcloudimg.com/http-save/yehe-2813964/a866404e06648560829fa141c849d2b5.png)


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

### 4.4 等待知识库准备

选择后会出现 **正在准备你的知识库** 加载页，稍等片刻。
![Trilium 初始化：正在准备知识库](https://developer.qcloudimg.com/http-save/yehe-2813964/d8cdc2f6b04b4fad825324c97120143e.png)


*图 4：初始化加载中*

### 4.5 设置密码

填写 **登录密码** 与确认密码，点击 **设置密码**。Trilium 网页版为单实例单密码，非多用户账号体系。
![Trilium 初始化：设置登录密码](https://developer.qcloudimg.com/http-save/yehe-2813964/090be6a246f65d0bf9a85e25bdca60e8.png)


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

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

### 4.6 登录

输入刚才设置的密码，可勾选 **记住我**，点击 **登录**。
![Trilium 登录页：输入密码登录](https://developer.qcloudimg.com/http-save/yehe-2813964/36b1d33471c564ac90c2e4fa92127046.png)


*图 6：登录 Trilium Notes*

---

## 五、主界面与核心功能

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

### 5.1 日记与日历视图

**Journal** 按年 / 月 / 日组织笔记，中央可切换 **日 / 周 / 月 / 年 / 列表** 视图。
![Trilium 主界面：Journal 日记与月历视图](https://developer.qcloudimg.com/http-save/yehe-2813964/fff5166e58c64697818a5494af9ffbaf.png)


*图 7：Journal 月历视图*

### 5.2 创建笔记

在任意节点下 **新建笔记**，支持 **文本 / 画布 / 代码 / Markdown / 集合 / 模板** 等类型，顶部工具栏提供富文本格式化能力。
![Trilium 新建笔记：富文本编辑器与笔记类型切换](https://developer.qcloudimg.com/http-save/yehe-2813964/6355a2ab7fe81ccacd49a7f0f2d7505e.png)


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

### 5.3 全文搜索

点击左侧 **搜索** 图标，输入关键词或标签（如 `#calendarRoot`）进行全文检索，结果支持分页。
![Trilium 全文搜索：关键词与标签检索结果](https://developer.qcloudimg.com/http-save/yehe-2813964/5e97e9f3dd921c17ffb9c7094976633a.png)


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

### 5.4 快速搜索

弹出 **快速搜索** overlay：按名称或类型搜索，查看最近访问，或 **Ctrl + Enter** 触发全文搜索。
![Trilium 快速搜索：按名称搜索与最近访问](https://developer.qcloudimg.com/http-save/yehe-2813964/702a049d17b17a74fb1849be334c6995.png)


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

### 5.5 笔记地图

**笔记地图** 以节点与箭头可视化笔记间链接，适合梳理知识结构。
![Trilium 笔记地图：知识图谱可视化](https://developer.qcloudimg.com/http-save/yehe-2813964/65581da1abc804bd3f5142196b6614a9.png)


*图 11：Note Map 知识图谱*

### 5.6 最近修改

点击 **最近修改** 查看按时间排序的编辑历史，快速回到刚改过的笔记。
![Trilium 最近修改：按时间线查看编辑历史](https://developer.qcloudimg.com/http-save/yehe-2813964/71855be49e900d1297cf3681176321ba.png)


*图 12：最近修改时间线*

---

## 六、安全、设置与扩展

### 6.1 保护会话

访问加密笔记时，需输入密码进入 **保护会话**。点击左侧盾牌图标 → **开始保护会话**。
![Trilium 保护会话：输入密码访问加密笔记](https://developer.qcloudimg.com/http-save/yehe-2813964/379e5d82f24732dfc123924d1c85b7e3.png)


*图 13：保护会话二次验证*

### 6.2 外观设置

**选项 → 外观**：切换应用主题、配色方案（跟随系统 / 浅色 / 深色）、版面样式等。
![Trilium 选项：外观主题与深色模式](https://developer.qcloudimg.com/http-save/yehe-2813964/dbc267e4363f6ff384596aecee82e69f.png)


*图 14：外观与深色模式*

### 6.3 AI / LLM 与 MCP

**选项 → AI / LLM**：添加 LLM 提供商，启用 **AI 对话**；可开启 **MCP 服务器** 供 AI 助手读写笔记（默认仅本地访问）。
![Trilium 选项：AI 提供商与 MCP 配置](https://developer.qcloudimg.com/http-save/yehe-2813964/79025d8c5e3c08ad7416d301e1be531a.png)


*图 15：AI 提供商与 MCP 配置*

### 6.4 同步设置

**选项 → 同步**：填写 **服务器地址**，桌面版与移动版可与此 Docker 实例同步。内网测试可填 `http://服务器IP:8080`。
![Trilium 选项：同步服务器地址配置](https://developer.qcloudimg.com/http-save/yehe-2813964/044bbf4a5d0ac22214b9059cceace9c2.png)


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

### 6.5 代码笔记设置

**选项 → 代码笔记**：配置自动换行、制表符宽度、**Vim 快捷键**、CodeMirror 主题等。
![Trilium 选项：代码笔记编辑器与 Vim 配置](https://developer.qcloudimg.com/http-save/yehe-2813964/c986ea3e242d1fab4e83fc0788d85e1c.png)


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

---

## 七、生产环境简要说明

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

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

```yaml
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
```

```bash
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` 怎么办？**

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

**Q5：如何升级 Trilium？**

先备份 `trilium-data/`，再：

```bash
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 官方文档。建议使用强密码并妥善保存。

---

## 九、命令速查

| 操作 | 命令 |
|------|------|
| 拉取镜像 | `docker pull docker.xuanyuan.run/triliumnext/trilium:main` |
| 创建数据目录 | `sudo mkdir -p /www/wwwroot/trilium/trilium-data && sudo chown -R 1000:1000 /www/wwwroot/trilium/trilium-data` |
| 快速启动 | `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` |
| 查看日志 | `docker logs -f trilium` |
| 健康检查 | `curl -I http://127.0.0.1:8080` |
| Web 访问 | `http://服务器IP:8080` |
| 备份数据 | `tar czf trilium-backup-$(date +%F).tar.gz -C /www/wwwroot/trilium trilium-data` |
| 停止服务 | `docker stop trilium && docker rm trilium` |

---

## 总结

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
```
---

## 延伸阅读

| 主题 | 链接 |
|------|------|
| 轩辕镜像页 | 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 |
| 官方 docker-compose.yml | https://github.com/TriliumNext/Trilium/blob/main/docker-compose.yml |
| Nginx 反向代理 | https://docs.triliumnotes.org/user-guide/setup/server/installation/nginx-proxy-setup |
| 同步说明 | https://docs.triliumnotes.org/user-guide/setup/server/synchronization |
| 备份说明 | https://docs.triliumnotes.org/user-guide/setup/server/backup |
| 轩辕镜像 | https://xuanyuan.cloud |


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

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

还在用 Notion？Docker 部署 Trilium Notes，自建大型知识库

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

运维

开发工具

职业发展

TriliumNotes是一款免费开源、可自托管的层级笔记应用，支持深度笔记树、Markdown、思维导图和加密保护。本文提供TriliumNext的Docker一键部署教程，涵盖镜像拉取、数据目录配置、容器启动及浏览器初始化全流程，适合个人知识库搭建。支持多设备同步、AI集成和10万+笔记规模，数据完全自主掌控。

敏感信息加密

代码解释

数据丢失

云服务器

知识图谱

服务器

数据库

防火墙

MariaDB

Docker

容器

SQLite

GitHub

Linux

Nginx

Redis

2026上云采购 | AI焕新·智启新局

ES特惠专场，新客首购5.5折起！


腾讯云BI特惠9.9元起！


文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

还在用 Notion？Docker 部署 Trilium Notes，自建大型知识库-腾讯云开发者社区-腾讯云

还在用 Notion？Docker 部署 Trilium Notes，自建大型知识库

还在用 Notion？Docker 部署 Trilium Notes，自建大型知识库

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐