xagaba/snapraid

linuxserver/snapraid

镜像概述和主要用途

该镜像为LinuxServer.io团队发布的Alpine版本SnapRAID 12.3容器。SnapRAID是一款开源快照式RAID工具，通过计算多块硬盘（通常为JBOD配置）的奇偶校验实现数据冗余，支持从硬盘故障中恢复数据。与实时RAID（如mdadm、ZFS）不同，它采用快照机制，特别适合存储大量大型静态文件（如媒体库）。镜像集成snapraid-runner工具，提供自动化同步、日志管理和通知功能。

核心功能和特性

SnapRAID核心特性

• 支持JBOD硬盘配置，通过奇偶校验实现数据冗余与故障恢复
• 允许使用不同大小的硬盘（最大硬盘需作为奇偶校验盘）
• 适合存储大型静态文件（如媒体文件），对写入操作不频繁的场景友好
• 遵循GPL v3开源许可协议

snapraid-runner功能

• 同步前执行diff检查，当删除文件数量超过设定阈值时自动中止
• 支持创建大小限制的轮换日志文件
• 可配置邮件通知（每次运行或仅故障时发送）
• 支持同步后自动运行scrub（数据完整性检查）

使用场景和适用范围

• 家庭媒体服务器存储（电影、音乐、照片等静态文件）
• 个人/小型办公备份存储系统
• 需要数据冗余但文件更新频率低的场景
• 对硬盘空间利用率要求高，允许使用不同容量硬盘的场景

使用方法和配置说明

基本部署命令

bash
docker create -d \
  -v /mnt:/mnt \
  -v <宿主机本地配置路径>/snapraid:/config \
  -e PGID=1001 -e PUID=1001 \
  --name snapraid \
  linuxserver/snapraid

参数说明

• -v /mnt: 数据磁盘挂载点，建议使用/mnt/disk*命名格式挂载各数据盘
• -v /config: SnapRAID和snapraid-runner配置文件存储路径
• -e PGID: 组ID，用于设置容器运行的组权限
• -e PUID: 用户ID，用于设置容器运行的用户权限

容器基于phusion-baseimage（移除SSH）构建，如需进入运行中的容器，执行docker exec -it snapraid /bin/bash

检测文件移动操作

默认情况下，SnapRAID可能无法检测文件移动（将其识别为删除+复制），并显示WARNING! UUID is unsupported for disks警告。添加以下参数可解决：

bash
--privileged --mount type=bind,source=/dev/disk,target=/dev/disk

• --privileged: 共享宿主机所有设备（如/dev/sdb、/dev/sdb1）
• --mount type=bind,source=/dev/disk,target=/dev/disk: 挂载磁盘UUID列表，使SnapRAID能通过/dev/disk/by-uuid识别磁盘

用户/组标识符（PUID/PGID）

PUID和PGID用于指定容器运行的用户/组ID，避免数据卷（-v挂载）的权限问题。可使用宿主机已存在的用户ID或新建用户，不建议使用root（安全性考虑）。

配置文件设置

首次运行容器前，需在宿主机配置目录（挂载到/config的路径）中放置两个配置文件：

• snapraid.conf: SnapRAID主配置文件，定义磁盘、奇偶校验设置等（参考SnapRAID手册）
• snapraid-runner.conf: snapraid-runner配置文件，设置同步阈值、日志、通知等参数

应用操作

• 执行SnapRAID命令：docker exec -it <容器名> <命令>，例如docker exec -it snapraid snapraid diff
• 默认任务：snapraid-runner通过cron配置每天00:30自动运行（同步+可选scrub）
• 配置技巧：参考LinuxServer.io论坛获取snapraid-runner高级配置方法

更新与日志

• 升级镜像：docker restart snapraid（容器启动时自动更新）
• 实时查看日志：docker logs -f snapraid

版本历史

• 2015年11月10日：初始发布 - IronicBadger <***>