Waline 评论系统自动备份到 GitHub

2026年7月27日·#技术分享Waline/脚本·1776 字 9 分钟

浏览量加载中...

AI 摘要

介绍如何给 Waline 评论系统加一个自动备份到 GitHub 的脚本

数据库只有一个 SQLite 文件，丢了就真没了。写个脚本每天自动备份到 GitHub 私有仓库，安心。

背景#

Waline 默认使用 SQLite 存储数据，整个数据库就是一个 waline.sqlite 文件。好处是轻量、不需要额外装数据库；坏处是文件丢了就什么都没了。

虽然服务器有快照功能，但快照是整个系统的，恢复起来太重。不如写个脚本，每天把关键文件打包推到 GitHub，恢复的时候一条命令搞定。

思路#

把 data/ 目录（SQLite 数据库）和 docker-compose.yml 打包成 .tar.gz
推送到 GitHub 私有仓库
用 crontab 每天凌晨 3 点自动执行
本地只保留最近 7 份，GitHub 保留 30 天

准备工作#

创建 GitHub 私有仓库#

去 GitHub 新建一个仓库，一定要选 Private。名字随意，比如 waline-backup。

生成 GitHub Token#

打开 GitHub Fine-grained tokens
点 Generate new token
Repository access 选 Only select repositories，勾选刚创建的仓库
Repository permissions → Contents → 选 Read and write
生成并保存 Token

⚠️ Token 只会显示一次，务必保存好。如果泄露了，立刻去 GitHub 撤销。

备份脚本#

1
#!/bin/bash
2
WALINE_DIR="/opt/waline"
3
BACKUP_DIR="/opt/waline/backup"
4
GITHUB_USER="你的GitHub用户名"
5
GITHUB_REPO="waline-backup"
6
GITHUB_TOKEN="你的GitHub Token"
7
KEEP_DAYS=30
8

9
log() {
10
    echo "[$(date '+%Y-%m-%d %H:%M:%S')] $1"
11
}
12

13
log "========== Waline 备份开始 =========="
14
mkdir -p "$BACKUP_DIR"
15
cd "$BACKUP_DIR"
16

17
# 首次运行：初始化 Git 仓库
18
if [ ! -d ".git" ]; then
19
    git init
20
    git remote add origin "https://${GITHUB_TOKEN}@github.com/${GITHUB_USER}/${GITHUB_REPO}.git"
21
    git config user.email "backup@waline.local"
22
    git config user.name "Waline Backup"
23
    git branch -m master main
24
fi
25

26
# 拉取远程最新
27
git fetch origin main 2>/dev/null
28
git reset --soft origin/main 2>/dev/null
29

30
# 打包
31
TIMESTAMP=$(date +%Y%m%d_%H%M%S)
32
BACKUP_FILE="waline-backup-${TIMESTAMP}.tar.gz"
33

34
log "正在打包..."
35
tar czf "$BACKUP_FILE" -C "$WALINE_DIR" data docker-compose.yml 2>/dev/null
36

37
if [ $? -ne 0 ]; then
38
    log "打包失败！"
39
    exit 1
40
fi
41

42
FILE_SIZE=$(du -h "$BACKUP_FILE" | cut -f1)
43
log "打包完成：${BACKUP_FILE} (${FILE_SIZE})"
44

45
# 清理旧备份
46
find "$BACKUP_DIR" -name "waline-backup-*.tar.gz" -mtime +${KEEP_DAYS} -delete
47

48
# 推送到 GitHub
49
git add -A
50
git commit -m "backup: ${TIMESTAMP}"
51
log "正在推送到 GitHub..."
52
git push origin main 2>&1
53

54
if [ $? -eq 0 ]; then
55
    log "推送成功！"
56
else
57
    log "推送失败！"
58
    exit 1
59
fi
60

61
# 本地只保留最近 7 个
62
ls -t waline-backup-*.tar.gz 2>/dev/null | tail -n +8 | xargs -r rm -f
63

