Trilium Notes 是一款专注于构建大型个人知识库的开源笔记应用,支持层级化笔记管理、Markdown 编辑、版本控制以及加密等功能。由于原生对中文支持有限,社区中有经过汉化的版本可供使用。本文将演示如何在 Linux 环境下通过 Docker 容器化部署该服务,并结合内网穿透工具实现公网远程访问。
环境准备与安装
本教程基于 Ubuntu 18.04 环境。首先确保系统中已安装 Docker 和 Docker Compose。
sudo apt update
sudo apt install -y docker.io docker-compose
接下来在用户主目录下创建项目目录,用于存放配置文件和数据:
mkdir ~/docker/trilium-cn
cd ~/docker/trilium-cn
在该目录下新建 docker-compose.yml 文件。这里使用了社区维护的汉化镜像配置,主要包含端口映射、数据卷挂载及环境变量设置。注意将同文件夹下的 trilium-data 目录映射到容器内部,以确保笔记数据持久化。
version: '3'
services:
trilium-cn:
image: nriver/trilium-cn
restart: always
ports:
- "8080:8080"
volumes:
# 把同文件夹下的 trilium-data 目录映射到容器内
- ./trilium-data:/root/trilium-data
environment:
# 环境变量表示容器内笔记数据的存储路径
- TRILIUM_DATA_DIR=/root/trilium-data
# 可选功能:健康检查。需要启用的话,把下面的注释去掉
# healthcheck:
# test: ["CMD-SHELL", "curl --fail http://localhost:8080/api/health-check | jq -e '.status == \"ok\"' || exit 1"]
# interval: 30s
# timeout: 10s
# retries: 3
启动服务与本地测试
保存配置文件后,执行以下命令后台启动容器:
sudo docker-compose up -d
启动完成后,在浏览器访问 http://127.0.0.1:8080 即可进入初始化页面。首次使用需选择新用户并设置管理员密码。登录后的界面左侧为导航栏,右侧为内容区。初次使用时建议保留内置的示例笔记,其中包含了 Markdown 语法的使用技巧,有助于快速上手。


