# ⚠️ 全平衡 - 会重写所有数据，非常耗时！
sudo btrfs balance start /mnt/data

# 带过滤器的平衡（推荐）
# 只平衡使用率低于 5% 的块组
sudo btrfs balance start -dusage=5 /mnt/data

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

# 只平衡元数据
sudo btrfs balance start -musage=10 /mnt/data

# 同时过滤数据和元数据
sudo btrfs balance start -dusage=10 -musage=30 /mnt/data

# 查看当前 balance 状态
sudo btrfs balance status /mnt/data

# 输出示例：
# Balance on '/mnt/data' is running
#   3 out of about 100 chunks balanced (4 considered),  97% left

# 平衡完成后：
# No balance found on '/mnt/data'

# 取消正在进行的 balance
sudo btrfs balance cancel /mnt/data

# 暂停 balance（可以稍后恢复）
sudo btrfs balance pause /mnt/data

# 恢复暂停的 balance
sudo btrfs balance resume /mnt/data

# 场景：删除了大量数据，但空间没有释放

# 查看空间使用
sudo btrfs filesystem usage /mnt/data
# Device size:                 100.00GiB
# Device allocated:             80.00GiB
# Used:                        10.00GiB    ← 实际只用了 10GB
# Free (estimated):             20.00GiB    ← 但只有 20GB 可用！

# 原因：块组已分配但内部数据已删除，块组本身不能释放

# 1. 查看块组使用情况
sudo btrfs filesystem df /mnt/data
# Data, single: total=78.00GiB, used=9.00GiB
# System, DUP: total=8.00MiB, used=16.00KiB
# Metadata, DUP: total=1.01GiB, used=500.00MiB

# 2. 使用 balance 回收低使用率的块组
sudo btrfs balance start -dusage=5 /mnt/data
# 先回收使用率低于 5% 的块组（几乎为空）

sudo btrfs balance start -dusage=20 /mnt/data
# 再回收使用率低于 20% 的块组

sudo btrfs balance start -dusage=50 /mnt/data
# 最后回收使用率低于 50% 的块组

# 3. 验证空间回收效果
sudo btrfs filesystem usage /mnt/data
# Device allocated:             15.00GiB    ← 已分配减少
# Free (estimated):             85.00GiB    ← 可用空间增加

#!/bin/bash
# btrfs-reclaim-space.sh - 渐进式空间回收
set -euo pipefail

MOUNT_POINT="${1:?Usage: $0 /mount/point}"

echo "=== Space before balance ==="
sudo btrfs filesystem usage "$MOUNT_POINT" | head -10

# 渐进式回收
for usage in 1 5 10 20 30 50; do
    echo ""
    echo "=== Balancing data chunks with usage <= ${usage}% ==="
    sudo btrfs balance start -dusage="$usage" -dlimit=10 "$MOUNT_POINT" 2>&1 || true
done

# 回收元数据
for usage in 1 5 10 20 30 50; do
    echo ""
    echo "=== Balancing metadata chunks with usage <= ${usage}% ==="
    sudo btrfs balance start -musage="$usage" -mlimit=10 "$MOUNT_POINT" 2>&1 || true
done

echo ""
echo "=== Space after balance ==="
sudo btrfs filesystem usage "$MOUNT_POINT" | head -10

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

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

# 3. 验证
sudo btrfs filesystem show /mnt/data
sudo btrfs filesystem df /mnt/data

# 需要至少 4 个设备
sudo btrfs device add /dev/sdd /mnt/data
sudo btrfs device add /dev/sde /mnt/data

# 转换
sudo btrfs balance start -dconvert=raid10 -mconvert=raid10 /mnt/data

# 查看转换进度
sudo btrfs balance status /mnt/data
# Balance on '/mnt/data' is running
#   15 out of about 80 chunks balanced (15 considered),  81% left

# 等待完成
while sudo btrfs balance status /mnt/data | grep -q "running"; do
    sleep 10
done

# 方法 1：限制处理的块组数量
sudo btrfs balance start -dlimit=5 -mlimit=5 /mnt/data

# 方法 2：只处理低使用率块组
sudo btrfs balance start -dusage=10 /mnt/data

# 方法 3：使用 ionice 降低 I/O 优先级
sudo ionice -c 3 btrfs balance start /mnt/data

# 方法 4：选择低峰期执行
# 在 cron 中设置凌晨执行

#!/bin/bash
# btrfs-monthly-balance.sh - 每月空间平衡
set -euo pipefail

MOUNT_POINT="/data"
LOG_FILE="/var/log/btrfs-balance.log"

log() {
    echo "[$(date '+%Y-%m-%d %H:%M:%S')] $*" | tee -a "$LOG_FILE"
}

log "Starting monthly balance on $MOUNT_POINT"

# 渐进式回收低使用率块组
for usage in 5 10 20 30; do
    log "Balancing data: usage <= ${usage}%"
    sudo btrfs balance start -dusage="$usage" -dlimit=5 "$MOUNT_POINT" 2>&1 | tee -a "$LOG_FILE" || true
done

for usage in 5 10 20 30; do
    log "Balancing metadata: usage <= ${usage}%"
    sudo btrfs balance start -musage="$usage" -mlimit=5 "$MOUNT_POINT" 2>&1 | tee -a "$LOG_FILE" || true
done

log "Balance completed"
log "Current usage:"
sudo btrfs filesystem usage "$MOUNT_POINT" | head -8 | tee -a "$LOG_FILE"

# Cron 配置：每月 15 号凌晨 3 点
0 3 15 * * /usr/local/bin/btrfs-monthly-balance.sh

# 对整个文件系统进行碎片整理
sudo btrfs filesystem defragment -r /mnt/data

# 对指定目录碎片整理
sudo btrfs filesystem defragment -r /mnt/data/projects

# 指定压缩算法（同时重新压缩）
sudo btrfs filesystem defragment -r -czstd /mnt/data/documents

# 限制单个文件大小（只整理大于 32MB 的文件）
sudo btrfs filesystem defragment -r -t 32M /mnt/data

# 对单个文件碎片整理
sudo btrfs filesystem defragment /mnt/data/largefile.img