Trilium Notes 是一款开源的层次化笔记软件，它以树状结构组织笔记，支持富文本、代码片段、数学公式、思维导图、关系图谱等丰富的笔记类型，并且内置了强大的全文检索和脚本扩展能力。对于希望在自有服务器上搭建私有知识库的用户来说，使用 Docker 容器化部署是目前最省心、最可控的方案。本文将从环境准备、容器配置、数据持久化到反向代理和安全加固，完整走一遍 Trilium 的容器化部署流程。
为什么选择容器化部署 Trilium
Trilium 官方提供了多种部署方式，包括 Windows 桌面客户端、Linux 桌面应用以及服务器版。桌面版是单机使用，数据存在本地；而服务器版可以部署在 VPS 或 NAS 上，通过浏览器访问，并支持多端同步。如果采用传统的裸机部署，需要手动安装 Node.js 环境、配置 systemd 服务、处理依赖冲突，升级时还要重新折腾一遍流程，维护成本比较高。
容器化部署则把整个运行环境打包成一个镜像，Node.js 版本、依赖库、启动脚本全部封装在内。部署时只需要一条 docker run 或一段 docker-compose 配置，升级镜像即可完成版本迭代，回滚也只需切换镜像标签。对于服务器上同时跑着多个服务的用户，容器还能提供良好的环境隔离，避免 Trilium 与其他应用的依赖产生冲突。
另外值得一提的是，Trilium 的全部数据就是磁盘上的一个文档目录，天然适合用 Docker 卷来管理。把数据目录挂载到宿主机后，即使容器被删除重建，笔记数据依然安全无虞，备份和迁移也变得非常简单——直接复制那个目录即可。
使用 Docker Compose 快速部署
推荐使用 Docker Compose 来管理 Trilium 容器，配置清晰且便于长期维护。首先在服务器上创建一个工作目录，例如 /opt/trilium，然后编写 docker-compose.yml 文件：
version: "3"
services:
trilium:
image: zadam/trilium:latest
container_name: trilium
restart: unless-stopped
ports:
- "8080:8080"
volumes:
- /opt/trilium/data:/root/trilium-data
environment:
- TRILIUM_PORT=8080这里有几个关键配置需要说明。镜像方面，官方镜像名为 zadam/trilium，可以在 Docker Hub 上查看可用的标签，生产环境建议固定具体版本号而不是用 latest，这样升级节奏由自己掌控。端口映射把容器内的 8080 端口暴露到宿主机，如果 8080 已被占用，可以把左侧改成其他端口，例如 9090:8080。
数据卷挂载是整个部署中最重要的部分。Trilium 服务器版默认把数据存放在 /root/trilium-data 目录，包括笔记数据库、附件和配置文件。我们将宿主机的 /opt/trilium/data 目录挂载进去，所有笔记内容就会持久化在宿主机上。如果忘记挂载这个卷，容器重建后所有笔记都会丢失，这是新手最容易踩的坑。
保存配置后执行以下命令启动服务：
docker compose up -d # 查看容器运行状态和日志 docker compose ps docker compose logs -f
启动成功后，通过浏览器访问 http://服务器IP:8080，首次进入会进入初始化向导。这里需要特别注意：如果是第一次使用，选择新文档选项创建全新的笔记库，并设置强密码；如果是从桌面版迁移过来，可以选择从本地文档同步，导入已有的笔记数据。
HTTPS 反向代理与安全加固
Trilium 本身只提供 HTTP 服务，如果直接暴露在公网上，密码和笔记内容都是明文传输，存在被嗅探的风险。标准的做法是在前面加一层 Nginx 反向代理，并配置 HTTPS 证书。假设你已经有了一个域名，可以用 certbot 签发免费的 Let's Encrypt 证书，Nginx 配置大致如下：
server {
listen 443 ssl;
server_name notes.ipipp.com;
ssl_certificate /etc/letsencrypt/live/notes.ipipp.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/notes.ipipp.com/privkey.pem;
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-Proto $scheme;
# WebSocket 支持，Trilium 同步需要
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
}
}有几点配置细节值得展开。首先是 WebSocket 支持，Trilium 的实时同步依赖 WebSocket 连接，如果没有配置 Upgrade 头，会遇到同步失败、页面提示连接断开的问题，这是反代配置中最常见的故障点。其次是建议把 Trilium 容器的端口只绑定到本机回环地址，修改 docker-compose 中的端口映射为 127.0.0.1:8080:8080，这样外部无法直接访问 8080 端口，所有流量必须经过 Nginx。
如果服务器上已经部署了 Nginx Proxy Manager、Traefik 或 Caddy 这类反向代理工具，配置会更简单。例如 Caddy 只需几行配置就能自动完成证书申请和续期：
notes.ipipp.com {
reverse_proxy 127.0.0.1:8080
}除了传输层加密，还可以进一步加固访问安全。比如在 Nginx 层叠加一层 HTTP Basic Auth 做双重认证，或者利用防火墙规则只允许特定 IP 段访问笔记服务。对于家庭 NAS 部署的场景，也可以通过 WireGuard 或 Tailscale 组网后仅在内网访问，完全不对公网暴露端口，安全性更高。
数据备份、升级与故障排查
笔记数据是最重要的个人资产，容器化部署后备份非常简单。Trilium 的全部数据都在挂载的 data 目录中，核心是其中的 document.db 这个 SQLite 数据库文件。最稳妥的备份方式是定期停止容器或使用 SQLite 的备份命令，避免在写入过程中直接复制数据库文件导致损坏。一个简单的定时备份脚本如下：
#!/bin/bash # 每日凌晨备份数据目录，保留最近7份 BACKUP_DIR=/opt/trilium/backup DATE=$(date +%Y%m%d) docker stop trilium tar -czf $BACKUP_DIR/trilium-$DATE.tar.gz -C /opt/trilium data docker start trilium # 清理7天前的备份 find $BACKUP_DIR -name "*.tar.gz" -mtime +7 -delete
配合 crontab 设置每天凌晨三点执行，即可实现自动化备份。如果追求零停机备份，也可以使用 sqlite3 的 .backup 命令在线导出数据库，再连同附件目录一起打包。
升级 Trilium 版本时，只需拉取新镜像并重建容器：
docker compose pull docker compose up -d
由于数据在宿主机卷中，升级过程不会影响笔记内容。不过建议升级前先做一次备份，并且查看官方的版本变更说明，个别大版本可能涉及数据库结构迁移，回退版本时需要注意兼容性。
常见的故障排查思路也值得一提。如果容器启动后立即退出，先用 docker logs trilium 查看日志，多数情况是数据卷挂载路径写错或者目录权限不足。如果页面能打开但同步异常，优先检查反向代理的 WebSocket 配置。如果出现搜索卡顿或界面缓慢，可能是服务器内存不足，Trilium 建议至少分配 512MB 内存，笔记量大的用户可以适当调高。另外，手机端访问可以通过 PWA 方式添加到主屏幕，配合官方的同步机制实现移动端笔记同步，体验接近原生应用。
总体而言，容器化部署 Trilium 的门槛并不高，核心就是镜像、端口、数据卷这三件事，再配好反向代理和定期备份，就能得到一套稳定、私有、跨平台可用的个人知识库系统。相比托管在第三方笔记服务上，数据完全掌握在自己手里，长期使用的安心感是完全不同的。