自动挂载USB硬盘到Immich/Rslsync数据存储目录

User: 我的armbian服务器情况如下：
1，有两个USB端口
2，服务器上运行有rslsync, docker, casaos及immich服务
3，该rslsync和immich服务的数据都存储在/DATA目录下，但是服务器自身空间不足。
需要实现的功能如下：
1，通过2.5寸usb机械硬盘实现扩容，使得服务器的/DATA目录的实际存储数据是位于usb硬盘根目录下的同名/DATA目录内，包括索引和原始图片或视频。
2，在系统无访问usb硬盘超过15分钟后，usb硬盘自动休眠，或unmount，以实现保护机械硬盘的目的。
3，在usb硬盘的根目录下的同名/DATA目录，当usb插在第二个接口时，不需要自动mount,但需要在rslsync或immich启动前有代码运行确认已经正确mount挂载并替代服务器的/DATA目录，同时要求原服务器自有/DATA目录不会被rslsync或immich误写入数据。目前rslsync,docker,casaos,immich都是通过对应的文件名.sh代码实现启动的。
4，所以在实现USB硬盘扩容的时候，优先通过.sh代码实现这些功能，可接受在四个服务的启动代码里添加代码。或增加crond服务代码。

User: 请分别提供以下内容代码，在提供每个代码前，详述使用方法：

mount-data-disk.sh
umount-data-disk.sh
data-idle-check.sh
root crontab 一行
4 个启动脚本里要插入的 3 行代码片段
data-auto-mount.path
data-auto-mount.service
在 umount-data-disk.sh 里追加“systemctl stop data-auto-mount.service”一行
一条启用命令

Kimi: 下面按“先讲怎么用 → 再给代码”的顺序，一份一份交付。
所有脚本均放在 /usr/local/bin/，root 身份操作。

mount-data-disk.sh
用途：

靠 LABEL 找 USB 硬盘 → 挂到 /mnt/usb-data → 用 bind 把 /mnt/usb-data/DATA 覆盖到 /DATA；
如果已挂载就跳过；失败返回 1，供上游脚本或服务判断。

使用方法

# 把代码保存为 /usr/local/bin/mount-data-disk.sh
chmod 755 /usr/local/bin/mount-data-disk.sh
# 手动测试
/usr/local/bin/mount-data-disk.sh && echo ONLINE || echo FAIL

代码

#!/bin/bash
# mount-data-disk.sh  --  bind-mount USB-DATA to /DATA
DEV=$(blkid -L ARMBIAN_DATA)
[ -z "$DEV" ] && { logger "USB-DATA: label ARMBIAN_DATA not found"; exit 1; }

# 如已挂载则退出
mountpoint -q /DATA && exit 0

# 本地/DATA防写解除（如上次卸载加了+i）
chattr -i /DATA 2>/dev/null

mkdir -p /mnt/usb-data
mountpoint -q /mnt/usb-data || mount -t auto -o defaults,noatime "$DEV" /mnt/usb-data
if [ $? -ne 0 ]; then
    logger "USB-DATA: mount $DEV -> /mnt/usb-data failed"
    exit 1
fi

# 检查/DATA目录存在
if [ ! -d /mnt/usb-data/DATA ]; then
    logger "USB-DATA: /mnt/usb-data/DATA missing"
    umount /mnt/usb-data
    exit 1
fi

# bind覆盖
mount --bind /mnt/usb-data/DATA /DATA
if [ $? -eq 0 ]; then
    logger "USB-DATA: /DATA now bind to $DEV"
    # 更新时间戳（给crond idle用）
    touch /var/lib/usb-data-last-used
else
    logger "USB-DATA: bind-mount failed"
    umount /mnt/usb-data
    exit 1
fi
exit 0

umount-data-disk.sh
用途：

无人使用 /DATA 时卸载、停转硬盘；
被 crond 或手动调用；
卸载后把 /DATA 重新锁成 immutable，防止误写。

