Face Analysis WebUI Cache 目录清理与磁盘空间管理策略

3.2 定时清理：适合长期部署的服务器

通过 crontab 设置自动任务：

# 编辑 root 用户的 crontab
sudo crontab -e

添加以下行（每天凌晨 2:30 自动清理 7 天前的缓存）：

30 2 * * * find /root/build/cache/insightface/temp/ -maxdepth 1 -type d -mtime +7 -name "20*" -exec rm -rf {} \; >/dev/null 2>&1

可根据需求调整保留天数或执行频率。

3.3 按需清理：适合生产环境的精准管理

在 Gradio 层添加钩子，实现启动即清理。修改 /root/build/app.py：

import os
import glob
from datetime import datetime, timedelta

def cleanup_old_cache(days=3):
    """清理指定天数前的 temp 目录"""
    cache_dir = "/root/build/cache/insightface/temp"
    if not os.path.exists(cache_dir):
        return
    cutoff = datetime.now() - timedelta(days=days)
    for temp_dir in glob.glob(os.path.join(cache_dir, "20*")):
        try:
            date_part = os.path.basename(temp_dir).split("_")[0]
            dir_date = datetime.strptime(date_part, "%Y%m%d")
            if dir_date < cutoff:
                os.system(f"rm -rf '{temp_dir}'")
        except (ValueError, OSError):
            continue

# 启动前先清理一次
cleanup_old_cache(days=3)

配合 Gradio 的 server_lifespan 参数使用（需 Gradio ≥ 4.0）。

推荐组合：日常用定时清理（crontab）+ 上线前用按需清理 + 调试期用手动清理。

4. 磁盘空间自动管理：一个 50 行脚本搞定

当磁盘使用率超过 85% 时自动触发清理，低于 75% 停止干预。 创建脚本 /root/build/scripts/clean_cache.sh：

#!/bin/bash
# Face Analysis WebUI cache auto-manager
CACHE_DIR="/root/build/cache/insightface/temp"
DISK_PATH="/"
THRESHOLD_HIGH=85
THRESHOLD_LOW=75

CURRENT_USAGE=$(df "$DISK_PATH" | awk 'NR==2 {print $5}' | sed 's/%//')
echo "$(date): Disk usage is ${CURRENT_USAGE}%"

if [ "$CURRENT_USAGE" -gt "$THRESHOLD_HIGH" ]; then
    echo "High disk usage detected. Cleaning cache..."
    find "$CACHE_DIR" -maxdepth 1 -type d -mtime +7 -name "20*" -exec rm -rf {} \;
    find "$CACHE_DIR" -maxdepth 1 -type d -mtime +3 -name "20*" -exec rm -rf {} \;
    echo "Cache cleaned. Running du -sh $CACHE_DIR:"
    du -sh "$CACHE_DIR"
    logger "FaceWebUI cache auto-cleaned at $(date)"
elif [ "$CURRENT_USAGE" -lt "$THRESHOLD_LOW" ]; then
    echo "Disk usage normal. No action needed."
else
    echo "🟡 Disk usage in safe range (${CURRENT_USAGE}%). Monitoring..."
fi

加入 crontab 每 10 分钟检查一次：

*/10 * * * * /root/build/scripts/clean_cache.sh >> /var/log/facewebui-clean.log 2>&1

5. 高级建议：让 cache 更'懂你'

5.1 把 temp 目录移到独立分区

如果服务器有额外磁盘，建议将 cache 迁移到独立挂载点，避免影响主系统稳定性。

# 示例：创建新分区并挂载
sudo mkdir /mnt/cache-face
sudo mount /dev/sdb1 /mnt/cache-face
# 修改 WebUI 配置中的 cache 路径指向新位置

5.2 启用软链接替代硬路径

避免每次更新 WebUI 都要改路径，建立符号链接统一入口。

sudo mkdir -p /opt/face-cache
rm -rf /root/build/cache
ln -s /opt/face-cache /root/build/cache

5.3 记录分析日志，反向驱动清理策略

在 app.py 的分析函数中添加日志记录，便于分析用户行为与负载高峰，优化清理策略。

6. 总结

本文提供了一套可持续的磁盘空间治理思路：

• 分清两类缓存：模型缓存（保）vs 分析缓存（清）
• 三种清理姿势：手动（救急）、定时（守常）、按需（精准）
• 一个自动脚本：实现感知—决策—执行闭环
• 两个进阶习惯：独立分区存放、软链接解耦路径

定期执行清理操作，确保系统长期稳定运行。