45 lines
1.8 KiB
Markdown
45 lines
1.8 KiB
Markdown
# PIGWay Device Console
|
||
|
||
简体中文 | [English](README.md)
|
||
|
||
|
||
独立的多设备管理中心，可运行在 NAS、服务器或其他能访问设备 API 的主机上。所有设备都需要显式登记；Console 不采集所在主机状态，不控制硬件，也不依赖 Agent 或插件持续运行。
|
||
|
||
### 安装
|
||
|
||
Docker Compose：
|
||
|
||
```bash
|
||
docker compose up -d --build
|
||
docker compose exec manager cat /data/manager.token
|
||
```
|
||
|
||
直接运行（仅使用 Python 标准库）：
|
||
|
||
```bash
|
||
PIGWAY_DATA="$PWD/.data" PIGWAY_PORT=6001 python3 app/server.py
|
||
cat .data/manager.token
|
||
```
|
||
|
||
可选 systemd 安装：
|
||
|
||
```bash
|
||
sudo ./install.sh --port 6001
|
||
sudo cat /var/lib/pigway-web-manager/manager.token
|
||
```
|
||
|
||
打开 `http://管理中心地址:6001`，输入管理中心令牌，然后在“机器管理”中登记设备地址和该设备的 API 令牌。用 `PIGWAY_PORT=6002 docker compose up -d --build` 可修改外部端口。
|
||
|
||
设备令牌只保存在服务端数据卷，列表不会返回；管理中心登录令牌只保存在当前浏览器会话。跨公网部署应使用 HTTPS 反向代理或 VPN。日志按需查询设备 journal，不建立额外日志数据库。
|
||
|
||
### 功能与边界
|
||
|
||
- 设备登记、连接检测、多机状态卡片和 journal 查询。
|
||
- 单机配置、服务及插件管理，以及按配置层级选择的批量同步。
|
||
- 中英文界面和自动、浅色、深色主题。
|
||
- 最多登记 32 台设备，并发查询最多 8 台；单台离线不会阻塞其他设备。
|
||
- 单设备单次日志聚合上限 50,000 条，超出时明确提示缩小日期范围。
|
||
- Console 停止或卸载不会停止任何设备上的 Agent 或硬件插件。
|
||
|
||
相关项目：[PIGWay Device Agent](https://tea.pigway.com/way/pigway-device-agent) · [PIGWay Yahboom Cooling HAT](https://tea.pigway.com/way/pigway-yahboom-cooling-hat)
|