2.4 KiB
PIGWay Device Agent v3.7.0
简体中文 | English
极轻的 Raspberry Pi / Linux 本地监控服务：CPU、内存、温度、磁盘、网络、服务/进程、系统健康告警与 journal 日志。无 Web 界面；无需硬件插件，也无需管理中心。
安装
sudo ./install.sh
# 显式启用 API：
sudo ./install.sh --enable-api
# 不启用 API：
sudo ./install.sh --disable-api
交互安装询问是否启用远程 API，默认否；非交互安装未指定时也关闭。--no-start 仅更新文件和配置，不改变现有服务运行状态，接口开关在下次启动生效。
配置文件：/etc/pigway-pi-control.conf。修改监控配置后执行：
sudo systemctl restart pigway-pi-control.service
可选 API
默认 [api] enabled = false，没有网络监听。需要集中管理时改为 true，设置 bind/port，然后：
sudo systemctl enable --now pigway-pi-control-api.service
sudo cat /etc/pigway-pi-control-api.token
默认端口6001。读取及写入都需要 Authorization: Bearer <token>。令牌只用于该设备；安装器显示查询方法，不直接显示令牌内容。关闭 API：配置改为 false，执行 sudo systemctl disable --now pigway-pi-control-api.service。
API 提供 /api/v1/health、/status、/logs、/config、/services、/plugins 和 /plugin/config（均以 /api/v1 开头）。不提供网页、多机登记或远程转发。
独立管理中心与插件
- PIGWay Device Console：可部署在 NAS 或远端，登记设备地址与令牌，统一看板、配置和批量同步。
- PIGWay Yahboom Cooling HAT：独立本地采集、OLED、风扇与 RGB。
远程 API 与本地插件联动相互独立。插件启用接入后，可在 [plugins] 显式登记 yahboom-cooling-hat = /run/pigway-plugins/yahboom-cooling-hat/api.sock 并重启监控，或通过管理中心接入。发现不会自动绑定；暂停/断开联动不停止插件本地功能。
运维
sudo /usr/local/sbin/pigway-pi-control --diagnose
sudo journalctl -u pigway-pi-control.service -f
日志依照系统 journal 的保留策略，不额外建库。卸载任何一个项目不会卸载另外两个项目。插件协议见 API v1。