前言#

作为 Misskey 实例服务器管理员，应该需要了解数据存放位置和备份方法，以防数据丢失。

本文接下来将介绍如何正确地备份 Misskey 服务器数据，并测试验证备份的数据是否可以完整地恢复 Misskey 实例。

此文章基于 Misskey 2025.10.2 编写，Misskey 部署方式是 Docker Compose。

数据备份#

备份之前#

在备份前，你需要知道要备份哪些文件。

如果你部署过 Misskey，应该会对 compose.yml 文件有印象，这个文件告诉 Docker 如何运行镜像。在这个文件中，需要特别注意那些 volumes 键对应的值，它指定了 Misskey 相关文件在本机的存放位置。

通过观察 compose.yml 的内容，可以发现数据保存在当前文件夹下的以下文件夹中：

1
.config\
2
db\
3
redis\
4
files\

加上 compose.yml 文件，这些就是我们需要备份的文件。

经过测试，redis 文件夹的数据备份是必要的，否则恢复后打开的网页将出现问题。

如果未启用过对象存储，所有媒体文件保存在 files 文件夹中，其存储容量可能会很大，备份复制文件时可能会花费大量时间，需要注意。

另外，在备份之前，如果已启用 Bot 防御功能，需要临时禁用，以确保后续在本机 localhost 上可成功登录账号。

开始备份#

备份需要遵循以下步骤：

停止容器运行（ docker compose down ）
复制数据文件
运行容器（ docker compose up -d ）

经过测试，停止容器是必要的，否则无法复制某些数据文件。

这三个步骤非常简单，你可以手动做，需要注意的是 docker compose 的停止和启动命令需要在 Misskey 项目文件夹下运行。

如果是 Windows 平台，我借助 AI 写了一个备份 bat 脚本，用于一键备份需要的文件到 7z 压缩包中，并将其移动到 OneDrive 备份文件夹实现自动云端备份。脚本内容见下：

1
@echo off
2
setlocal enabledelayedexpansion
3

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

12

13
REM --- 脚本正文 ---
14

15
:init
16
cls
17
echo ==========================================================
18
echo                   Misskey 备份脚本
19
echo ==========================================================
20
echo.
21

22
REM 检查依赖
23
where docker >nul 2>nul
24
if %errorlevel% neq 0 (
25
    echo [严重错误] 未在系统中找到 "docker" 命令。
26
    goto end_script
27
)
28
if not exist "%SEVENZIP_PATH%" (
29
    echo [严重错误] 7z.exe 未在指定的路径找到: "%SEVENZIP_PATH%"
30
    goto end_script
31
)
32
if exist "%LIST_FILENAME%" (
33
    del /f /q "%LIST_FILENAME%"
34
)
35

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

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

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

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

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

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

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

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

100
if exist ".\files\" (
101
    echo files>>"%LIST_FILENAME%"
102
    echo   [状态] 已添加: 整个 files\ 文件夹
103
    set "HAS_FILES=1"
104
) else (
105
    echo   [状态] 跳过: files\ 文件夹 (未找到)
106
)
107
echo.
108

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

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

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

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

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

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

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

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

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

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

160
:cleanup
161
REM --- 清理临时文件 ---
162
if exist "%LIST_FILENAME%" (
163
    del /f /q "%LIST_FILENAME%"
164
)
165

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

177
:end_script
178
echo ==========================================================
179
echo 备份流程结束。
180
echo ==========================================================
181
pause
182
exit /b

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

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

1
==========================================================
2
                  Misskey 备份脚本
3
==========================================================
4

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

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

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

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

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

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

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

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

40
==========================================================
41
备份流程结束。
42
==========================================================
43
Press any key to continue . . .

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

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

恢复测试#

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

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

恢复流程#

恢复流程大致如下：

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

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

前言#

数据备份#

备份之前#

开始备份#

恢复测试#

恢复流程#

结语#