Linux 系统 Docker 部署 Trilium Notes 及公网远程访问方案

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 语法的使用技巧，有助于快速上手。