刻の終着駅

4.1 申请 API 密钥#

配置 Google Drive 的远程连接，需要填入 Client ID，其实也可以直接使用公共的 Client ID，但是速度会比较慢，而且谷歌在逐步停用/限制公用共享 Client ID，所以我们可以申请一个自己的。这部分申请还挺麻烦的，你也可以直接使用公共的，先用着再说，可以跳过此节。
首先访问谷歌控制台
https://console.cloud.google.com/

顶部搜索栏搜索Google Drive API

点击启用，这里我已经启用过了，然后点管理

创建凭证

邮箱用你的谷歌邮箱就行

选桌面应用，名称随便填

把凭证下载下来，里面有Client ID 和Client Secret，点击完成

发布应用，否则会限制访问，不需要验证应用，直接用就行

4.2 配置 Rclone#

在 VPS 上安装 Rclone

1
sudo -v ; curl https://rclone.org/install.sh | sudo bash

输入以下指令，进入配置：

1
rclone config

e) Edit existing remote
n) New remote
d) Delete remote
r) Rename remote
c) Copy remote
s) Set configuration password
q) Quit config
e/n/d/r/c/s/q>

输入n，我们新建一个远程连接

Enter name for new remote.
name>

给这个配置起一个名字，这里我输入 gdrive

24 / Google Drive
\ (drive)
25 / Google Photos
\ (google photos)
26 / HTTP
\ (http)
27 / Hadoop distributed file system
\ (hdfs)
28 / HiDrive
\ (hidrive)
29 / Huawei Drive
\ (huaweidrive)
30 / ImageKit.io
\ (imagekit)

会显示非常多支持的存储类型，我这里 24 是 Google Drive，输入 24

Option client_id.
Google Application Client Id
Setting your own is recommended.
See https://rclone.org/drive/#making-your-own-client-id for how to create your own.
If you leave this blank, it will use an internal key which is low performance.
Enter a value. Press Enter to leave empty.
client_id>

如果你已经按照 4.1 节手动创建了客户端，可以直接打开下载的 json 文件，填入自己的Client ID。否则，直接回车留空，用公共的

Option client_secret.
OAuth Client Secret.
Leave blank normally.
Enter a value. Press Enter to leave empty.
client_secret>

同样，有自己的用自己的，没有就回车留空

Option scope.
Comma separated list of scopes that rclone should use when requesting access from drive.
Choose a number from below, or type in your own value.
Press Enter to leave empty.
1 / Full access all files, excluding Application Data Folder.
\ (drive)
2 / Read-only access to file metadata and file contents.
\ (drive.readonly)
/ Access to files created by rclone only.
3 | These are visible in the drive website.
| File authorization is revoked when the user deauthorizes the app. \ (drive.file)
/ Allows read and write access to the Application Data folder.
4 | This is not visible in the drive website.
\ (drive.appfolder)
/ Allows read-only access to file metadata but
5 | does not allow any access to read or download file content.
\ (drive.metadata.readonly)
scope>

权限限制，输入 1，给它完整的读写权限

Option service_account_file.
Service Account Credentials JSON file path.
Leave blank normally.
Needed only if you want use SA instead of interactive login.
Leading ~ will be expanded in the file name as will environment variables such as ${RCLONE_CONFIG_DIR}.
Enter a value. Press Enter to leave empty.
service_account_file>

回车留空

Edit advanced config?
y) Yes
n) No (default)
y/n>

输入n

Use web browser to automatically authenticate rclone with remote?
* Say Y if the machine running rclone has a web browser you can use
* Say N if running rclone on a (remote) machine without web browser access
If not sure try Y. If Y failed, try N.
y) Yes (default)
n) No
y/n>

这里是问我们登录认证的方式，VPS 上没有浏览器窗口，我们只能输入 n，在本地电脑上认证。

Option config_token.
For this to work, you will need rclone available on a machine that has a web browser available.
For more help and alternate methods see: https://rclone.org/remote_setup/
Execute the following on the machine with the web browser (same rclone version recommended):
rclone authorize “drive” “LpJpY27wpS18ImRyaRZlIn0”
Then paste the result.
Enter a value.

这里注意！它返回了一串命令rclone authorize “drive” “LpJpY27wpS18ImRyaRZlIn0”。记下来，我们需要在本地电脑上运行它。

如果你用的是 windows，打开你的 cmd，输入以下指令先安装 Rclone：

