如何在树莓派上实现GitHub项目的无人值守自动更新？

一、解决GitHub无凭证交互问题 #

1. 使用SSH密钥（推荐，长期有效） #

• 生成SSH密钥对：在树莓派执行 ssh-keygen -t ed25519 -C "raspberrypi-deploy@example.com"，全程回车（不要设置密码，否则自动更新仍需手动输入）。
• 复制~/.ssh/id_ed25519.pub的内容，添加到GitHub账户的SSH密钥设置中（Settings → SSH and GPG keys）。
• 修改本地仓库远程地址为SSH格式：git remote set-url origin git@github.com:your-username/your-repo.git。
• 测试连接：ssh -T git@github.com，出现欢迎信息即配置完成，后续git操作无需输入凭证。

2. 使用个人访问令牌（PAT）+ 凭证存储 #

• 在GitHub生成PAT：进入Settings → Developer settings → Personal access tokens → Tokens (classic)，勾选repo权限，设置有效期为「无限制」（需评估安全风险）。
• 配置git凭证存储：执行 git config --global credential.helper store，手动执行一次git pull，输入GitHub用户名和PAT作为密码，git会将凭证保存到~/.git-credentials。
• 安全加固：执行 chmod 600 ~/.git-credentials，避免其他用户读取凭证文件。

二、数据库位置与备份流程优化 #

1. 永久迁移数据库到程序目录外（推荐） #

• 核心优势：
  • 代码更新时（如git reset --hard）不会误覆盖数据库，彻底省去「备份-恢复」的重复步骤。
  • 多部署地点的数据库天然隔离，与代码仓库完全解耦。
  • 备份路径固定，脚本逻辑更稳定，无需依赖上级目录的相对路径。
• 操作步骤：
  • 停止程序，将数据库文件（如app.db）移动到独立目录，比如/opt/your-app-db/app.db。
  • 修改Python程序中的数据库连接路径为新的绝对路径，避免相对路径引发的问题。
  • 启动程序测试，确认能正常读写新位置的数据库。

2. 备份方案：独立仓库优于共享分支 #

• 不推荐共享分支：多个部署地点推送到同一个备份分支会频繁触发冲突，破坏自动更新的流畅性。
• 推荐方案：
  • 为每个部署地点单独创建GitHub备份仓库（如your-app-db-site1、your-app-db-site2），每个仓库仅存储对应地点的数据库备份。
  • 或在同一个备份仓库内按地点创建子目录（如site1/、site2/），每个地点仅推送自身目录下的备份文件，避免冲突。
• 备份触发时机：可在每次更新前自动备份，也可通过cron定时执行（如每日凌晨备份），双重保障数据安全。

三、自动更新流程优化 #

1. 退出码触发逻辑 #

• 在Python程序中，用户触发更新操作时执行sys.exit(99)返回特定退出码。
• 启动脚本中加入退出码检测：当程序返回99时执行更新流程，否则正常重启或退出。

2. 优化后的更新流程（基于数据库已迁移到外部） #

1. 备份当前数据库到本地临时目录（可选，双重保险）。
2. 推送备份到对应地点的备份仓库：

   # 示例：假设备份仓库已克隆到/opt/your-app-db-backup
   cp /opt/your-app-db/app.db /opt/your-app-db-backup/
   cd /opt/your-app-db-backup
   git add app.db
   git commit -m "Auto backup: $(date +%Y-%m-%d_%H:%M:%S)"
   git push origin main
   

3. 拉取最新代码并重置：

   cd /path/to/your-app
   git fetch origin
   git reset --hard origin/main
   

4. 重启Python程序。

3. 调整后的启动Shell脚本示例 #

#!/bin/bash
APP_DIR="/path/to/your-app"
DB_PATH="/opt/your-app-db/app.db"
BACKUP_REPO_DIR="/opt/your-app-db-backup"

while true; do
    # 启动Python程序
    python3 "$APP_DIR/main.py"
    EXIT_CODE=$?

    # 检测退出码99，触发更新
    if [ $EXIT_CODE -eq 99 ]; then
        echo "Triggering auto update..."

        # 备份数据库
        echo "Backing up database..."
        cp "$DB_PATH" "$BACKUP_REPO_DIR/app.db"

        # 推送备份到GitHub
        cd "$BACKUP_REPO_DIR"
        git add app.db
        git commit -m "Auto backup from site1: $(date +%Y-%m-%d_%H:%M:%S)"
        git push origin main

        # 更新程序代码
        echo "Updating application code..."
        cd "$APP_DIR"
        git fetch origin
        git reset --hard origin/main

        echo "Update completed, restarting app..."
    elif [ $EXIT_CODE -ne 0 ]; then
        echo "App exited with code $EXIT_CODE, restarting..."
    else
        echo "App exited normally, exiting script..."
        exit 0
    fi
done

四、额外注意事项 #

• 确保树莓派的git版本支持credential.helper store，若不支持可安装git-credential-store包。
• 备份仓库同样需要配置SSH密钥或PAT凭证，避免推送备份时需要输入密码。
• 可在脚本中添加日志输出（如写入/var/log/your-app-update.log），方便排查更新问题。
• 若担心无密码SSH密钥的安全风险，可给密钥设置密码，再配置ssh-agent在系统启动时自动加载密钥，兼顾安全与自动化。

内容的提问来源于stack exchange，提问作者Crouser7