如何使用Python实现GitHub仓库提交新commit时项目自动更新

下面提供两种落地性最强的实现方案，可根据你的设备网络环境选择：

方案1：GitHub Webhook 主动触发模式（推荐，实时性高） #

原理是GitHub仓库收到新commit推送后，会主动向你提前配置的设备接口发送通知，设备收到合法请求后立刻执行更新流程，几乎无延迟。
实现步骤：

• 每台部署设备上运行轻量Python Web服务，可选Flask/FastAPI等极简框架，开发一个接收POST请求的Webhook接口
• 接口逻辑包含3个核心部分：首先校验GitHub请求的签名（避免恶意请求触发更新），其次拉取仓库最新代码，最后执行依赖安装、服务重启等自定义更新操作
• 进入GitHub对应仓库的设置页，找到Webhooks配置项，添加每台设备的公网接口地址，Content type选择application/json，Secret和你服务中校验的密钥保持一致，触发事件仅选择push事件即可
• 无公网IP的设备可以搭配内网穿透工具使用，或者用VPS做中转，由VPS统一接收Webhook后再转发到各个内网设备

方案2：定时轮询检测模式（配置简单，无需公网IP） #

原理是设备本地运行定时脚本，周期性查询GitHub仓库的最新commit标识，和本地当前的commit标识比对，存在差异就触发更新，适合设备没有公网访问条件的场景。
实现步骤：

• 用PyGitHub库或者直接调用GitHub公开API（私有库需携带访问token），查询对应分支的最新commit hash值
• 执行本地命令git rev-parse HEAD获取当前本地仓库的commit hash，和远程查询到的结果做比对
• 如果两者不一致，依次执行git pull拉取最新代码、pip install -r requirements.txt安装新依赖、重启项目服务等操作
• 定时调度可以用APScheduler库实现，跨平台可用，无需依赖系统的crontab任务
  该方案缺点是存在更新延迟，延迟时长取决于你设置的轮询间隔，同时会产生少量无效查询请求。

通用更新逻辑注意事项 #

• 拉取代码前建议先检查本地是否存在未提交的修改，避免pull冲突，冲突时可选择自动stash本地修改，或者发送告警通知人工处理
• 如果项目用systemd管理服务，可直接调用systemctl restart 你的服务名完成重启，记得给Python进程分配对应权限
• 可添加结果通知逻辑，更新成功或失败时推送消息到你的常用通讯工具，方便排查问题

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