树莓派如何实现可远程Web查看的多Python脚本复用日志系统

整体采用「轻量SDK+常驻Web服务」的解耦架构，完全不需要在每个业务脚本里重复写日志逻辑，也不用手动维护日志HTML文件，可实现脚本启动自动注册、页面自动生成访问入口的效果。

通用日志模块封装 #

直接把日志能力封装成全局可导入的Python包，所有脚本一行导入就能用：

• 把包安装到树莓派Python全局环境的site-packages目录，或者将包所在路径加入PYTHONPATH环境变量，业务脚本不需要复制任何日志相关代码，直接import pi_log即可调用。
• 模块初始化时自动完成注册逻辑：默认读取当前运行脚本的文件名作为服务标识（也支持手动传入自定义服务名），第一时间给本地常驻的日志服务发注册请求，不需要手动配置接入。
• 接口完全对齐Python标准库logging的使用习惯，对外暴露info()/warning()/error()/debug()等通用方法，业务脚本不需要改原有日志写法，调用时自动附带时间、日志级别、脚本标识，批量推给日志服务即可。
• 增加兜底缓存逻辑：如果日志服务暂时未启动、通信中断，日志先写入本地内存队列，连接恢复后自动补传，避免日志丢失。同时自动捕获脚本的未处理异常、正常退出事件，同步给日志服务做状态更新。

常驻Web日志服务实现 #

服务单独写一个常驻Python脚本，配置开机自启，只监听本地回环地址127.0.0.1即可，不需要对外暴露多余端口：

• 通信方式直接用本机HTTP接口就行，树莓派本地通信性能足够，零额外依赖，不需要搭复杂的消息队列。如果追求更高性能也可以换Unix域套接字，对于树莓派的使用场景HTTP完全够用。
• 服务端维护两个核心数据结构：
  • 脚本注册表：存储所有接入脚本的唯一ID、显示名称、启动时间、最后活跃时间、运行状态
  • 环形日志缓冲区：每个接入脚本对应一个固定长度的内存队列（比如最多存最新1000条日志），内存占用极低，不需要实时写磁盘，需要长期留存的话可以加个定时任务按天、按脚本名分文件落盘备份即可。
• 前端逻辑极简：首页遍历脚本注册表，自动为每个脚本生成对应入口按钮，标注运行状态、启动时间；点击按钮进入对应日志页，拉取对应缓冲区的日志内容，加个SSE（服务器发送事件）或者短轮询就能实现日志实时滚动，不用手动刷新页面。
• 整个服务只需要3个核心接口：
  • POST /register：接收新脚本的注册信息，写入注册表，首页自动新增对应入口
  • POST /push_log：接收各脚本上报的日志内容，写入对应脚本的环形缓冲区
  • GET /api/script_list：给首页返回所有脚本的列表信息，GET /api/logs/<script_id>返回对应脚本的日志内容

关键优化点 #

• 所有文件IO、HTML渲染逻辑全部收归到常驻Web服务处理，业务脚本只负责上报日志，完全不需要关心日志存储、页面生成的逻辑，从根源上解决代码重复问题。
• 日志模块尽量只用Python标准库实现，不要引入第三方依赖，避免给业务脚本增加额外依赖负担。
• 如果需要同局域网其他设备访问日志页面，给Web服务套一层nginx做反向代理即可，需要安全控制的话加个简单的基础账号密码认证，不要直接把无认证的服务暴露到公网。

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