49 lines
2.4 KiB
Markdown
49 lines
2.4 KiB
Markdown
|
# PIGWay Web Manager
|
||
|
|
|
||
|
|
独立的多设备管理中心，可运行在 NAS、服务器或其他能访问设备 API 的主机上。所有设备都显式登记，没有默认“本机”。不采集所在主机状态，不控制硬件，也不依赖 systemd。
|
||
|
|
|
||
|
|
## Docker Compose
|
||
|
|
|
||
|
|
```bash
|
||
|
|
docker compose up -d --build
|
||
|
|
docker compose exec manager cat /data/manager.token
|
||
|
|
```
|
||
|
|
|
||
|
|
打开 `http://管理中心地址:6001`，输入管理中心令牌。在“机器管理”中添加设备地址及该设备的 API 令牌。管理中心令牌与设备令牌不同；设备令牌仅保存在服务端的数据卷，列表不会返回令牌。管理中心登录令牌仅保存在当前浏览器会话中。
|
||
|
|
|
||
|
|
用 `PIGWAY_PORT=6002 docker compose up -d --build` 更改外部端口。数据卷保存设备登记与令牌，应限制备份的访问权限。日志按需查询设备 journal，不建立日志数据库。
|
||
|
|
|
||
|
|
## 直接运行（仅 Python 标准库）
|
||
|
|
|
||
|
|
```bash
|
||
|
|
PIGWAY_DATA="$PWD/.data" PIGWAY_PORT=6001 python3 app/server.py
|
||
|
|
cat .data/manager.token
|
||
|
|
```
|
||
|
|
|
||
|
|
不需要 root、I2C、监控 Agent 或硬件插件。远端部署需要到设备 API 的网络可达性；跨公网通过 HTTPS 反向代理或 VPN，不使用明文 HTTP 传输令牌。HTTP 客户端拒绝重定向，避免把设备凭据转发到其他地址。
|
||
|
|
|
||
|
|
## 可选 systemd 安装
|
||
|
|
|
||
|
|
```bash
|
||
|
|
sudo ./install.sh --port 6001
|
||
|
|
sudo cat /var/lib/pigway-web-manager/manager.token
|
||
|
|
```
|
||
|
|
|
||
|
|
独立服务 `pigway-web-manager.service`，不启动任何 Agent 或插件。
|
||
|
|
|
||
|
|
## 功能
|
||
|
|
|
||
|
|
- 统一设备列表，添加、更新地址/令牌、移除及连接检测。
|
||
|
|
- 多机状态卡片、按设备查询 journal、配置与插件管理。
|
||
|
|
- 按层级选择配置项、全选/反选、批量同步，逐设备报告结果。
|
||
|
|
- 中英文、自动/浅色/深色主题。
|
||
|
|
- 单台离线不会停止其他设备查询；日志查询失败会提示部分结果。
|
||
|
|
|
||
|
|
最多登记32台设备；并发查询最多8台。单设备单次日志聚合上限50000条，超出时明确提示缩小日期范围，不静默截断。
|
||
|
|
|
||
|
|
## 三个项目
|
||
|
|
|
||
|
|
- [本地监控服务](https://tea.pigway.com/way/pigway-pi-control)：本机监控、告警、日志与可选 API，默认不开启 API，无 Web。
|
||
|
|
- [硬件插件](https://tea.pigway.com/way/pigway-cooling-hat)：独立显示、温控和灯效，可选本机接入，默认关闭。
|
||
|
|
- 管理中心停止或卸载，不会停止任何设备上的服务或插件。
|