孙亮亮
返回 NAS 系统

NAS 系统

NAS 自建 MinIO 对象存储实战:S3 桶、版本控制与照片备份落地

2026年11月20日

NAS 上用 MinIO 管好 S3 照片备份与版本。

NASMinIOS3对象存储版本控制

NAS 自建 MinIO 对象存储实战:S3 桶、版本控制与照片备份落地

摘要:把 NAS 从“网络硬盘”升级为 S3 对象存储,用 MinIO 建桶、开版本控制、做生命周期与恢复演练,适合照片归档和应用直传,但不替代 RAID 与异地备份。

本文面向群晖、飞牛等带 Docker 的家庭 NAS,给出从部署、建桶到恢复演练的落地清单。

为什么要在 NAS 上跑 MinIO

SMB 共享擅长文件夹式编辑,MinIO 提供的是 S3 API:对象是不可变的,删除会留下删除标记,客户端可以用预签名 URL 直传,第三方软件也能用统一接口存取。典型场景是手机相册备份、监控片段归档、自建应用把附件写进桶里。与 SMB 共享相比,S3 靠 API 列举对象、带元数据,程序写入不必处理文件锁;但目录概念是前缀模拟,批量列举要分页,别照搬文件夹思维。要明确边界:对象存储不是给你在资源管理器里直接改 Word 用的,也不是备份本身;它是“可被程序稳定调用的存储层”。

Docker 部署与端口收敛

群晖、飞牛都可直接用 Docker Compose。数据目录换成 NAS 上的真实路径,根目录只给容器专用账号读写:

services:
  minio:
    image: minio/minio:latest
    container_name: minio
    environment:
      MINIO_ROOT_USER: nasadmin
      MINIO_ROOT_PASSWORD: "请换成16位以上强密码"
    volumes:
      - /volume1/docker/minio/data:/data
    command: server /data --console-address ":9001"
    ports:
      - "127.0.0.1:9000:9000"
      - "127.0.0.1:9001:9001"

数据目录建议单独挂一块盘或一个共享文件夹,权限交给容器运行用户,别直接指向 RAID 根目录。容器内存限制先给 2GB,NAS 上同时跑 Jellyfin 等重负载时要留余量。OpenWrt 或 NAS 本机 NTP 必须对准,版本时间和生命周期规则都依赖系统时钟。端口只绑 127.0.0.1,外网访问走 Nginx 反代 + TLS;上线后把 latest 固定为具体版本。默认账号 minioadmin 必须改掉,控制台 9001 一旦裸奔到公网,几分钟内就会被扫描。

建桶、权限与预签名上传

按用途拆桶,不要所有数据塞一个 bucket:photo-archive 存照片,app-backup 存应用备份,temp-upload 只做上传中转。用 mc 客户端初始化:

mc alias set local http://127.0.0.1:9000 nasadmin '强密码'
mc mb local/photo-archive
mc mb local/app-backup
mc mb local/temp-upload
mc anonymous set none local/photo-archive

桶默认私有。手机或小程序直传时,由服务端签发 10~15 分钟有效的预签名 PUT URL,而不是把桶设为 public read;否则对象链接被转发后,照片等于公开。给应用单独建用户,策略只允许写 app-backup 的指定前缀,删改权限不要顺手给。对象自带 ETag、最后修改时间和自定义元数据,后续做去重或归档审计时比普通文件更好检索;但元数据不会自动进搜索引擎,需要应用自己记录索引。

版本控制与生命周期别混为一谈

版本控制负责“误删可找回”,执行 mc version enable local/photo-archive 后,同名文件覆盖会保留旧版本,删除会生成删除标记,可用 mc ls --versions 查看。生命周期负责“到期清理”,例如 temp-upload 设 7 天过期,删除标记保留 30 天后清理。照片桶建议只开版本,不设自动过期;容量增长要用 NAS 存储池告警盯着。

恢复演练比配置更重要。随便挑一张旧图,按版本 ID 取回并校验哈希:

mc cp --version-id <VERSION_ID> local/photo-archive/2026/IMG_001.jpg ./restore-test.jpg
sha256sum ./restore-test.jpg

能取回、能打开、哈希一致,才算这套流程可用。批量场景可用 mc mirror 把桶镜像到 NAS 另一块盘,镜像副本同样要定期抽样校验;只做同步不做校验,遇到静默位翻转时你可能直到读取那天才发现。