1
winget install Rclone.Rcloner

关闭当前窗口，打开一个新的 cmd 窗口

cmd 默认不走系统代理，我们先为这个窗口设置临时的代理变量。10808是v2ray的代理端口，如果你用的其它代理软件，替换成你自己。或者你可以直接打开梯子的 tun 模式。

1
$env:HTTP_PROXY="http://127.0.0.1:10808"
2
$env:HTTPS_PROXY="http://127.0.0.1:10808"

输入 VPS 上之前返回的指令，每个人的token不同，记得替换成你自己的：

1
rclone authorize "drive" "LpJpY27wpS18ImRyaRZlIn0"

随后，会跳转到浏览器上进行认证。如果你是用自己的客户端，因为没有验证会说有风险，在高级里面无视风险继续访问即可。
认证结束后，cmd 会返回一长串东西

Paste the following into your remote machine --->
你的token
<---End paste

把中间的 token 部分粘贴回 VPS，完成认证

Configure this as a Shared Drive (Team Drive)?
y) Yes
n) No (default)

输入 n，我们用的是个人云盘

Configuration complete.
Options:
- type: drive
- scope: drive
- token: {}
- team_drive:
Keep this “gdrive” remote?
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d>

配置结束，输入 y 保存

Name Type
==== ====
gdrive drive
e) Edit existing remote
n) New remote
d) Delete remote
r) Rename remote
c) Copy remote
s) Set configuration password
q) Quit config
e/n/d/r/c/s/q>

上面可以看到配置好的远程连接，输入 q，退出配置

验证一下能不能访问你的云盘。

1
rclone lsd gdrive:

如果没有报错，就是配置成功了。

4.3 自动备份脚本#

创建一个脚本

1
nano /opt/sillytavern/st_backup.sh

把以下内容粘贴进去。这个脚本是哈基米写的，做了比较多的异常判断，如果还是不行，请拷打哈基米。
可以手动修改备份数量，改成适合你的。如果备份文件实在大，云盘空间告急，可以把云盘备份数量改成1

1
#!/usr/bin/env bash
2

3
# ==================== 配置区域 ====================
4
ST_ROOT_DIR="/opt/sillytavern"
5
LOCAL_BACKUP_DIR="/root/backups/sillytavern"
6
REMOTE_PATH="gdrive:SillyTavern_Backups"
7

8
#本地备份数量
9
LOCAL_KEEP_COPIES=1
10
#云盘备份数量
11
CLOUD_KEEP_COPIES=5
12
# ==================================================
13

14
TIMESTAMP=$(date +"%Y%m%d_%H%M%S")
15
ARCHIVE_NAME="st_backup_${TIMESTAMP}.tar.gz"
16
LOCAL_FILE="${LOCAL_BACKUP_DIR}/${ARCHIVE_NAME}"
17

18
mkdir -p "${LOCAL_BACKUP_DIR}"
19

20
echo "=================================================="
21
echo "[$(date)] -> 准备开始备份..."
22

23
# 1. 进入酒馆目录，如果失败则直接退出
24
if ! cd "${ST_ROOT_DIR}"; then
25
    echo "[$(date)] -> 致命错误: 找不到目录 ${ST_ROOT_DIR}"
26
    exit 1
27
fi
28

29
# 2. 停机
30
echo "[$(date)] -> 暂停 SillyTavern 容器..."
31
docker compose stop
32

33
# 3. 打包
34
echo "[$(date)] -> 开始打包酒馆核心数据卷与配置..."
35
tar -czf "${LOCAL_FILE}" data config plugins extensions docker-compose.yml
36
TAR_EXIT_CODE=$?
37

38
# 4.第一时间拉起
39
echo "[$(date)] -> 容器重新恢复..."
40
docker compose start
41

42
# 5. 校验打包文件
43
if [ $TAR_EXIT_CODE -ge 2 ]; then
44
    echo "[$(date)] -> 致命错误: tar 打包发生严重错误 (退出码 $TAR_EXIT_CODE)！请检查日志。"
45
    rm -f "${LOCAL_FILE}"
46
    exit 1
47
fi
48

49
# 检查文件是否存在，并且体积是否大于 10KB
50
if [ ! -s "${LOCAL_FILE}" ] || [ $(stat -c%s "${LOCAL_FILE}") -lt 10240 ]; then
51
    echo "[$(date)] -> 致命错误: 备份文件不存在或体积过小！可能磁盘已满。"
