PIGWay Device Console

中文

独立的多设备管理中心，可运行在 NAS、服务器或其他能访问设备 API 的主机上。所有设备都需要显式登记；Console 不采集所在主机状态，不控制硬件，也不依赖 Agent 或插件持续运行。

安装

Docker Compose：

docker compose up -d --build
docker compose exec manager cat /data/manager.token

直接运行（仅使用 Python 标准库）：

PIGWAY_DATA="$PWD/.data" PIGWAY_PORT=6001 python3 app/server.py
cat .data/manager.token

可选 systemd 安装：

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 · PIGWay Yahboom Cooling HAT

English

PIGWay Device Console is an independent multi-device management application for a NAS, server, or any host that can reach the device APIs. Every device is registered explicitly. The Console does not monitor its own host, control hardware directly, or require an Agent or plugin to remain operational.

Installation

Docker Compose:

docker compose up -d --build
docker compose exec manager cat /data/manager.token

Direct execution using only the Python standard library:

PIGWAY_DATA="$PWD/.data" PIGWAY_PORT=6001 python3 app/server.py
cat .data/manager.token

Optional systemd installation:

sudo ./install.sh --port 6001
sudo cat /var/lib/pigway-web-manager/manager.token

Open http://console-host:6001, enter the Console token, and register each device URL and API token under Machine Management. Use PIGWAY_PORT=6002 docker compose up -d --build to change the published port.

Device tokens remain in the server-side data volume and are never returned by list APIs. The Console login token is kept only in the current browser session. Use an HTTPS reverse proxy or VPN across untrusted networks. Logs are queried from each device journal on demand; the Console does not create another log database.

Features and boundaries

• Device registration, connectivity checks, multi-device status cards, and journal queries.
• Per-device configuration, service and plugin management, plus hierarchical batch configuration sync.
• Chinese and English interfaces with automatic, light, and dark themes.
• Up to 32 registered devices and 8 concurrent queries; one offline device does not block the others.
• Up to 50,000 journal entries per device per query, with an explicit warning when the date range must be narrowed.
• Stopping or uninstalling the Console never stops a Device Agent or hardware plugin.

Related projects: PIGWay Device Agent · PIGWay Yahboom Cooling HAT