# 创建 RAID 1 文件系统
sudo mkfs.btrfs -d raid1 -m raid1 -L "mirror-pool" /dev/sdb /dev/sdc

# 查看 RAID 信息
sudo btrfs filesystem show /dev/sdb
# Label: 'mirror-pool'  uuid: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
#     Total devices 2  FS bytes used 128.00KiB
#     devid    1  size 100.00GiB  used 2.02GiB  path /dev/sdb
#     devid    2  size 100.00GiB  used 2.02GiB  path /dev/sdc

# RAID 10（至少需要 4 个设备）
sudo mkfs.btrfs -d raid10 -m raid10 -L "raid10-pool" /dev/sd{b,c,d,e}

# RAID 10 空间 = 所有设备总大小 / 2
# 4 × 100GB = 200GB 可用

# RAID 1c3（3 副本，需要 3+ 设备，内核 6.2+）
sudo mkfs.btrfs -d raid1c3 -m raid1c3 -L "triple-mirror" /dev/sd{b,c,d}

# RAID 1c4（4 副本，需要 4+ 设备）
sudo mkfs.btrfs -d raid1c4 -m raid1c4 -L "quad-mirror" /dev/sd{b,c,d,e}

# 元数据使用更安全的 RAID 1c3，数据使用 RAID 1
sudo mkfs.btrfs -d raid1 -m raid1c3 -L "mixed-raid" /dev/sd{b,c,d}

# 元数据 RAID 1，数据 single（节省空间，无冗余）
sudo mkfs.btrfs -d single -m raid1 -L "meta-mirror" /dev/sdb /dev/sdc

# 3 个不同大小的设备
sudo mkfs.btrfs -d raid1 -m raid1 -L "mixed-sizes" /dev/sdb /dev/sdc /dev/sdd
# /dev/sdb = 500GB, /dev/sdc = 1TB, /dev/sdd = 2TB

# Btrfs 会智能分配，但空间利用率取决于最小设备
# RAID 1 可用空间 ≈ min(500GB, 1TB, 2TB) = 500GB... 不完全如此
# Btrfs 在 3 设备 RAID 1 中实际上可以利用更多空间

# 添加新设备到文件系统
sudo btrfs device add /dev/sdd /mnt/data

# 添加并同时进行平衡（推荐）
sudo btrfs device add /dev/sdd /mnt/data
sudo btrfs balance start /mnt/data

# 删除设备（数据会被迁移到其他设备）
sudo btrfs device delete /dev/sdc /mnt/data

# 删除需要有足够的空间容纳迁移的数据

# 查看所有设备
sudo btrfs filesystem show /mnt/data

# 查看设备详细信息
sudo btrfs device stats /mnt/data

# 查看设备使用情况
sudo btrfs device usage /mnt/data

# 从 single 转换到 RAID 1
sudo btrfs balance start -dconvert=raid1 -mconvert=raid1 /mnt/data

# 从 RAID 1 转换到 RAID 10（需要 4+ 设备）
sudo btrfs balance start -dconvert=raid10 -mconvert=raid10 /mnt/data

# 只转换元数据到 RAID 1c3
sudo btrfs balance start -mconvert=raid1c3 /mnt/data

# 场景：单设备扩展到 RAID 1
# 1. 当前状态
sudo btrfs filesystem show /mnt/data
# Total devices 1

# 2. 添加第二个设备
sudo btrfs device add /dev/sdc /mnt/data

# 3. 转换为 RAID 1
sudo btrfs balance start -dconvert=raid1 -mconvert=raid1 /mnt/data

# 4. 验证
sudo btrfs filesystem show /mnt/data
# Total devices 2

# 设备故障后的状态
sudo btrfs filesystem show /mnt/data
# Total devices 2  FS bytes used 10.00GiB
# devid    1  size 100.00GiB  used 12.00GiB  path /dev/sdb
# devid    2  size 0.00B     used 0.00B     path /dev/sdc  ← 设备丢失

# 文件系统仍可读写，但无冗余保护
# 查看设备错误统计
sudo btrfs device stats /mnt/data
# [/dev/sdc].read_io_errs    100
# [/dev/sdc].write_io_errs   50

# 正常挂载降级的文件系统
sudo mount -o degraded /dev/sdb /mnt/data

# 如果有多个设备丢失（RAID 1 只能容忍 1 个设备丢失）
# 可能需要使用 rescue 选项
sudo mount -o rescue=usebackuproot /dev/sdb /mnt/data

# 方法 1：替换设备（推荐）
sudo btrfs replace start /dev/sdc /dev/sdd /mnt/data

# 查看替换进度
sudo btrfs replace status /mnt/data

# 等待替换完成
sudo btrfs replace status /mnt/data
# 100.0% done

# 方法 2：删除旧设备，添加新设备
sudo btrfs device delete missing /mnt/data
sudo btrfs device add /dev/sdd /mnt/data
sudo btrfs balance start /mnt/data

# 使用 "missing" 关键字引用丢失的设备
sudo btrfs device delete missing /mnt/data

# 添加 "missing" 设备占位（用于替换）
sudo btrfs replace start /dev/sdc /dev/sdd /mnt/data

# 内核日志中的设备故障信息
dmesg | grep btrfs
# [12345.678] BTRFS warning (device sdb): csum failed root 257 ino 100 off 0 csum 0x12345678 expected 0x87654321 mirror 2
# [12345.679] BTRFS error (device sdb): bdev /dev/sdc errs: wr 1, rd 0, flush 1, corrupt 0, gen 0

# 检查文件系统
sudo btrfs scrub start /mnt/data

# 查看 scrub 结果
sudo btrfs scrub status /mnt/data

# 如果 scrub 无法修复（单设备模式下），可能需要备份恢复

# 启用 RAID 5/6 的相关选项
# 内核 5.19+ 有更好的处理

# 确保使用最新内核
uname -r

# 创建 RAID 5（仅测试环境）
sudo mkfs.btrfs -d raid5 -m raid1 -L "raid5-test" /dev/sd{b,c,d}
# 元数据使用 RAID 1（更安全），数据使用 RAID 5

# 避免使用 RAID 5 存储元数据
sudo mkfs.btrfs -d raid5 -m raid1 -L "raid5-safer" /dev/sd{b,c,d}

# 查看当前块组分配
sudo btrfs filesystem df /mnt/data

# 执行全平衡（可能很慢）
sudo btrfs balance start /mnt/data

# 只平衡使用率低于 10% 的块组
sudo btrfs balance start -dusage=10 /mnt/data

# 转换 RAID 级别
sudo btrfs balance start -dconvert=raid1 -mconvert=raid1 /mnt/data

# 查看平衡进度
sudo btrfs balance status /mnt/data

# 取消平衡
sudo btrfs balance cancel /mnt/data

# 定期检查设备统计
sudo btrfs device stats /mnt/data

# 脚本化检查
#!/bin/bash
ERRORS=$(sudo btrfs device stats /mnt/data | grep -v " 0$" | grep -v "^[/")
if [[ -n "$ERRORS" ]]; then
    echo "ALERT: Device errors detected!"
    echo "$ERRORS"
    # 发送告警...
fi