zadam/trilium

Trilium Notes Docker 镜像文档

镜像概述

Trilium Notes 是一款专注于层级结构的笔记应用，旨在帮助用户以树状结构组织和管理各类笔记内容。该 Docker 镜像封装了 Trilium Notes 应用，提供便捷的容器化部署方式，适用于个人或团队的知识管理场景。

核心功能与特性

• 层级结构管理：支持以树状层级组织笔记，构建清晰的知识体系
• 富文本编辑：提供丰富的文本格式化工具，支持图片、表格、代码块等内容插入
• 标签与关系：通过标签系统和笔记间关系定义，实现内容关联与快速检索
• 数据加密：支持笔记内容加密，保护敏感信息安全
• 数据导入导出：支持多种格式（如Markdown、HTML等）的笔记导入导出
• 跨设备同步：可通过数据目录挂载实现多设备间数据同步
• API支持：提供REST API，支持自定义集成与扩展

使用场景

• 个人知识管理：构建个人知识库，整理学习笔记、想法和资料
• 项目文档协作：团队项目文档的结构化管理与共享
• 研究笔记整理：学术研究、技术探索过程中的资料收集与梳理
• 日常工作记录：任务清单、会议纪要、工作日志的系统化管理

使用方法

基本部署（Docker Run）

bash
docker run -d \
  --name trilium \
  -p 8080:8080 \
  -v /path/to/local/data:/home/node/trilium-data \
  --restart unless-stopped \
  docker.xuanyuan.run/zadam/trilium:latest

• -p 8080:8080：映射容器端口到主机，默认使用8080端口
• -v /path/to/local/data:/home/node/trilium-data：挂载本地目录用于持久化存储笔记数据
• --restart unless-stopped：容器退出时自动重启（除非手动停止）

Docker Compose 配置

yaml
version: '3'
services:
  trilium:
    image: docker.xuanyuan.run/zadam/trilium:latest
    container_name: trilium
    ports:
      - "8080:8080"
    volumes:
      - ./trilium-data:/home/node/trilium-data
    restart: unless-stopped

访问应用

部署完成后，通过浏览器访问 http://<主机IP>:8080 即可打开 Trilium Notes 应用界面，首次使用需创建管理员账户。

配置参数

环境变量

• TRILIUM_DATA_DIR：指定数据存储目录，默认值为 /home/node/trilium-data
• PORT：指定应用运行端口，默认值为 8080
• NODE_ENV：运行环境，默认值为 production

数据持久化

必须通过卷挂载 (-v) 持久化 /home/node/trilium-data 目录，否则容器重启后笔记数据将丢失。

注意事项

• 首次启动时会自动创建初始数据库，耐心等待几秒后即可访问
• 建议定期备份挂载的本地数据目录，防止数据丢失
• 如需自定义端口，需同时修改容器端口映射和环境变量 PORT

更多详细信息请参考 https://github.com/zadam/trilium