64
log "========== Waline 备份完成 =========="

把 GITHUB_USER 和 GITHUB_TOKEN 换成你自己的，保存为 /opt/waline/backup.sh。

部署#

1
# 保存脚本
2
vi /opt/waline/backup.sh
3
# 粘贴上面的脚本内容，保存退出
4

5
# 设置执行权限
6
chmod +x /opt/waline/backup.sh
7

8
# 手动测试一次
9
/opt/waline/backup.sh

看到 推送成功！ 就说明没问题了。然后添加定时任务：

1
# 添加到 crontab（每天凌晨 3 点执行）
2
(crontab -l 2>/dev/null; echo "0 3 * * * /opt/waline/backup.sh >> /opt/waline/backup/backup.log 2>&1") | crontab -
3

4
# 确认
5
crontab -l

在新服务器上恢复部署#

服务器到期、迁移、或者挂了，都需要在新机器上恢复。下面是完整的恢复流程。

前提条件#

一台新的服务器（腾讯云、阿里云都行）
域名 DNS 已指向新服务器 IP
GitHub 备份仓库中有最近的备份

第一步：安装宝塔面板#

1
# Ubuntu / Debian
2
wget -O install.sh https://download.bt.cn/install/install-ubuntu_6.0.sh && sudo bash install.sh
3

4
# CentOS
5
yum install -y wget && wget -O install.sh https://download.bt.cn/install/install_6.0.sh && sh install.sh

登录宝塔面板，跳过 LNMP 套件安装。

第二步：安装 Docker#

宝塔面板 → 软件商店 → 搜索「Docker管理器」→ 安装。

或者手动安装：

1
curl -fsSL https://get.docker.com | sh
2
systemctl start docker && systemctl enable docker

第三步：拉取备份并恢复#

1
# 克隆备份仓库
2
mkdir -p /opt/waline
3
git clone https://你的Token@github.com/你的用户名/waline-backup.git /opt/waline/backup
4

5
# 找到最新的备份文件
6
ls -t /opt/waline/backup/waline-backup-*.tar.gz | head -1
7

8
# 解压到 /opt/waline
9
cd /opt/waline
10
tar xzf backup/waline-backup-$(date +%Y%m%d)*.tar.gz
11
# 如果上面找不到文件，用这个（自动选最新的）：
12
# tar xzf backup/$(ls -t backup/waline-backup-*.tar.gz | head -1)

解压后目录结构应该是：

1
/opt/waline/
2
├── data/
3
│   └── waline.sqlite        # 数据库（所有评论、用户数据都在这里）
4
├── docker-compose.yml        # 容器配置
5
└── backup/                   # 备份目录

第四步：启动 Waline#

1
cd /opt/waline
2
docker compose up -d

验证：

1
docker ps                                    # 容器应该在运行
2
curl http://127.0.0.1:8360                   # 应该返回 HTML

第五步：配置 Nginx 反向代理#

宝塔 → 软件商店 → 安装 Nginx
网站 → 添加站点 → 填域名（如 waline.你的域名），PHP 选「纯静态」
点击站点 → 设置 → 反向代理 → 添加反向代理：
- 代理名称：waline
- 目标 URL：http://127.0.0.1:8360
- 发送域名：$host
编辑反向代理配置，加上 CORS 处理（否则浏览器注册/登录会报错）：

1
#PROXY-START/
2

