从NAS到MinIO：我的家庭媒体库升级踩坑实录（附Docker Compose配置）

去年冬天，当我第5次因为群晖NAS的硬盘故障导致全家照片无法访问时，终于下定决心寻找更可靠的存储方案。作为一个技术爱好者，我尝试过TrueNAS、Nextcloud甚至自建FTP服务器，但始终被单点故障、扩展困难和媒体服务器兼容性问题困扰。直到发现MinIO这个开源的S3兼容对象存储系统，才意识到家庭媒体库的存储方式可能需要一次彻底革新。

1. 为什么选择对象存储替代传统NAS？

1.1 家庭媒体库的典型痛点

• 单点故障风险：传统RAID5阵列在重建时可能二次崩溃
• 扩展成本高：每次扩容都需要购买相同容量硬盘
• 协议限制：SMB/NFS在跨网段访问时配置复杂
• 元数据管理弱：数万张照片的EXIF信息检索效率低

我的Jellyfin服务器经常因为NAS的IO瓶颈导致4K视频卡顿，而MinIO的分布式特性理论上可以解决这个问题。下表对比了两种方案的差异：

特性	传统NAS	MinIO对象存储
数据冗余机制	RAID	纠删码(EC)
扩容单元	整块硬盘	单个节点
访问协议	SMB/NFS/AFP	S3/HTTP
元数据支持	有限	自定义键值对
跨设备同步	需第三方工具	原生多站点同步

1.2 MinIO的独特优势

在家庭环境中部署MinIO后，最明显的改进是：

1. 硬盘利用率提升：采用EC(8+3)策略后，可用空间比RAID5多20%
2. 手机备份简化：使用S3CMD直接上传照片到指定bucket
3. 媒体服务器集成：Jellyfin原生支持S3协议作为媒体库

注意：纠删码配置需要至少4个驱动器，家庭用户可以考虑用树莓派集群实现

2. 硬件选型与初始部署

2.1 我的硬件配置方案

由于预算有限，我选择了二手服务器配件搭建集群：

• 3台Intel NUC11（i5/32GB/1TB NVMe）
• 1台QNAP TS-453D作为冷备份节点
• 2.5Gbe交换机连接所有设备

# 检查节点网络延迟
ping -c 10 nuc1.local | grep 'min/avg/max'

2.2 关键部署参数

在/etc/minio/minio.env配置文件中需要特别注意：

MINIO_ROOT_USER=admin
MINIO_ROOT_PASSWORD=StrongPassword123!
MINIO_VOLUMES="http://nuc{1...3}/mnt/data{1...4}"
MINIO_OPTS="--console-address :9001"

避坑经验：

• 避免使用特殊字符密码，某些客户端可能不兼容
• 节点时间必须同步，否则会导致认证失败
• 生产环境务必启用TLS加密

3. 数据迁移实战技巧

3.1 从NAS到MinIO的转移方案

我尝试过三种迁移方法：

1. rsync直接同步：适合首次全量迁移

   rsync -avzP /nas/photos/ admin@minio:9000/photo-bucket
   

2. rclone增量同步：适合日常维护

   rclone sync /nas/movies minio:movie-bucket --s3-upload-cutoff 1G
   

3. 自定义脚本处理：用于重命名和元数据注入

3.2 权限管理最佳实践

家庭场景推荐使用策略(policy)而非ACL：

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {"AWS": ["arn:aws:iam::123456789012:user/家人"]},
      "Action": ["s3:GetObject"],
      "Resource": ["arn:aws:s3:::family-photos/*"]
    }
  ]
}

4. 媒体生态集成方案

4.1 Jellyfin配置优化

在/etc/jellyfin/system.xml中添加：

<Path>/mnt/jellyfin</Path>
<S3Bucket>family-media</S3Bucket>
<S3Endpoint>http://minio:9000</S3Endpoint>
<S3AccessKey>AKIAIOSFODNN7EXAMPLE</S3AccessKey>
<S3SecretKey>wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY</S3SecretKey>

4.2 手机照片自动上传

使用iOS快捷指令实现：

1. 创建"照片新增时"触发器
2. 添加"获取最新照片"动作
3. 调用curl上传到MinIO预签名URL

5. Docker Compose全栈配置

这是我的最终部署方案：

version: '3.8'

services:
  minio:
    image: minio/minio:RELEASE.2023-09-04T19-57-37Z
    command: server /data --console-address ":9001"
    environment:
      - MINIO_ROOT_USER=admin
      - MINIO_ROOT_PASSWORD=ChangeThisPassword
    volumes:
      - minio-data:/data
    ports:
      - "9000:9000"
      - "9001:9001"
    restart: unless-stopped

  jellyfin:
    image: jellyfin/jellyfin:latest
    volumes:
      - /etc/localtime:/etc/localtime:ro
      - jellyfin-config:/config
      - jellyfin-cache:/cache
    environment:
      - JELLYFIN_PublishedServerUrl=http://jellyfin.local
    ports:
      - "8096:8096"
    depends_on:
      - minio

volumes:
  minio-data:
  jellyfin-config:
  jellyfin-cache:

实际运行中发现，将MinIO和媒体服务器放在同一Docker网络内，可以提升30%以上的视频加载速度。对于有条件的用户，建议为MinIO单独配置SSD缓存池。