# 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)