@echo off
setlocal enabledelayedexpansion

REM --- 用户配置 ---
REM 1. 7-Zip 的安装路径。
set "SEVENZIP_PATH=D:\Program Files\7-Zip\7z.exe"
REM 2. 备份文件最终移动到的目标文件夹。
set "BACKUP_DESTINATION=C:\Users\Administrator\OneDrive\Misskey_Backups"
REM 3. 临时文件名，脚本会自动创建和删除。
set "LIST_FILENAME=_backup_filelist.txt"


REM --- 脚本正文 ---

:init
cls
echo ==========================================================
echo                   Misskey 备份脚本
echo ==========================================================
echo.

REM 检查依赖
where docker >nul 2>nul
if %errorlevel% neq 0 (
    echo [严重错误] 未在系统中找到 "docker" 命令。
    goto end_script
)
if not exist "%SEVENZIP_PATH%" (
    echo [严重错误] 7z.exe 未在指定的路径找到: "%SEVENZIP_PATH%"
    goto end_script
)
if exist "%LIST_FILENAME%" (
    del /f /q "%LIST_FILENAME%"
)

echo [重要提示] 此脚本将通过 "stop/start" 模式来确保数据备份的完整性和一致性。
echo.
choice /c yn /m "是否确认开始执行备份流程？"
if errorlevel 2 (
    echo [取消] 用户取消了备份操作。
    goto end_script
)
echo.

REM --- 步骤 1: 停止 Docker 容器 ---
echo [步骤 1/5] 正在停止 Docker 容器以释放文件...
docker-compose stop
if %errorlevel% neq 0 (
    echo [严重错误] 停止 Docker 容器失败！请检查 Docker 是否正在运行。
    goto end_script
)
echo [成功] 所有 Misskey 相关容器已停止。
echo.

REM --- 步骤 2: 生成精确的文件列表 ---
echo [步骤 2/5] 正在生成精确的备份文件列表...
set "HAS_FILES=0"

REM 检查并将存在的文件/文件夹路径写入到 listfile 中
if exist "compose.yml" (
    echo compose.yml>>"%LIST_FILENAME%"
    echo   [状态] 已添加: compose.yml
    set "HAS_FILES=1"
) else (
    echo   [状态] 跳过: compose.yml (未找到)
)

if exist ".\.config\default.yml" (
    echo .config\default.yml>>"%LIST_FILENAME%"
    echo   [状态] 已添加: .config\default.yml
    set "HAS_FILES=1"
) else (
    echo   [状态] 跳过: .config\default.yml (未找到)
)

if exist ".\.config\docker.env" (
    echo .config\docker.env>>"%LIST_FILENAME%"
    echo   [状态] 已添加: .config\docker.env
    set "HAS_FILES=1"
) else (
    echo   [状态] 跳过: .config\docker.env (未找到)
)

if exist ".\db\" (
    echo db>>"%LIST_FILENAME%"
    echo   [状态] 已添加: 整个 db\ 文件夹
    set "HAS_FILES=1"
) else (
    echo   [状态] 跳过: db\ 文件夹 (未找到)
)

if exist ".\redis\" (
    echo redis>>"%LIST_FILENAME%"
    echo   [状态] 已添加: 整个 redis\ 文件夹
    set "HAS_FILES=1"
) else (
    echo   [状态] 跳过: redis\ 文件夹 (未找到)
)

if exist ".\files\" (
    echo files>>"%LIST_FILENAME%"
    echo   [状态] 已添加: 整个 files\ 文件夹
    set "HAS_FILES=1"
) else (
    echo   [状态] 跳过: files\ 文件夹 (未找到)
)
echo.

if %HAS_FILES% equ 0 (
    echo [错误] 未找到任何可备份的文件或文件夹！备份已中止。
    goto restart_services
)

REM --- 步骤 3: 使用文件列表执行备份 ---
echo [步骤 3/5] 正在根据文件列表执行备份...
for /f "tokens=1-4 delims=/ " %%a in ('date /t') do set "dt=%%b-%%c-%%d"
for /f "tokens=1-2 delims=: " %%a in ('time /t') do set "tm=%%a-%%b"
set "TIMESTAMP=%dt%_%tm%"
set "BACKUP_FILENAME=misskey_files_backup_%TIMESTAMP%.7z"

echo      - 备份目标文件: %BACKUP_FILENAME%
echo      - 正在压缩，请稍候...

"%SEVENZIP_PATH%" a -t7z -mx=9 -bso0 "%BACKUP_FILENAME%" @"%LIST_FILENAME%" > nul

