WalleCube UPS 面板安装指南：群晖、QNAP 与 Linux 全平台部署

WalleCube UPS 面板（wallecube-dsm7）是一款开源的 UPS 监控 Web 应用，通过 MQTT 实时接收设备遥测数据、持久化到 SQLite，并提供响应式 React 前端仪表盘。本文介绍如何在群晖 DSM7、QNAP QTS 以及 Linux 系统上完成安装。

软件包下载

注意：请根据你的 NAS 或服务器 CPU 架构选择对应版本。群晖大多数新款机型（如 DS920+、DS1522+）为 x86 架构；QNAP TS-x53 系列为 x86，TS-x53A 等 ARM 机型请选 ARM 版本。

一、群晖 DSM7 安装教程

前提条件

• 群晖 NAS 运行 DSM 7.0 或更高版本
• 已开启「套件中心」的手动安装功能

安装步骤

第一步：允许安装非官方套件

进入 套件中心 → 设置 → 常规，将信任层级改为 “任何发行者”。

第二步：手动安装 .spk 套件

1. 点击套件中心右上角的 「手动安装」
2. 上传下载好的 .spk 文件（根据 CPU 架构选择 x86 或 ARM 版本）
3. 按提示完成安装向导，勾选同意条款后点击「确定」

第三步：访问面板

安装完成后，面板默认运行在端口 5080，通过浏览器访问：

1

http://<NAS-IP>:5080

配置说明

套件安装后的数据目录位于：

1

/var/packages/wallecubeups/var/data/

如需自定义端口，可在 DSM 套件中心停用套件后，编辑 /etc/wallecubeups/config.env（如有），再重新启用。

二、QNAP QTS 安装教程

前提条件

• QNAP NAS 运行 QTS 5.x 或更高版本
• 已通过 App Center 启用「允许安装未经 QNAP 验证的应用程序」

安装步骤

第一步：开启安装权限

进入 App Center → 点击右上角设置图标 → 安全 选项卡，勾选 「允许安装未经 QNAP 或可信来源验证的应用程序」。

第二步：手动安装 .qpkg 套件

1. 在 App Center 点击右上角的 「手动安装」（齿轮图标旁边）
2. 点击「浏览」选择下载好的 .qpkg 文件
3. 点击「安装」，在弹窗中确认

第三步：访问面板

安装完成后，面板默认运行在端口 5080：

1

http://<NAS-IP>:5080

QNAP 注意事项

• 本套件内置 sql.js（基于 WebAssembly 的 SQLite 实现），无需 glibc 2.28+，兼容运行 glibc 2.17 的旧版 QTS 固件
• 数据目录位于套件安装目录下的 data/ 子文件夹，默认为 /share/CACHEDEV1_DATA/.qpkg/wallecubeups/data/
• 日志文件：data/server.log

三、Linux 安装教程

支持的发行版

DEB 安装（Ubuntu / Debian）

1
2
3
4
5
6
7
8

# 下载 .deb 包（以 amd64 为例）
wget https://www.wallecube.com/downloads/wallecubeups-amd64.deb

# 安装
sudo dpkg -i wallecubeups-amd64.deb

# 如有依赖缺失，运行：
sudo apt-get install -f

RPM 安装（CentOS / RHEL / Fedora）

1
2
3
4
5
6
7

# 下载 .rpm 包
wget https://www.wallecube.com/downloads/wallecubeups-x86_64.rpm

# 安装
sudo rpm -i wallecubeups-x86_64.rpm
# 或使用 dnf/yum：
sudo dnf install wallecubeups-x86_64.rpm

安装后操作

安装完成后，服务会自动通过 systemd 启动：

1
2
3
4
5

# 查看服务状态
sudo systemctl status wallecube

# 查看实时日志
sudo journalctl -u wallecube -f

面板默认运行在端口 5080：

1

http://<服务器-IP>:5080

配置文件

1
2

# 主配置文件（可编辑端口、MQTT 地址等）
sudo nano /etc/wallecube/config.env

常用配置项：

1
2
3
4

PORT=5080                          # 监听端口
LISTEN_HOST=0.0.0.0                # 绑定地址
MQTT_URL=mqtt://mqtt.fenjilab.com:1883   # MQTT Broker
ENABLE_RUNTIME_LOGS=0              # 设置为 1 开启详细日志

修改配置后重启服务：

1

sudo systemctl restart wallecube

卸载

1
2
3
4
5

# DEB
sudo apt remove wallecubeups

# RPM
sudo rpm -e wallecubeups

常见问题

Q: 面板无法访问，浏览器显示连接被拒绝？

• 确认服务已正常启动：systemctl status wallecube（Linux）或在套件中心查看状态
• 确认防火墙已放行 5080 端口
• 群晖：检查 控制面板 → 安全性 → 防火墙 是否阻止了该端口

Q: 面板显示"设备离线"或没有数据？

• 确认 WalleCube UPS 设备已联网并绑定到对应 IMEI
• 检查 MQTT 连接：面板首页的"设备状态"卡片会显示 MQTT 连接状态和最后一次数据时间
• 服务器/NAS 需要能访问 mqtt.fenjilab.com:1883

Q: QNAP 安装时提示"无效的 QPKG 文件"？

• 确认 QPKG 文件完整下载，文件大小应在 30MB 以上
• 确认已在 App Center 开启"允许安装未经验证的应用程序"

Q: 群晖安装时提示"套件无效或损坏"？

• 进入套件中心设置，将信任层级调整为"任何发行者"再重试

数据说明

面板展示的实时数据来自 MQTT 推送，历史数据持久化在本地 SQLite 数据库中，不上传到任何外部服务器。能源统计（daily_energy 表）按日汇总，支持最多 365 天的历史查询。

如有问题或功能建议，欢迎通过 联系我们 反馈。