3
location ^~ /
4
{
5
    # CORS 预检请求处理
6
    if ($request_method = 'OPTIONS') {
7
        add_header 'Access-Control-Allow-Origin' '$http_origin' always;
8
        add_header 'Access-Control-Allow-Methods' 'GET,POST,PUT,DELETE,OPTIONS' always;
9
        add_header 'Access-Control-Allow-Headers' 'Authorization,Content-Type' always;
10
        add_header 'Access-Control-Max-Age' 1728000 always;
11
        add_header 'Content-Length' 0;
12
        return 204;
13
    }
14

15
    proxy_pass http://127.0.0.1:8360;
16
    proxy_set_header Host $host;
17
    proxy_set_header X-Real-IP $remote_addr;
18
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
19
    proxy_set_header X-Forwarded-Proto $scheme;
20
    proxy_set_header REMOTE-HOST $remote_addr;
21
    proxy_set_header Upgrade $http_upgrade;
22
    proxy_set_header Connection $connection_upgrade;
23
    proxy_http_version 1.1;
24

25
    add_header X-Cache $upstream_cache_status;
26
    add_header 'Access-Control-Allow-Origin' '$http_origin' always;
27
    add_header 'Access-Control-Allow-Methods' 'GET,POST,PUT,DELETE,OPTIONS' always;
28
    add_header 'Access-Control-Allow-Headers' 'Authorization,Content-Type' always;
29

30
    set $static_filew6OwwKmG 0;
31
    if ( $uri ~* "\.(gif|png|jpg|css|js|woff|woff2)$" )
32
    {
33
        set $static_filew6OwwKmG 1;
34
        expires 1m;
35
    }
36
    if ( $static_filew6OwwKmG = 0 )
37
    {
38
        add_header Cache-Control no-cache;
39
    }
40
}
41

42
#PROXY-END/

保存后重载 Nginx：

1
nginx -t && nginx -s reload

第六步：申请 SSL 证书#

站点设置 → SSL → Let’s Encrypt → 申请 → 勾选「强制 HTTPS」。

第七步：验证评论系统正常#

访问 https://waline.你的域名，确认：

页面能正常加载
能看到之前的评论数据（因为 SQLite 数据库恢复了）
能发新评论

第八步：重新配置自动备份#

1
# 把备份脚本也恢复过去
2
chmod +x /opt/waline/backup.sh
3

4
# 替换 GitHub Token（如果需要）
5
vi /opt/waline/backup.sh
6

7
# 测试备份
8
/opt/waline/backup.sh
9

10
# 添加定时任务
11
(crontab -l 2>/dev/null; echo "0 3 * * * /opt/waline/backup.sh >> /opt/waline/backup/backup.log 2>&1") | crontab -

完整恢复命令汇总#

如果你对 Linux 比较熟悉，可以把上面的步骤浓缩成几条命令：

1
# 1. 安装 Docker
2
curl -fsSL https://get.docker.com | sh
3
systemctl start docker && systemctl enable docker
4

5
# 2. 拉取备份
6
mkdir -p /opt/waline
7
git clone https://TOKEN@github.com/USER/waline-backup.git /opt/waline/backup
8

9
# 3. 解压
10
cd /opt/waline
11
tar xzf backup/$(ls -t backup/waline-backup-*.tar.gz | head -1)
12

13
# 4. 启动
14
docker compose up -d
15

16
# 5. 恢复备份脚本和定时任务
17
chmod +x /opt/waline/backup.sh
18
(crontab -l 2>/dev/null; echo "0 3 * * * /opt/waline/backup.sh >> /opt/waline/backup/backup.log 2>&1") | crontab -

然后去宝塔配 Nginx 和 SSL 就行。

💡 整个恢复过程大概 10-15 分钟，其中大部分时间花在等宝塔和 Docker 安装上。数据恢复本身只需要几秒钟。

踩坑记录#

Git 默认分支是 master#

服务器上的 Git 默认创建 master 分支，但 GitHub 新仓库默认是 main。脚本里加了 git branch -m master main 解决。如果已经初始化了 master，手动执行一下：

1
cd /opt/waline/backup
2
git branch -m master main
3
git push -u origin main

Token 安全#

Token 直接写在脚本里不是最佳实践，但因为脚本在自己服务器上、仓库是私有的，风险可控。如果介意，可以用环境变量或者 GitHub App 的方式认证。

备份策略#

位置	保留数量	说明
服务器本地	最近 7 份	节省磁盘空间
GitHub 私有仓库	30 天	主备份，自动清理旧文件
手动备份	不定期	重大更新前手动备份一次