studybuddy_backup

一键脚本

• 免交互式 默认备份到 /var/lib/StudyBuddy/backup，保留 6 份

bash <(curl -sL https://raw.githubusercontent.com/meimolihan/StudyBuddy/main/scripts/studybuddy_backup.sh) "/var/lib/StudyBuddy/backup" 6

补充说明

该脚本用于 StudyBuddy 服务数据一键备份，流程为：读取 /etc/studybuddy.conf 安装记录得到安装目录 → 在线打包 data（全局账号库 + 学生私有库）与 archive（归档试卷）目录生成备份文件（文件名精确到秒）→ 按保留数量自动清理过期备份。全程不停止服务，SQLite 数据库带 -wal/-shm 一并打包。

功能特点

• 免交互设计：无需任何输入，适合配合 crontab / 计划任务定时执行
• 在线不停服：备份期间服务正常运行，学生刷题不中断
• 参数兼容：支持「目录」「保留数」两种参数互换，./studybuddy_backup.sh 8 /data/bak 与 ./studybuddy_backup.sh /data/bak 8 效果相同
• 秒级时间戳：备份文件名格式为 StudyBuddy-YYYY-MM-DD_HH-MM-SS.tar.gz，避免同名覆盖
• 自动清理：扫描备份目录中 StudyBuddy-*.tar.gz 文件，按时间排序保留最新 N 份，删除过期文件
• 读取安装记录：自动从 /etc/studybuddy.conf 读取 APP_DIR/BACKUP_DIR，与 install.sh 无缝衔接
• 彩色日志：保存目录、保留数量、执行过程、删除列表均彩色高亮输出
• 默认安全：默认保留 6 份备份，防止意外删除

输出说明

脚本输出包含以下内容：

注意事项

• 数据目录优先读取安装记录 /etc/studybuddy.conf（APP_DIR 键），缺失时使用默认值 /var/lib/StudyBuddy
• 在线备份基于 tar 打包，若恰逢写入 SQLite 高峰极小概率出现 -wal 未合并，重要备份前可在管理面板静置几秒
• 备份目录需有写权限，脚本会自动 mkdir -p 创建目录
• 默认备份目录 /var/lib/StudyBuddy/backup 可根据实际环境传参覆盖
• 清理逻辑基于文件名时间戳排序，确保删除的是最旧的备份
• 建议配合定时任务（crontab / 计划任务）每日执行一次

定时任务示例

# 下载脚本到系统目录
curl -fsSL https://raw.githubusercontent.com/meimolihan/StudyBuddy/main/scripts/studybuddy_backup.sh -o /usr/local/bin/studybuddy_backup

# 增加执行权限
chmod +x /usr/local/bin/studybuddy_backup

# 追加定时任务（防重复追加）
(crontab -l 2>/dev/null | grep -Fq '/usr/local/bin/studybuddy_backup /var/lib/StudyBuddy/backup 6') || (crontab -l 2>/dev/null; echo '30 2 * * * /usr/local/bin/studybuddy_backup /var/lib/StudyBuddy/backup 6 >> /var/log/studybuddy_backup.log 2>&1') | crontab -

# 查看日志
cat /var/log/studybuddy_backup.log

脚本源码

#!/bin/bash
set -uo pipefail

# ================== terminal colors ==================
list_color_init() {
    export gl_hui=$'\033[38;5;59m'
    export gl_hong=$'\033[38;5;9m'
    export gl_lv=$'\033[38;5;10m'
    export gl_huang=$'\033[38;5;11m'
    export gl_lan=$'\033[38;5;32m'
    export gl_bai=$'\033[38;5;15m'
    export gl_zi=$'\033[38;5;13m'
    export gl_bufan=$'\033[38;5;14m'
    export reset=$'\033[0m'
}
list_color_init
# 默认值
BACKUP_DIR=""
KEEP_NUM=6
SERVICE="studybuddy"
CONFIG_FILE="/etc/studybuddy.conf"
APP_DIR="/var/lib/StudyBuddy"

# 从安装记录读取安装目录/备份目录（不存在时使用默认值）
if [ -f "${CONFIG_FILE}" ]; then
  while IFS='=' read -r KEY VALUE; do
    KEY=$(printf '%s' "$KEY" | tr -d ' ')
    [ "$KEY" = "APP_DIR" ] && [ -n "$VALUE" ] && APP_DIR="${VALUE}"
    [ "$KEY" = "BACKUP_DIR" ] && [ -n "$VALUE" ] && BACKUP_DIR="${VALUE}"
  done < "${CONFIG_FILE}"
fi
BACKUP_DIR="${BACKUP_DIR:-${APP_DIR}/backup}"

# 参数解析，支持两种传参顺序可互换
# 用法示例：
# ./studybuddy_backup.sh                     # 使用默认
# ./studybuddy_backup.sh 10                  # 只传保留份数
# ./studybuddy_backup.sh /data/bak           # 只传备份目录
# ./studybuddy_backup.sh /data/bak 8         # 目录 保留数
# ./studybuddy_backup.sh 8 /data/bak         # 保留数 目录，顺序互换兼容
parse_args() {
    local p1="${1:-}"
    local p2="${2:-}"

    if [[ -z "${p1}" ]]; then
        return
    fi

    if [[ "${p1}" =~ ^[0-9]+$ ]]; then
        KEEP_NUM="${p1}"
        if [[ -n "${p2}" ]]; then
            BACKUP_DIR="${p2}"
        fi
    else
        BACKUP_DIR="${p1}"
        if [[ -n "${p2}" && "${p2}" =~ ^[0-9]+$ ]]; then
            KEEP_NUM="${p2}"
        fi
    fi
}
parse_args "$@"

echo -e "${gl_zi}>>> 备份 StudyBuddy${gl_bai}"
echo -e "${gl_bufan}————————————————————————————————————————————————${gl_bai}"
echo -e "${gl_huang}保存目录：${gl_lv}${BACKUP_DIR}${gl_bai}"
echo -e "${gl_huang}保留数量：${gl_lv}${KEEP_NUM}${gl_bai}"
echo -e "${gl_huang}数据目录：${gl_lv}${APP_DIR}/data、${APP_DIR}/archive${gl_bai}"

[ -d "${APP_DIR}/data" ] || { echo -e "${gl_hong}❌ 数据目录不存在: ${APP_DIR}/data${gl_bai}"; exit 1; }

# 文件名精确到秒 YYYY-MM-DD_HH-MM-SS
NOW=$(date +%Y-%m-%d_%H-%M-%S)
BACKUP_FILE="${BACKUP_DIR}/StudyBuddy-${NOW}.tar.gz"

mkdir -p "${BACKUP_DIR}"

# 在线备份：不停止服务，SQLite 数据库带 -wal/-shm 一并打包
echo -e ""
echo -e "${gl_lan}>>> 执行备份：${BACKUP_FILE}${gl_bai}"
if tar -czf "${BACKUP_FILE}" -C "${APP_DIR}" data archive; then
    echo -e "${gl_lv}>>> 备份完成：${BACKUP_FILE}${gl_bai}"
else
    echo -e "${gl_hong}❌ 备份失败${gl_bai}"
    exit 1
fi

cd "${BACKUP_DIR}" || exit 1

# 正则适配格式：StudyBuddy-YYYY-MM-DD_HH-MM-SS.tar.gz
old_files=$(find . -maxdepth 1 -type f -name "StudyBuddy-*.tar.gz" -printf "%f\n" \
| sed -E 's/^StudyBuddy-([0-9]{4}-[0-9]{2}-[0-9]{2}_[0-9]{2}-[0-9]{2}-[0-9]{2})\.tar\.gz$/\1 &/' \
| sort -k1,1 \
| head -n -${KEEP_NUM} \
| awk '{print $2}')

if [ -n "${old_files}" ];then
    echo -e ""
    echo -e "${gl_hong}>>> 将删除过期备份文件：${gl_bai}"
    echo "${old_files}"
    echo "${old_files}" | xargs -I {} rm -f "./{}"
else
    echo -e "${gl_lv}>>> 无过期备份需要删除${gl_bai}"
fi

echo -e "${gl_bufan}————————————————————————————————————————————————${gl_bai}"
echo -e "${gl_lv}✔ 备份完成：${BACKUP_FILE}${gl_bai}"
echo -e "${gl_huang}还原命令：bash scripts/studybuddy_recover.sh${gl_bai}"

创建本地脚本

new_script="new_test.sh"

cat > "$new_script" << 'EOF'
#!/bin/bash

# 粘贴脚本源码

EOF

chmod +x "$new_script" && ./"$new_script" && rm -f "$new_script"

相关命令

• studybuddy
• studybuddy_backup 👈 当前所在位置
• studybuddy_recover
• 2panel_backup
• universal_backup