Ubuntu Node.js 数据备份实用方案

一 备份范围与准备

在动手之前，我们得先搞清楚，服务器上哪些数据是真正需要保护的“命脉”。

• 明确需要保护的数据：
  • 代码与依赖： 项目源码（建议已在 Git 管理）、package.json 与 package-lock.json/yarn.lock。
  • 数据库： 如 MySQL、PostgreSQL、MongoDB 的数据与结构。
  • 配置与密钥： 如 .env、Nginx/PM2 配置、证书等。
  • 用户上传/静态资源： 如 uploads/、public/static/。
  • 日志： 应用日志目录（按策略保留与归档）。
• 建议做法：
  • 代码走 Git 常态备份；服务器侧保留一份打包归档用于快速恢复。
  • 数据库使用各自工具导出为可移植的转储文件（如 .sql/.dump）。
  • 配置与密钥纳入备份，注意权限与脱敏。
  • 日志采用轮转+归档，避免无限增长。

二 本地与远程备份命令

明确了目标，接下来就是具体的操作命令。这些命令是构建自动化备份脚本的基础。

• 项目代码与依赖打包
  • 打包： tar -czvf project-$(date +%F).tar.gz -C /path/to/project .
  • 同步到备份目录： rsync -a v --delete /path/to/project/ /backup/nodejs/
• 数据库备份
  • MySQL： mysqldump -u USER -p DATABASE > backup_$(date +%F).sql
  • PostgreSQL： pg_dump -U USER -d DATABASE -f backup_$(date +%F).sql
  • MongoDB： mongodump --db DATABASE --out /backup/mongo/DATABASE_$(date +%F)
• 远程备份与传输
  • 上传到远端： rsync -a vz /backup/ user@remote:/backup/nodejs/
  • 安全拷贝： scp project-$(date +%F).tar.gz user@remote:/backup/
• 说明
  • 以上命令可按需加入 -h 主机、-P 端口、–single-transaction（MySQL InnoDB）、-Fc（PostgreSQL 自定义格式）等选项以提升一致性与效率。

三 日志备份与轮转

日志文件如果放任不管，很容易变成吞噬磁盘空间的“巨兽”。一套好的轮转归档策略必不可少。

• 使用 logrotate 做日常轮转与压缩（推荐）
  • 新建配置： sudo nano /etc/logrotate.d/nodejs
  • 示例：

    /path/to/nodejs/logs/*.log {
        daily
        rotate 7
        compress
        missingok
        notifempty
        create 0640 node node
        postrotate
            systemctl reload my-node-app.service >/dev/null 2>&1 || true
        endscript
    }

  • 测试与强制执行：
    • 校验： sudo logrotate -d /etc/logrotate.d/nodejs
    • 立即轮转： sudo logrotate -f /etc/logrotate.d/nodejs
• 按日归档脚本示例（配合 cron）
  • 脚本要点：

    #!/usr/bin/env bash
    set -e
    LOGS=/path/to/nodejs/logs
    BACKUP=/backup/logs/$(date +%F)
    mkdir -p "$BACKUP"
    tar -czf "$BACKUP/nodejs_logs_$(date +%F).tar.gz" -C "$LOGS" .
    find /backup/logs -type f -mtime +7 -delete

  • 定时： 0 1 * * * /usr/bin/bash /usr/local/bin/backup_nodejs_logs.sh
• 远程归档同步
  • 0 0 * * * rsync -a vz --delete /backup/logs/ user@remote:/backup/nodejs-logs/
• 提示
  • 生产环境优先用 logrotate 做滚动与压缩；归档与异地同步用脚本或 rsync 补充。

四 定时备份与云存储

手动执行终究不可靠，我们需要让备份任务自己“跑”起来，并考虑更安全的异地存储。

• 数据库定时备份脚本（含本地保留与云端上传）
  • 示例（MySQL，按日保留 7 天）：

    #!/usr/bin/env bash
    set -e
    BACKUP_DIR=/backup/db
    NOW=$(date +%F_%H%M%S)
    mkdir -p "$BACKUP_DIR"
    mysqldump -u USER -pPASSWORD mydb | gzip > "$BACKUP_DIR/mydb_$NOW.sql.gz"
    find "$BACKUP_DIR" -name "mydb_*.sql.gz" -mtime +7 -delete
    # 可选：上传到对象存储（示例思路）
    # node /opt/scripts/upload.js "$BACKUP_DIR/mydb_$NOW.sql.gz"

  • 定时： 30 1 * * * /usr/bin/bash /usr/local/bin/db_backup.sh
• 云端生命周期
  • 若使用对象存储（如 OSS），可配置 生命周期规则 自动清理 7 天前备份，降低存储成本。
• 安全建议
  • 避免在命令行中明文写密码，使用 ~/.my.cnf 或凭据文件，并确保权限为 600。

五 恢复与验证

备份的最终价值，体现在恢复的那一刻。定期演练恢复流程，是检验备份有效性的唯一标准。

• 项目代码与依赖
  • 解压： tar -xzvf project-2025-09-01.tar.gz -C /opt/app
  • 安装依赖： cd /opt/app && npm ci --only=production
• 数据库恢复
  • MySQL： mysql -u USER -p DATABASE < backup_2025-09-01.sql
  • PostgreSQL： psql -U USER -d DATABASE -f backup_2025-09-01.sql
  • MongoDB： mongorestore --db DATABASE /backup/mongo/DATABASE_2025-09-01
• 配置与密钥
  • 还原 .env、证书、Nginx/PM2 配置，检查文件权限与属主。
• 日志与验证
  • 检查服务状态： systemctl status my-node-app
  • 抽查日志： tail -n 100 /path/to/nodejs/logs/app.log
  • 定期做恢复演练与校验和比对，确保备份可用。