if %errorlevel% neq 0 (
    echo.
    echo [错误] 文件备份失败！7-Zip 返回了错误。
    goto cleanup
)

echo.
echo [成功] 备份文件 "%BACKUP_FILENAME%" 已在当前目录下成功创建！
echo.

REM --- 步骤 4: 移动备份文件 ---
echo [步骤 4/5] 正在移动备份文件至目标文件夹...

REM 检查目标文件夹是否存在，如果不存在则创建
if not exist "%BACKUP_DESTINATION%\" (
    echo      - 目标文件夹不存在，正在创建:
    echo        "%BACKUP_DESTINATION%"
    mkdir "%BACKUP_DESTINATION%"
    if errorlevel 1 (
        echo      - [错误] 创建目标文件夹失败！文件将保留在当前目录。
        goto cleanup
    )
)

REM 移动文件
move /Y "%BACKUP_FILENAME%" "%BACKUP_DESTINATION%\" > nul

if %errorlevel% neq 0 (
    echo      - [错误] 移动文件失败！文件将保留在当前目录。
) else (
    echo      - [成功] 文件已移动至: "%BACKUP_DESTINATION%\"
)
echo.

:cleanup
REM --- 清理临时文件 ---
if exist "%LIST_FILENAME%" (
    del /f /q "%LIST_FILENAME%"
)

REM --- 步骤 5: 重启 Docker 容器 ---
:restart_services
echo [步骤 5/5] 正在恢复容器运行...
docker-compose start
if %errorlevel% neq 0 (
    echo [严重错误] 恢复 Docker 容器失败！请手动执行 "docker-compose start" 命令。
) else (
    echo [成功] 所有容器已恢复运行。
)
echo.

:end_script
echo ==========================================================
echo 备份流程结束。
echo ==========================================================
pause
exit /b

你可以修改脚本，将脚本中的路径改为实际可用的路径。

运行后，你将会看到类似以下输出：

==========================================================
                  Misskey 备份脚本
==========================================================

[重要提示] 此脚本将通过 "stop/start" 模式来确保数据备份的完整性和一致性。

是否确认开始执行备份流程？ [Y,N]?Y

[步骤 1/5] 正在停止 Docker 容器以释放文件...
[+] Stopping 3/3
 ✔ Container misskey-web-1    Stopped                                                                              0.7s
 ✔ Container misskey-db-1     Stopped                                                                              1.2s
 ✔ Container misskey-redis-1  Stopped                                                                              1.3s
[成功] 所有 Misskey 相关容器已停止。

[步骤 2/5] 正在生成精确的备份文件列表...
  [状态] 已添加: compose.yml
  [状态] 已添加: .config\default.yml
  [状态] 已添加: .config\docker.env
  [状态] 已添加: 整个 db\ 文件夹
  [状态] 已添加: 整个 redis\ 文件夹
  [状态] 已添加: 整个 files\ 文件夹

[步骤 3/5] 正在根据文件列表执行备份...
     - 备份目标文件: misskey_files_backup_2025-11-11_00-36.7z
     - 正在压缩，请稍候...

[成功] 备份文件 "misskey_files_backup_2025-11-11_00-36.7z" 已在当前目录下成功创建！

[步骤 4/5] 正在移动备份文件至目标文件夹...
     - [成功] 文件已移动至: "C:\Users\Administrator\OneDrive\Misskey_Backups\"

[步骤 5/5] 正在恢复容器运行...
[+] Running 3/3
 ✔ Container misskey-db-1     Healthy                                                                              5.9s
 ✔ Container misskey-redis-1  Healthy                                                                              5.9s
 ✔ Container misskey-web-1    Started                                                                              0.4s
[成功] 所有容器已恢复运行。

==========================================================
备份流程结束。
==========================================================
Press any key to continue . . .

这样，数据备份即完成了。

如果不确定备份是否有效，接下来可进行备份恢复测试。

恢复测试

「未经测试的备份相当于没有备份」

我们应定期进行备份的有效性检查，下面将给出备份恢复测试的流程。

恢复流程

恢复流程大致如下：

克隆同版本 Misskey 到本地
将备份的文件移动至 Misskey 目录
[可选] 修改 compose.yml 文件，将网页映射端口(默认3000)修改到另外端口，以便本机测试，避免影响现实联邦宇宙
关闭正在运行的容器（如果有），启动测试容器，等待完全启动完成
打开本机浏览器，输入 http://localhost:<port>/ 以查看恢复效果
关闭测试容器，启动主要容器。

按照以上述程操作即可，具体操作细节不赘述。

Misskey 数据备份与恢复测试

前言

数据备份

备份之前

开始备份

恢复测试

恢复流程

结语