Trilium Docker 安装

一、核心痛点与软件介绍

Trilium Docker 安装 为需要在容器化环境中使用 Trilium 的用户提供了统一的部署方式。它通过 Docker 镜像封装了完整的笔记系统，避免了在不同操作系统上手动配置依赖的繁琐。相较于传统的本地安装方式，使用 Docker 可以一次构建、随处运行，并且升级回滚更加简便。

二、环境要求与官方下载

Trilium Docker 运行依赖 Docker 引擎，建议使用 Docker Desktop（Windows/macOS）或 Docker CE（Linux）。具体的系统版本、CPU 架构和内存需求请参考官方文档，以官网为准。

获取最新的 Trilium 镜像无需手动下载文件，只需在终端执行 docker pull 命令，镜像来源同样在官方页面说明。

三、保姆级安装步骤

以下步骤覆盖 Windows、macOS 与 Linux 三大平台，确保即使是第一次接触 Docker 的用户也能顺利完成部署。

Windows 端

1. 访问 Docker 官方站点，下载安装 Docker Desktop for Windows，双击下载的安装程序。
2. 弹出 UAC 窗口时点击是，按照向导完成安装，期间会提示是否启用 WSL 2，建议保持默认勾选并点击确定。
3. 安装完成后启动 Docker Desktop，等待右下角状态从“Starting”切换到“Running”。
4. 打开 PowerShell，执行 docker pull zadam/trilium:latest 拉取官方镜像。
5. 运行容器：docker run -d -p 8080:8080 --name trilium -v trilium-data:/root/trilium-data zadam/trilium:latest。其中 -p 8080:8080 映射端口，-v trilium-data:/root/trilium-data 用于持久化数据。
6. 在浏览器访问 http://localhost:8080 即可进入 Trilium 界面。

macOS 端

1. 从 Docker 官方下载 Docker Desktop for Mac（.dmg 文件），双击打开后将图标拖入 Applications 文件夹。
2. 首次运行时系统会弹出安全提示，前往 系统设置 → 隐私与安全性 → 允许来自已识别开发者的应用，点击仍然打开。
3. 启动 Docker Desktop，待状态栏显示“Docker is running”。
4. 打开终端，执行 docker pull zadam/trilium:latest。
5. 使用以下命令启动容器：docker run -d -p 8080:8080 --name trilium -v trilium-data:/root/trilium-data zadam/trilium:latest。
6. 在 Safari 或其他浏览器访问 http://localhost:8080 完成登录。

Linux 端

1. 根据发行版使用包管理器安装 Docker Engine，例如在 Ubuntu 上执行 sudo apt-get update && sudo apt-get install docker-ce docker-ce-cli containerd.io。
2. 安装完成后，使用 sudo systemctl start docker 启动服务，并确保 sudo systemctl enable docker 设为开机自启。
3. 拉取镜像：sudo docker pull zadam/trilium:latest。
4. 运行容器：sudo docker run -d -p 8080:8080 --name trilium -v trilium-data:/root/trilium-data zadam/trilium:latest。
5. 通过 http://<服务器IP>:8080 访问界面。

四、首次启动快速配置

容器启动后，打开浏览器访问对应地址，会看到 Trilium 的初始化向导。推荐的基础设置如下：

• 语言选择：中文（简体）
• 默认笔记本：保持“根笔记本”不变，后续可自行创建子笔记本。
• 同步方式：若需要多设备同步，可在设置 → 同步 中启用 WebDAV，填写自建服务器地址。
• 安全选项：在设置 → 安全 中勾选“启用 HTTPS”，并在容器外部挂载证书文件（可选）。

所有配置均在浏览器内完成，无需编辑容器内部文件。

五、常见安装报错解决方案（FAQ）

症状一：执行 docker pull 时出现 “Error response from daemon: pull access denied”。
解决办法：确认网络可以访问 Docker Hub，若在国内可使用镜像加速站点，或在 Docker Desktop 设置中配置代理。

症状二：容器启动后访问 http://localhost:8080 报 502 Bad Gateway。
解决办法：检查本机防火墙是否阻止 8080 端口，或在 docker ps 中确认容器状态为 “Up”。必要时重新启动容器。

症状三：数据卷 trilium-data 权限异常，导致笔记无法保存。
解决办法：在 Linux 上执行 sudo chown -R $(whoami):$(whoami) /var/lib/docker/volumes/trilium-data/_data，或在 Windows/macOS 中确保 Docker Desktop 对磁盘的共享已开启。

六、优缺点

优点

• 一次拉取即可在多平台统一运行，省去繁琐的依赖安装。
• 数据持久化通过 Docker Volume 实现，容器重建不丢失笔记。
• 官方镜像维护及时，安全性有保障。
• 可以通过 Docker Compose 扩展为集群部署，满足企业级需求。

缺点

• 首次使用 Docker 需要一定的学习成本，对完全不熟悉容器的用户有门槛。
• 若宿主机资源紧张，容器性能可能受限，需要自行调优。

同类软件推荐

以下是与本文软件定位相近、可相互替代的同类工具，便于按需选型：

• Joplin（本站已收录，点击查看下载与教程）
• Standard Notes（本站已收录，点击查看下载与教程）
• Notable（本站已收录，点击查看下载与教程）