studybuddy_recover

一键脚本

• 免交互式 默认从 /var/lib/StudyBuddy/backup 恢复最新备份

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

补充说明

该脚本用于 StudyBuddy 服务数据一键恢复，流程为：读取 /etc/studybuddy.conf 安装记录得到安装目录 → 在备份目录中自动查找最新的 StudyBuddy-*.tar.gz 备份文件 → 停止服务并清空旧 data/archive 后解包恢复 → systemctl daemon-reload 重载配置并启动服务 → 检测服务状态。

功能特点

• 免交互设计：无需任何输入，适合数据恢复场景快速执行
• 自动找最新：兼容秒级时间戳 StudyBuddy-YYYY-MM-DD_HH-MM-SS.tar.gz 与旧格式 StudyBuddy-YYYY-MM-DD.tar.gz 两种备份文件名
• 支持指定文件：第二参数可直接指定备份文件名，跳过「取最新」逻辑
• 残留清理：恢复前先清空旧 data/archive 内容，避免新旧数据混杂
• 服务自愈：恢复完成后 systemctl daemon-reload 重载配置并启动 studybuddy 服务
• 无备份保护：目录中无备份文件时红色提示并退出，避免误操作
• 参数兼容：支持传参指定备份目录，逻辑与备份脚本保持一致
• 彩色日志：备份目录、恢复文件、执行过程均彩色高亮输出

输出说明

脚本输出包含以下内容：

注意事项

• 需要 root 权限执行，脚本依赖 systemctl 停止/启动 studybuddy 服务
• 安装目录优先读取安装记录 /etc/studybuddy.conf（APP_DIR 键），缺失时使用默认值 /var/lib/StudyBuddy
• 恢复操作会清空并覆盖现有 data 与 archive 数据，执行前请确认备份文件可用
• 恢复文件通过文件名时间戳排序取最新，确保恢复到最新版本
• 默认备份目录 /var/lib/StudyBuddy/backup 可根据实际环境传参覆盖
• 兼容 StudyBuddy-YYYY-MM-DD.tar.gz 与 StudyBuddy-YYYY-MM-DD_HH-MM-SS.tar.gz 两种命名格式
• 备份目录不存在或为空时脚本报错退出，不会误恢复
• 建议与 studybuddy_backup 备份脚本配合使用

脚本源码

#!/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
SERVICE="studybuddy"
CONFIG_FILE="/etc/studybuddy.conf"
APP_DIR="/var/lib/StudyBuddy"
# 从安装记录读取安装目录/备份目录（不存在时使用默认值）
BACKUP_DIR=""
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}"

# 参数解析：1) 备份目录 2) 指定还原文件（可选，缺省取最新备份）
# 用法：
# ./studybuddy_recover.sh                          # 默认目录，取该目录最新备份
# ./studybuddy_recover.sh /data/bak [文件名]        # 指定目录，可选指定文件
parse_args() {
    local p1="${1:-}"
    local p2="${2:-}"
    if [[ -n "${p1}" ]]; then
        BACKUP_DIR="${p1}"
    fi
    if [[ -n "${p2}" ]]; then
        RESTORE_FILE_ARG="${p2}"
    fi
}
RESTORE_FILE_ARG=""
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}${APP_DIR}/data、${APP_DIR}/archive${gl_bai}"

command -v systemctl >/dev/null 2>&1 || { echo -e "${gl_hong}❌ 未检测到 systemctl，无法恢复服务${gl_bai}"; exit 1; }

mkdir -p "${BACKUP_DIR}"

echo -e ""
if [ -n "${RESTORE_FILE_ARG}" ]; then
    echo -e "${gl_lan}>>> 使用指定备份文件${gl_bai}"
    if [[ "${RESTORE_FILE_ARG}" =~ ^StudyBuddy-.*\.tar\.gz$ ]] && [ -f "${BACKUP_DIR}/${RESTORE_FILE_ARG}" ]; then
        f="${RESTORE_FILE_ARG}"
    else
        echo -e "${gl_hong}❌ 指定的备份文件不存在: ${RESTORE_FILE_ARG}${gl_bai}"
        exit 1
    fi
else
    echo -e "${gl_lan}>>> 查找最新备份文件${gl_bai}"
    f=$(find "$BACKUP_DIR" -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 \
    | tail -n1 \
    | awk '{print $2}')
fi

if [ -z "$f" ];then
    echo -e "${gl_hong}❌ 无备份文件，退出${gl_bai}"
    exit 1
fi

RESTORE_FILE="${BACKUP_DIR}/${f}"
echo -e "${gl_huang}恢复文件: ${gl_lv}${RESTORE_FILE}${gl_bai}"

echo -e ""
echo -e "${gl_huang}>>> 停止 ${SERVICE} 服务${gl_bai}"
systemctl stop ${SERVICE}

echo -e ""
echo -e "${gl_huang}>>> 执行恢复${gl_bai}"
# 备份内容为 data/ 与 archive/ 全部内容；恢复前先清空旧数据，避免残留文件
find "${APP_DIR}/data" -mindepth 1 -maxdepth 1 -exec rm -rf {} + 2>/dev/null || true
find "${APP_DIR}/archive" -mindepth 1 -maxdepth 1 -exec rm -rf {} + 2>/dev/null || true
mkdir -p "${APP_DIR}/data" "${APP_DIR}/archive"
if tar -xzf "${RESTORE_FILE}" -C "${APP_DIR}"; then
    echo -e "${gl_lv}>>> 恢复完成${gl_bai}"
else
    echo -e "${gl_hong}❌ 恢复失败，正在启动服务${gl_bai}"
    systemctl start ${SERVICE}
    exit 1
fi

echo -e ""
echo -e "${gl_huang}>>> 重载systemd配置并启动服务${gl_bai}"
systemctl daemon-reload
systemctl start ${SERVICE}

sleep 2
STATUS=$(systemctl is-active ${SERVICE})
case "${STATUS}" in
    active)
        echo -e "${gl_lv}✅ 服务状态：运行中${gl_bai}"
        ;;
    inactive)
        echo -e "${gl_hong}❌ 服务状态：已停止${gl_bai}"
        ;;
    failed)
        echo -e "${gl_hong}❌ 服务状态：启动失败${gl_bai}"
        ;;
    *)
        echo -e "${gl_huang}⚠️ 服务状态：${STATUS}${gl_bai}"
        ;;
esac
echo -e "${gl_bufan}————————————————————————————————————————————————${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_recover 👈 当前所在位置
• studybuddy_backup
• 2panel_recover
• universal_backup