存储空间掉盘修复挂载教程

青芷

飞牛 NAS 存储空间掉盘修复教程（仅适用于x86，arm因没有机器无法测试）

本文为飞牛 NAS 用户提供 ZFS、ext4、btrfs 三种文件系统下，因缓存盘 / 日志盘损坏导致存储空间掉盘、降级或无法挂载的修复方法，通过该修复脚本可快速移除损坏缓存层 / 设备，恢复存储空间正常使用。

适用场景

暂不支持RAID恢复

1. ZFS 文件系统：cache（L2ARC）读缓存或 log（SLOG/ZIL）写日志设备损坏，导致 ZFS 池降级（状态为 DEGRADED/UNAVAIL/FAULTED）；
2. ext4 文件系统：LVM cache 缓存盘（SSD）损坏，导致存储空间无法挂载；
3. btrfs 文件系统：缓存盘（SSD）损坏，导致存储空间无法挂载、识别异常。

前置准备

1. 操作权限：必须使用 root / 管理员权限执行所有命令，飞牛 NAS 中可通过 SSH 登录系统后，执行 sudo -i切换至 root 用户；
2. 网络要求：NAS 需能正常访问外网，确保可下载修复脚本；
3. 重要提醒：若缓存模式为 writeback，缓存中未写回的临时数据会丢失（不影响已持久化的核心数据），建议修复后检查重要文件完整性。

修复步骤（按文件系统选择）

一、ZFS 存储空间修复

步骤 1：下载 ZFS 专属修复脚本

SSH 登录飞牛 NAS 后，执行以下命令下载脚本：

cd /tmp

curl -o fnos_zfs_storage_repair.sh https://static.nnfn.cn/storage/fnos_zfs_storage_repair.sh

步骤 2：赋予脚本执行权限

chmod +x fnos_zfs_storage_repair.sh

步骤 3：运行修复脚本

sudo bash fnos_zfs_storage_repair.sh

步骤 4：脚本交互操作

1. 脚本会自动扫描所有存在问题的 ZFS 池，列出损坏的 cache/log 设备、池状态、大小等信息；
2. 若仅 1 个问题池，脚本自动选择；若多个，输入编号选择单个池，或输入 a修复全部；
3. 输入 y确认修复，脚本会自动移除损坏设备（先尝试 zpool remove，失败则用 zpool detach）；
4. 修复完成后，脚本会显示池的最终状态（正常为 ONLINE），并自动验证数据集挂载状态。

二、ext4 存储空间修复

步骤 1：下载 ext4 专属修复脚本

SSH 登录飞牛 NAS 后，执行以下命令下载脚本：

cd /tmp

curl -o fnos_ext4_storage_repair.sh https://static.nnfn.cn/storage/fnos_ext4_storage_repair.sh

步骤 2：赋予脚本执行权限

chmod +x fnos_ext4_storage_repair.sh

步骤 3：运行修复脚本

sudo bash fnos_ext4_storage_repair.sh

步骤 4：脚本交互操作

1. 脚本自动扫描存在丢失 PV 且带 LVM cache 的 VG（卷组），列出 VG 名称、大小、缓存模式、丢失设备；
2. 若仅 1 个问题 VG，自动选择；若多个，输入编号选择单个，或输入 a修复全部；
3. 输入 y确认修复，脚本会自动备份 VG 配置、生成修复配置、移除缓存层并恢复原始数据卷；
4. 修复完成后，脚本会验证 ext4 文件系统完整性，并显示最终的 PV/LV 状态。

三、btrfs 存储空间修复

步骤 1：下载 btrfs 专属修复脚本

SSH 登录飞牛 NAS 后，执行以下命令下载脚本：

cd /tmp

curl -o fnos_btrfs_storage_repair.sh https://static.nnfn.cn/storage/fnos_btrfs_storage_repair.sh

步骤 2：赋予脚本执行权限

chmod +x fnos_btrfs_storage_repair.sh

步骤 3：运行修复脚本

sudo bash fnos_btrfs_storage_repair.sh

步骤 4：脚本交互操作

1. 脚本自动扫描存在丢失 PV 且带缓存的 VG，列出问题 VG 的详细信息；
2. 输入编号选择需要修复的 VG（仅支持单 VG 选择）；
3. 若缓存模式为 writeback，脚本会提示数据丢失风险，输入 y确认继续；
4. 脚本自动备份 VG 配置、生成修复配置、停用并重新激活 VG，移除损坏缓存层；
5. 修复完成后，脚本会检查 btrfs 文件系统完整性，并显示 LV/PV 最终状态。

修复后验证与后续操作

1. 查看存储空间状态：修复完成后，脚本会自动输出池 / VG/LV 的最终状态，可在飞牛 NAS 管理界面查看存储空间是否恢复正常挂载；
2. 检查文件完整性：对重要文件夹 / 文件进行打开、读取验证，确认无数据损坏；
3. 重启服务 / 系统：若管理界面仍显示异常，可在飞牛 NAS 管理界面重启存储服务，或直接重启 NAS 主机；
4. 更换新缓存盘：若需要恢复缓存性能，可在存储空间正常后，重新添加新的 SSD 缓存盘（参考飞牛 NAS 官方缓存配置教程）。

常见问题解决

1. 脚本下载失败：检查 NAS 外网网络，可尝试更换 DNS（如 223.5.5.5），或手动将脚本内容复制到 NAS 本地文件中；
2. 执行脚本提示权限不足：确保已执行 chmod +x 脚本名.sh，且用 sudo运行脚本；
3. 修复后存储空间仍无法挂载：可尝试手动挂载（ZFS：zfs mount 池名；ext4/btrfs：mount 设备路径 挂载点），或检查文件系统是否有其他损坏；
4. 需要回滚配置：脚本会自动将原始配置备份到 /tmp目录（文件名含 vg_backup + 时间戳），可执行 vgcfgrestore -f 备份文件路径 VG名回滚 LVM 配置（ext4/btrfs），ZFS 可重新添加设备恢复原有配置。

注意事项

1. ZFS 的 cache 设备移除仅影响读取性能，不影响数据完整性；log 设备移除可能丢失未提交的同步写入数据；
2. 所有修复脚本均会自动备份原始配置，若修复失败可通过备份文件回滚，无需担心配置丢失；
3. 操作过程中请勿中断 SSH 连接或关闭 NAS，否则可能导致配置损坏；
4. 若修复后仍存在问题，建议联系飞牛 NAS 官方技术支持。