如何让Android手机/Linux笔记本非轮询接收服务器通知响应GitHub推送

针对你的场景，核心思路是让处于内网的设备主动与专用服务器建立长连接或订阅关系，服务器收到GitHub Webhook后，直接通过已建立的通道向设备推送触发信号，避免轮询。以下是几种可行的实现方案：

方案1：WebSocket长连接方案 #

利用WebSocket的双向长连接特性，让设备主动连接服务器，服务器在收到Webhook后直接推送指令。

实现步骤： #

1. 服务器部署WebSocket服务
   用轻量框架快速搭建，比如Node.js的ws库或Python的websockets库，监听指定端口。示例Python服务核心逻辑：

   import asyncio
   import websockets
   from flask import Flask, request
   
   app = Flask(__name__)
   connected_clients = set()
   
   # 处理WebSocket连接
   async def handle_client(websocket):
       connected_clients.add(websocket)
       try:
           await websocket.wait_closed()
       finally:
           connected_clients.remove(websocket)
   
   # 处理GitHub Webhook
   @app.route('/webhook', methods=['POST'])
   def github_webhook():
       # 可选：验证GitHub请求签名
       # 推送触发指令给所有在线设备
       for client in connected_clients:
           asyncio.create_task(client.send("github_push_trigger"))
       return "", 200
   
   if __name__ == "__main__":
       start_server = websockets.serve(handle_client, "0.0.0.0", 8765)
       asyncio.get_event_loop().run_until_complete(start_server)
       app.run(host="0.0.0.0", port=5000)
   

2. Linux笔记本客户端
   编写脚本保持长连接，收到指令后执行自定义操作。示例Python客户端：

   import websocket
   import subprocess
   
   def on_message(ws, message):
       if message == "github_push_trigger":
           # 执行自定义操作，比如拉取仓库更新
           subprocess.run(["git", "-C", "/path/to/your/repo", "pull"])
   
   ws = websocket.WebSocketApp("ws://your-server-ip:8765", on_message=on_message)
   # 后台运行脚本，可搭配systemd做成服务
   ws.run_forever()
   

3. Android手机客户端
   用OkHttp或系统WebSocket API实现客户端，收到消息后触发自定义逻辑（比如弹出通知、启动同步服务）。

方案2：MQTT消息订阅方案 #

基于MQTT的发布订阅模式，设备作为订阅者连接服务器上的MQTT Broker，服务器收到Webhook后向指定主题发布消息。

实现步骤： #

1. 服务器部署MQTT Broker
   以Mosquitto为例，快速搭建：

   sudo apt install mosquitto mosquitto-clients
   sudo systemctl enable --now mosquitto
   # 可选：配置用户名密码认证
   

2. Linux笔记本订阅主题
   用命令行或脚本监听主题，收到消息后执行操作：

   mosquitto_sub -h your-server-ip -t "github/repo/push" | while read msg; do
       if [ "$msg" = "trigger" ]; then
           git -C /path/to/your/repo pull
       fi
   done
   

3. Android手机订阅主题
   集成paho-mqtt-android库，实现消息回调，触发自定义行为（比如启动本地仓库同步、推送通知）。

4. 服务器处理Webhook
   收到GitHub请求后，向指定主题发布触发消息：

   mosquitto_pub -h localhost -t "github/repo/push" -m "trigger"
   

方案3：Server-Sent Events（SSE）方案 #

适合单向推送场景，设备主动建立SSE长连接，服务器通过该连接发送事件通知，比WebSocket更轻量。

核心逻辑： #

• 服务器用Flask等框架实现SSE接口，设备通过HTTP请求保持连接。
• 收到GitHub Webhook后，服务器向所有活跃的SSE连接发送触发事件。
• Linux客户端用curl或Pythonsseclient库监听，Android用OkHttp处理流请求。

关键注意事项 #

• 离线补发：服务器可维护事件队列，当设备重新上线时补发未处理的触发指令（比如MQTT设置保留消息、WebSocket服务器记录事件）。
• 安全加固：
  • 为WebSocket/MQTT连接添加身份验证（API密钥、用户名密码）。
  • 对GitHub Webhook请求进行签名验证，确保请求来源合法。
• 后台运行：Linux客户端可封装成systemd服务，Android客户端用前台Service保持连接，避免被系统杀死。

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