四个高频坑

第一,纠删码不等于冗余:单盘 NAS 上跑 MinIO,盘坏了对象一样丢,别因为“对象存储”四个字就省掉备份。第二,反代要放行大请求体与长超时,否则 multipart 上传大视频会 413 或中途断流。第三,老客户端可能只支持 Signature V2 或 virtual-host 风格域名,接入前先确认 S3 兼容性,必要时切 path-style。第四,版本开启后删除并不立刻释放空间,看到容量没降先查删除标记。还要留意系统时间跳变:生命周期按 UTC 判断到期,时钟飘一天就可能提前清理。

小结

MinIO 适合把 NAS 变成程序友好的 S3 底座:私有桶、最小权限、版本控制、定期恢复演练,四件事做好就能支撑照片与应用数据。它解决的是“怎么存和怎么取”,RAID 解决“盘坏怎么办”,异地副本解决“整机没了怎么办”,三者各司其职。

本模块其他文章

NAS 搭建 Audiobookshelf 有声书服务器:Docker 部署、刮削与手机断点续听实战NAS 影视库元数据整理实战:用 TinyMediaManager 规范命名让 Jellyfin/Plex 精准刮削NAS 零信任远程访问实战:用 Cloudflare Tunnel 安全暴露内网服务NAS 虚拟机实战:用群晖 VMM 与飞牛虚拟机跑软路由、Home Assistant 与隔离测试环境NAS 媒体库自动整理与批量转码实战:用 Tdarr + ffmpeg 规范命名、转 H.265 省 40% 空间NAS 做全家终端备份中枢:macOS 时间机器、Windows 文件历史与手机整机备份实战NAS 存储池与 RAID 选型实战:SHR、RAID 5/6/10 容量算法、掉盘容忍与在线扩容避坑飞牛/群晖 NAS SSD 缓存加速实战:NVMe 读写缓存、命中率观测与掉电保护取舍群晖/飞牛 NAS 快照与误删秒级恢复实战:Btrfs 子卷快照、快照计划与勒索病毒防护NAS 接 UPS 断电自动保护实战:USB 通讯、NUT 网络供电监控与停电安全关机家庭与小企业 NAS 文件共享实战:SMB 多用户挂载、权限隔离与 Windows/Mac 访问指南NAS 容器化应用纳管实战:用 Docker Compose + Watchtower 编排多服务并自动安全更新NAS 硬盘健康监控实战:用 smartmontools + Scrutiny 提前发现坏盘与温度预警NAS 用 Syncthing 搭建多设备实时文件同步:手机电脑 NAS 自动互备实战NAS 数据备份 3-2-1 策略实战:rsync 本地快照 + rclone 加密同步对象存储NAS 搭建 Nginx Proxy Manager 反向代理中枢:统一证书、域名分发与内网服务安全暴露飞牛/群晖 NAS 搭建家庭下载中心:qBittorrent + Aria2 + Transmission 容器化部署实战飞牛/群晖 NAS 自建家庭音乐中心:Navidrome 部署、歌词刮削与多端无损串流NAS 搭建家庭电子书与文档中心:Calibre-Web 部署、Kindle 推送与全文检索飞牛/群晖 NAS 自建 Vaultwarden 密码库:容器部署、HTTPS 反代与加密备份实战飞牛群晖 NAS 搭建家庭监控系统:Frigate 接管 RTSP 摄像头做本地录像与智能回放飞牛/群晖 NAS 部署 Jellyfin 媒体中心:影片刮削、硬件转码与手机远程播放用 NAS 搭建家庭私有云相册:Immich 部署、手机备份与多端同步群晖/飞牛 NAS 远程访问实战:Tailscale 组网与反向代理安全配置NAS 快照实战:用 Btrfs 子卷快照挡住误删和勒索,5 分钟回滚NAS 异地访问怎么选:Tailscale 零配置组网与 WireGuard 自建隧道的实战对比用 Immich 把全家照片搬回 NAS:自建家庭相册的部署、备份与避坑在 NAS 上用 Docker 跑自建服务NAS 阵列与 3-2-1 备份策略
NAS 自建 MinIO 对象存储实战:S3 桶、版本控制与照片备份落地 · 孙亮亮