Files
pigway-device-console/README.zh-CN.md
T

1.8 KiB
Raw Blame History

PIGWay Device Console

简体中文 | English

独立的多设备管理中心,可运行在 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