搭建一个私有的云存储服务基于 MinIO，Joplin客户端配置S3进行笔记同步。这种方法简化了 MinIO 的部署和管理，并提供了一个安全、可靠且私有的笔记同步解决方案。

新版 MinIO 社区版已经移除了大部分 Web UI 管理功能（例如用户、权限、桶管理等），现在需要通过命令行工具 mc 操作，对我们来说使用起来不太方便。

可以选择minio/minio:RELEASE.2025-04-22T22-12-26Z 版本，主要是为了保留其功能完整的 Web 管理控制台。

安装MinIO

1. 创建 docker-compose.yml 文件

services:
  minio:
    image: minio/minio
    container_name: minio
    ports:
      - "9000:9000"
      - "9001:9001"
    volumes:
      - ./minio/data:/data
    environment:
      MINIO_ROOT_USER: qixinlee
      MINIO_ROOT_PASSWORD: qixinlee.com
    command: server /data --console-address ":9001"
    restart: always

重要提示：

• 立即修改默认用户名和密码！ 为了安全，请将 YOUR_ACCESS_KEY 和 YOUR_SECRET_KEY 替换为你自己生成的强密码。

2. 启动容器

运行以下命令启动 MinIO 容器：

docker compose up -d

这会在后台启动 MinIO 容器。 使用 docker-compose logs minio 查看日志，确保没有错误。

3. 访问 MinIO 控制台

• 打开你的浏览器，访问 http://YOUR_IP:9001 （将 YOUR_IP 替换为运行 MinIO 服务器的 IP 地址）。
• 使用你设置的 MINIO_ROOT_USER 和 MINIO_ROOT_PASSWORD 登录。

4. 在MinIO 控制台创建 Bucket

• 登录后，单击 Buckets -> Create Bucket。
• 输入存储桶名称（例如，joplin-sync），然后单击 Create Bucket。
• 可以选择设置存储桶的对象锁定（Object Locking），防止意外删除。
• 重要提示： 创建Bucket后，强烈建议配置Bucket策略，限制对Bucket的访问。

5. 创建密钥信息

在控制台 选择 Access Key 创建密钥

Joplin 同步设置

1. 同步信息设置

• 在 Joplin 中，进入 工具 (Tools) -> 选项 (Options) -> 同步 (Synchronization)。
• 同步目标 (Synchronization target): 选择 S3。
• S3存储桶 (S3 bucket): joplin-sync (你创建的存储桶名称)
• S3 URL (S3 URL): http://YOUR_IP:9000 （将 YOUR_IP 替换为运行 MinIO 服务器的 IP 地址）。
• S3 区域 (S3 region): qixinlee（这个值不重要，因为 MinIO 不依赖于真正的 AWS 区域。 可以填任意值）
• S3 访问密钥 (S3 access key ID): 你创建的 Access Key
• S3 密钥 (S3 secret access key): 你创建的 Secret Key

2. 测试和同步

配置完成后，可以通过 同步 测试确保 Joplin 客户端与 MinIO 配置正常。建议首先同步少量数据，确保没有问题后再进行完整同步。