核心用法
Raspberry Pi Manager 是一款面向 Raspberry Pi 生态的综合运维工具，覆盖从单机调试到多节点集群管理的完整场景。本地模式下直接调用 pi-manager.sh 脚本即可获取系统状态、操控 GPIO 引脚、读写传感器数据；远程模式通过 SSH 密钥连接单台或多台 Pi，实现无密码自动化运维。
主要功能模块
| 模块 | 典型命令 | 说明 |
|------|---------|------|
| **系统监控** | `system`, `temp`, `cpu`, `memory`, `disk`, `network` | 实时查看 CPU 负载、温度、内存、磁盘及网络状态，支持阈值告警与 CSV 历史数据导出 |
| **GPIO 控制** | `gpio read/write/mode/pwm/watch` | 直接操作物理引脚，支持批量读写、PWM 调光、边沿触发监听 |
| **传感器接入** | `sensor dht22/bme280/ds18b20/distance/pir/light` | 集成温湿度、气压、超声波测距、PIR 人体感应等常见传感器 |
| **服务管理** | `service start/stop/restart/enable/disable/logs` | 基于 systemd 的服务全生命周期管理，支持一键创建自定义服务 |
| **远程部署** | `deploy push/pull/exec/run` | 文件同步、脚本执行、YAML 编排工作流，支持 Fleet 批量下发 |
| **维护工具** | `update`, `firmware`, `backup`, `overclock`, `reboot` | 系统更新、固件检查、SD 卡镜像备份、超频配置 |
显著优点
1. 全场景覆盖：从原型验证阶段的 GPIO 调试，到生产环境的传感器数据采集与远程 OTA 更新，单工具贯穿项目全生命周期。
2. 多机协同：--fleet 模式支持对多台 Pi 执行相同命令，降低边缘节点集群的维护成本。
3. 硬件友好：内置常用传感器驱动抽象，无需手动安装 Python 库或处理 I2C/1-Wire 配置。
4. 可观测性：温度/磁盘/服务异常支持阈值告警，可接入 cron 实现无人值守监控。
潜在缺点与局限性
- 权限依赖：GPIO 操作与系统服务管理需要 root 或
gpio/i2c组成员权限，误操作可能导致硬件损坏。 - SSH 配置门槛：远程管理依赖预配置的密钥登录，初学者需自行完成密钥分发与
~/.ssh/config维护。 - 平台锁定：功能深度绑定 Raspberry Pi 硬件特性（如
vcgencmd温度读取），迁移至其他 ARM 单板需适配。 - 无图形界面：纯命令行交互，对不习惯终端的用户存在学习曲线。
适合人群
- IoT 开发者：快速验证传感器与执行器硬件原型。
- HomeLab 爱好者：将 Pi 用作 NAS、广告拦截器或智能家居网关时的日常运维。
- 边缘计算运维：管理分布式 Pi 集群，执行批量更新与配置同步。
- 教育场景：树莓派编程与电子入门教学中，降低 GPIO 与 Linux 系统命令的入门门槛。
常规风险
- GPIO 过流风险：直接驱动电机或大电流负载可能烧毁 Pi 主板，建议配合继电器或驱动板使用。
- 超频稳定性：
overclock功能提升性能的同时增加功耗与发热，需确保 adequate 散热。 - 远程执行安全：
deploy exec与alert配置若被篡改，可能成为命令注入入口，需保护部署清单与脚本的完整性。