使用方法

chmod 755 /usr/local/bin/umount-data-disk.sh
# 手动卸载
/usr/local/bin/umount-data-disk.sh

代码

#!/bin/bash
# umount-data-disk.sh  --  safe unmount + spin-down
# 1. 有人用就退出
lsof +f -- /DATA 2>/dev/null | grep -q . && { logger "USB-DATA: still in use"; exit 1; }
# 2. 解开bind
umount /DATA 2>/dev/null
# 3. 卸底层
umount /mnt/usb-data 2>/dev/null
# 4. 停转（找到实际设备）
DEV=$(blkid -L ARMBIAN_DATA)
[ -n "$DEV" ] && hdparm -y "$DEV" 2>/dev/null
# 5. 锁本地目录
chattr +i /DATA 2>/dev/null
logger "USB-DATA: unmounted and spun down"
exit 0

data-idle-check.sh
用途：

每 15 min 由 cron 调用；
如果 /DATA 已挂载且没人用 → 调用 umount-data-disk.sh。

使用方法

chmod 755 /usr/local/bin/data-idle-check.sh

代码

#!/bin/bash
# data-idle-check.sh
mountpoint -q /DATA || exit 0
lsof +f -- /DATA 2>/dev/null | grep -q . && exit 0
# 真的空闲
/usr/local/bin/umount-data-disk.sh

root crontab 一行
添加方式

sudo crontab -e
# 粘贴下面一行
*/15 * * * * /usr/local/bin/data-idle-check.sh

含义：每 15 min 检查一次空闲，想改 10 min 就把 */15 换成 */10。

4 个启动脚本里要插入的 3 行代码片段
把下面 3 行插到 每个 .sh 顶部（#!/bin/bash 之后，任何实际命令之前）：

# ---- ensure USB-DATA online ----
/usr/local/bin/mount-data-disk.sh || { echo "FATAL: USB-DATA not ready"; exit 1; }
touch /var/lib/usb-data-last-used

应用范围

rslsync.sh
docker.sh（systemctl start docker 之前）
casaos.sh（systemctl start casaos 之前）
immich.sh（docker compose up 之前）

data-auto-mount.path
用途：

由 systemd 监控 /DATA 的“访问事件”；
一旦访问且 /DATA 不是挂载点 → 启动 data-auto-mount.service。

安装方法

sudo tee /etc/systemd/system/data-auto-mount.path >/dev/null <<'EOF'
[Unit]
Description=Monitor /DATA access for auto-mount
[Path]
PathExists=/DATA
Unit=data-auto-mount.service
[Install]
WantedBy=multi-user.target
EOF

data-auto-mount.service
用途：

被 path 单元触发；
唯一工作：调用 mount-data-disk.sh；
成功后保持 active，避免反复启动。

安装方法

sudo tee /etc/systemd/system/data-auto-mount.service >/dev/null <<'EOF'
[Unit]
Description=Auto-mount USB-DATA when /DATA accessed
After=local-fs.target
[Service]
Type=oneshot
ExecStart=/usr/local/bin/mount-data-disk.sh
RemainAfterExit=yes
[Install]
WantedBy=multi-user.target
EOF

在 umount-data-disk.sh 里追加一行
目的：卸载后让 path 触发器重新进入监听状态。
把下面一行加到 umount-data-disk.sh 末尾（exit 0 之前）：

systemctl stop data-auto-mount.service

已完成合并，无需手动操作。

一条启用命令
使“访问即挂载”生效：

sudo systemctl daemon-reload
sudo systemctl enable --now data-auto-mount.path

至此，所有片段交付完毕。
按顺序执行即可实现：

插盘不自动挂；
任一服务或手动访问 /DATA 立即挂载；
15 min 无人访问自动卸载+休眠；
卸载后再次访问又会自动挂载。

使访问即挂载失效，就用：

sudo systemctl daemon-reload
sudo systemctl stop data-auto-mount.path