思源笔记多端同步方案：Docker MinIO + Siyuan-unlock

思源笔记多端同步方案：Docker MinIO + Siyuan-unlock

---

1. 需求背景

思源笔记功能强大，有多端 PC 使用需求，但官方同步需付费 78 元。本方案仅需一台服务器即可实现免费同步。

适用人群：

• 拥有一台服务器
• 多台 PC 需要同步

---

2. 系统架构

核心组件：

• ​MinIO：开源 S3 对象存储
• ​Siyuan-unlock：支持自定义 S3 同步

架构： 多个 PC 端 ↔ MinIO Server ↔ 数据存储

---

3. 实现步骤

3.1 部署 MinIO

docker-compose.yml：

version: '3.8'services:minio:image: minio/minio:RELEASE.2023-03-20T20-16-18Zcontainer_name: miniorestart: unless-stoppedcommand: server /data --console-address ":9001"environment:TZ: Asia/ShanghaiLANG: en_US.UTF-8MINIO_ROOT_USER: minioadmin           # 改成你的用户名MINIO_ROOT_PASSWORD: minioadmin          # 改成你的密码MINIO_SERVER_URL: http://<ServerIP>:<Port>  # 改成你的服务器IPvolumes:- minio_data:/data- minio_config:/root/.minioports:- "9000:9000"              # API 端口- "127.0.0.1:9001:9001"   # 控制台（仅本地访问）healthcheck:test: ["CMD", "curl", "-f", "http://localhost:9000/minio/health/live"]interval: 30stimeout: 10sretries: 3volumes:minio_data:minio_config:networks:default:name: siyuan-network

启动

docker-compose up -d

3.2 安装 MinIO Client (mc)

# 下载 mc 客户端
wget https://dl.min.io/client/mc/release/linux-amd64/mc# 赋予执行权限
chmod +x mc# 移动到系统路径
sudo mv mc /usr/local/bin/# 创建软链接（可选）
sudo ln -s /usr/local/bin/mc /usr/bin/mc# 验证安装
mc --version

3.3 配置 MinIO

# 配置 MinIO 别名（连接信息）
mc alias set myminio http://<ServerIP>:9000 minioadmin minioadmin# 验证连接
mc admin info myminio# 创建存储桶
mc mb myminio/notes-sync# 查看存储桶列表
mc ls myminio

权限配置（按需选择）：

# 方案1：公开访问（不推荐，数据无保护）
mc anonymous set public myminio/notes-sync# 方案2：私有访问（推荐）
mc anonymous set private myminio/notes-sync# 查看当前权限
mc anonymous get myminio/notes-sync

3.4 配置思源笔记

在思源笔记中：设置 → 云端 → S3 配置

Endpoint:         http://<ServerIP>:9000
Access Key:       minioadmin
Secret Key:       minioadmin
Bucket:           notes-sync
Region:           us-east-1

点击启用 自动同步，在关于-数据仓库密钥，设置数据库秘钥，即可启用同步；

3.5 防火墙配置

# 开放 MinIO API 端口 使用 ufw
sudo ufw allow 9000/tcp

---

4. 常用管理命令

# 查看存储桶内容
mc ls myminio/notes-sync# 查看存储桶使用情况
mc du myminio/notes-sync# 备份数据（下载到本地）
mc mirror myminio/notes-sync ./backup# 删除存储桶（危险操作）
mc rb --force myminio/notes-sync# 查看 MinIO 服务状态
docker logs -f minio# 重启 MinIO
docker restart minio

---

5. 故障排查

# 检查容器状态
docker ps | grep minio# 查看详细日志
docker logs minio --tail 100# 测试端口连通性
curl http://<ServerIP>:9000/minio/health/live# 重置连接
mc alias remove myminio
mc alias set myminio http://<ServerIP>:9000 minioadmin minioadmin