52
    echo "[$(date)] -> 为保护云端历史备份不被脏数据替换，脚本已终止。"
53
    rm -f "${LOCAL_FILE}"
54
    exit 1
55
fi
56

57
if [ $TAR_EXIT_CODE -eq 1 ]; then
58
    echo "[$(date)] -> 提示: tar 打包过程有警告 (通常是部分非关键目录不存在或文件被修改)，但不影响核心数据。"
59
fi
60

61
# 6. 优先清理本地备份
62
echo "[$(date)] -> 清理本地多余备份 (仅保留最新 ${LOCAL_KEEP_COPIES} 份)..."
63
cd "${LOCAL_BACKUP_DIR}"
64
ls -1 st_backup_*.tar.gz 2>/dev/null | sort -r | tail -n +$((LOCAL_KEEP_COPIES + 1)) | xargs -r rm -f
65

66
# 7. 上传至 Google Drive
67
echo "[$(date)] -> 开始上传至 Google Drive..."
68
if rclone copy "${LOCAL_FILE}" "${REMOTE_PATH}" --drive-chunk-size 64M --transfers=1 -v; then
69
    echo "[$(date)] -> 上传成功！"
70
else
71
    echo "[$(date)] -> 错误: rclone 上传失败，请检查网络或授权。"
72
    exit 1
73
fi
74

75
# 8. 清理云盘备份
76
echo "[$(date)] -> 清理 Google Drive 多余备份 (仅保留最新 ${CLOUD_KEEP_COPIES} 份)..."
77
rclone lsf --files-only "${REMOTE_PATH}" 2>/dev/null \
78
    | grep '^st_backup_.*\.tar\.gz$' \
79
    | sort -r \
80
    | tail -n +$((CLOUD_KEEP_COPIES + 1)) \
81
    | while read -r filename; do
82
        # 规避 grep 匹配不到数据时 filename 为空导致误删的问题
83
        if [ -n "$filename" ]; then
84
            echo "[$(date)] -> 正在彻底删除云端过期备份: ${filename}"
85
            rclone deletefile "${REMOTE_PATH}/${filename}" --drive-use-trash=false
86
        fi
87
    done
88

89
echo "[$(date)] -> Google Drive 自动化备份全流程顺利完成！"
90
echo "=================================================="

给脚本添加可执行权限

1
sudo chmod +x /opt/sillytavern/st_backup.sh

手动测试脚本能否正常运行

1
/opt/sillytavern/st_backup.sh

设置定时任务，自动备份

1
crontab -e

如果是第一次使用，它会让你选择编辑器模式，输入 1，使用 nano 即可，填入以下表达式：

1
0 21 * * * /opt/sillytavern/st_backup.sh >> /var/log/st_backup.log 2>&1

这个 cron 表达式的意思是每天 UTC 时间21点，即北京时间 5 点执行一次备份脚本。如果你的备份文件很大，每天都备份，服务器流量吃不消，也可以用下面这个每周一 5 点备份一次的 cron 表达式：

1
0 21 * * 0 /opt/sillytavern/st_backup.sh >> /var/log/st_backup.log 2>&1

这是在你服务器时区是 UTC 的情况下，才对的上时差。你可以输入 date 查看服务器的时区。让 AI 帮你编写更个性化的 cron 表达式。

4.4 数据恢复#

如果某天，你的服务器真的炸了（概率很低，但我真炸了一次，补偿了三个月），或者需要数据迁移，可以直接使用备份文件。
如果服务器里的数据还在，直接使用 /root/backups/sillytavern/ 里的本地备份就行。如果服务器彻底没了，去云盘下载最新的备份文件，用 SSH 客户端的文件传输功能手动上传到服务器。
假设你的备份文件已经放在了 /root/backups/sillytavern/ 目录：
同样先创建一个存放酒馆文件的目录

1
mkdir -p /opt/sillytavern

解压备份文件到该目录

1
tar -xzf /root/backups/sillytavern/你的备份文件名 -C /opt/sillytavern

进入目录

1
cd /opt/sillytavern

如果新服务器上没有docker需要先安装，然后一键拉起容器

1
docker compose up -d

你的所有角色、聊天记录、世界书、API 密钥设置、密码、甚至是安装过的第三方插件等等都会恢复。但是 Caddy 的配置文件不在备份范围内，需要再做一次第 3 节