客户端推送到GitHub时，如何自动更新服务器本地Git仓库？

方案一：GitHub Webhook + 本地脚本（修正你对Git Hooks的误解） #

你之前尝试Git Hooks失败，核心原因是混淆了本地Git Hooks和GitHub Webhook的作用：本地Git Hooks仅在仓库直接接收推送动作时触发，而你的需求是客户端推送到GitHub后触发服务器更新，这需要借助GitHub的Webhook主动通知服务器，再结合本地脚本执行拉取操作。

具体步骤：

1. 配置服务器仓库

   • 在服务器上克隆你的GitHub仓库：git clone git@github.com:your-username/your-repo.git
   • 确保运行脚本的用户（如nginx/www-data）对仓库目录有读写权限，同时将服务器的SSH公钥添加到GitHub仓库的部署密钥中，实现无密码拉取。

2. 设置GitHub Webhook

   • 打开GitHub仓库的「Settings」→「Webhooks」→「Add webhook」
   • 填写Payload URL：服务器上用于接收Webhook请求的地址（如http://your-server-ip:port/webhook）
   • 选择「Content type」为application/json
   • 勾选「Just the push event」作为触发条件
   • 填写Secret（推荐）：自定义一串密钥，用于后续验证请求来源的合法性

3. 编写服务器端Webhook处理脚本
   以Bash CGI脚本为例（放在服务器Web目录下，如/var/www/html/webhook）：

   #!/bin/bash
   # 读取请求体
   read -r payload
   # 验证Secret（若已设置）
   expected_signature=$(echo -n "$payload" | openssl sha256 -hmac "your-github-secret" | awk '{print $2}')
   actual_signature=$(echo "$HTTP_X_HUB_SIGNATURE_256" | cut -d'=' -f2)
   if [ "$expected_signature" != "$actual_signature" ]; then
       echo "Status: 403 Forbidden"
       echo ""
       echo "Invalid signature"
       exit 1
   fi
   # 切换到仓库目录执行拉取
   cd /path/to/your/server/repo || exit 1
   git pull origin main
   # 可选：重启Web服务（针对systemd管理的服务）
   systemctl restart your-web-service
   # 返回成功响应
   echo "Status: 200 OK"
   echo ""
   echo "Updated successfully"
   

   给脚本添加执行权限：chmod +x /var/www/html/webhook，同时确保Web服务器允许执行CGI脚本。

方案二：GitHub Action + 服务器自定义端点 #

这个方案更灵活，适合需要自定义部署逻辑的场景：

1. 在服务器创建带认证的更新端点
   以Python Flask为例，写一个简单接口：

   from flask import Flask, request, abort
   import subprocess
   import os
   
   app = Flask(__name__)
   # 自定义认证Token，需与GitHub Secrets保持一致
   VALID_TOKEN = os.getenv('UPDATE_TOKEN')
   
   @app.route('/update', methods=['POST'])
   def update_repo():
       auth_token = request.headers.get('Authorization')
       if not auth_token or auth_token != f'Bearer {VALID_TOKEN}':
           abort(403)
       # 执行拉取命令
       try:
           subprocess.run(['git', 'pull', 'origin', 'main'], cwd='/path/to/your/repo', check=True)
           # 可选：重启服务
           subprocess.run(['systemctl', 'restart', 'your-web-service'], check=True)
           return 'Updated successfully', 200
       except subprocess.CalledProcessError as e:
           return f'Update failed: {str(e)}', 500
   
   if __name__ == '__main__':
       app.run(host='0.0.0.0', port=5000)
   

   用systemd将这个Flask服务设为后台服务，确保开机自启。

2. 配置GitHub Action
   在仓库的.github/workflows/deploy.yml中添加以下内容：

   name: Auto Deploy to Server
   on:
     push:
       branches: [ main ] # 仅在推送到main分支时触发
   
   jobs:
     deploy:
       runs-on: ubuntu-latest
       steps:
         - name: Trigger Server Update
           run: |
             curl -X POST http://your-server-ip:5000/update \
               -H "Authorization: Bearer ${{ secrets.SERVER_UPDATE_TOKEN }}"
   

   随后在GitHub仓库的「Settings」→「Secrets and variables」→「Actions」中添加SERVER_UPDATE_TOKEN，值为Flask服务中设置的VALID_TOKEN。

通用注意事项 #

• 权限控制：执行拉取和服务操作的用户必须拥有对应目录的读写权限，以及服务管理权限（若需重启），尽量避免用root用户执行。
• 错误日志：在脚本/接口中添加日志记录，方便排查更新失败原因。
• 依赖更新：若项目需安装依赖（如npm install、pip install），需在拉取代码后添加对应执行命令。
• 安全防护：务必验证请求合法性，防止恶意请求触发未授权更新。

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