思源笔记 Docker 自托管部署指南

前言

思源笔记 是一款开源的本地优先笔记软件，核心特性包括块级引用、双向链接、SQL 查询、闪卡复习等。虽然它主打本地使用，但也支持 Docker 自托管，可以部署在自己的服务器上通过浏览器访问，实现多设备同步和随时随地笔记。

本文介绍如何用 Docker 部署思源笔记，并进行基础配置。

部署

创建目录

1

mkdir -p /你的路径/siyuan

Docker Compose

创建 docker-compose.yml：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

services:
  siyuan:
    image: b3log/siyuan:latest
    container_name: siyuan
    restart: unless-stopped
    ports:
      - "6806:6806"
    volumes:
      - ./siyuan-data:/siyuan/workspace
    environment:
      - TZ=Asia/Shanghai

端口和目录说明：

启动

1
2

cd /你的路径/siyuan
docker compose up -d

启动后访问 http://你的IP:6806 即可打开思源笔记。

设置访问密码

自托管部署后，默认任何人都可以访问。建议设置访问授权码：

在 docker-compose.yml 中添加环境变量：

1
2
3

environment:
  - TZ=Asia/Shanghai
  - SIYUAN_ACCESS_AUTH_CODE=你的密码

修改后重启容器：

1

docker compose up -d

再次访问时会要求输入授权码。

基础配置

创建笔记本

首次打开后：

1. 点击左下角 新建笔记本
2. 输入笔记本名称，如"工作笔记"、“学习笔记”
3. 在笔记本下创建文档开始编写

编辑器快捷键

块级引用

思源的核心能力——每个段落、标题、列表项都是一个"块"，可以跨文档引用：

1. 鼠标悬停在任意块左侧的红色圆点上
2. 点击右键 → 复制块引用
3. 在其他文档中粘贴，即可创建引用关系
4. 点击引用可以跳转到原文

数据备份

手动备份

思源的数据全部存放在挂载的 siyuan-data 目录中，直接备份这个目录即可：

1

tar -czf siyuan-backup-$(date +%Y%m%d).tar.gz siyuan-data/

通过 Web 导出

在思源界面中：设置 → 导出 → Data，可以导出完整的 Data 压缩包。

自动备份

建议配合定时任务，定期备份工作空间：

1
2

# 每天凌晨 2 点备份
0 2 * * * tar -czf /备份路径/siyuan-$(date +\%Y\%m\%d).tar.gz /你的路径/siyuan/siyuan-data/

多设备同步

思源支持多种同步方式：

自托管场景下，推荐用 S3（如 MinIO）或 WebDAV 实现多设备同步，数据完全自主可控。

客户端

思源笔记除了 Web 端，还提供全平台客户端：

客户端可以连接自托管服务器：设置 → 关于 → Sillen 服务器地址，填入 http://你的IP:6806。

常见问题

Q: 6806 端口打不开？

检查防火墙是否放行，以及容器是否正常运行：

1
2

docker ps --filter name=siyuan
docker logs siyuan

Q: 数据存在哪里？

所有数据在挂载的 siyuan-data 目录中，包括笔记、附件、配置。容器删除重建不会丢失数据。

Q: 忘记访问密码？

编辑 docker-compose.yml 中的 SIYUAN_ACCESS_AUTH_CODE 为新密码，然后 docker compose up -d 重启。

Q: 如何更新版本？

1
2

docker compose pull
docker compose up -d

更新前建议先备份数据。

总结

思源笔记的 Docker 部署非常简单，一个 compose 文件就能跑起来。自托管的好处是数据完全掌握在自己手中，配合 S3/WebDAV 同步，可以构建一套免费、私密、全平台的笔记系统。

项目地址：https://github.com/siyuan-note/siyuan