在 reComputer RK 系列上安装 FUXA

最近更新:

FUXA 是基于浏览器的 SCADA/HMI 与数据看板平台，可连接 MQTT、Modbus、OPC UA 等数据源，将设备数据展示为监控画面。本教程介绍如何在 reComputer RK3576 上安装 FUXA，并确认服务与网页编辑器正常运行。

适用环境：reComputer RK3576 DevKit、ARM64 Armbian（Debian Bookworm），并已安装 Docker。由于 latest 镜像可能更新，需要可复现部署时，建议固定已验证的镜像版本或摘要。

开始之前

  • 将 RK3576 和操作电脑接入可信网络。
  • 准备 RK3576 的 SSH 或终端访问，并确认 Docker Engine 可用。
  • 检查系统盘是否有足够空间存放新镜像，避免因空间不足导致拉取失败。

在 RK3576 上检查环境：

bash
uname -m
cat /etc/os-release
docker --version
df -h /

uname -m 应输出 aarch64。若尚未安装 Docker，请先按当前 Armbian 镜像适用的说明安装并启动 Docker Engine。

步骤 1：拉取 FUXA ARM64 镜像

bash
sudo docker pull --platform linux/arm64 frangoteam/fuxa:latest

若拉取超时，先检查到 Docker Hub 的网络。只在 SSH 终端设置代理变量不会自动配置 Docker 守护进程；需要代理时，请按 Docker 官方的 daemon 代理说明填写当前网络使用的代理地址。

步骤 2：启动容器

镜像拉取完成后，运行 FUXA 容器：

bash
sudo docker run -d \
  --name fuxa-rk3576 \
  --platform linux/arm64 \
  --network host \
  --restart unless-stopped \
  -v fuxa_rk3576_appdata:/usr/src/app/FUXA/server/_appdata \
  -v fuxa_rk3576_db:/usr/src/app/FUXA/server/_db \
  -v fuxa_rk3576_logs:/usr/src/app/FUXA/server/_logs \
  -v fuxa_rk3576_images:/usr/src/app/FUXA/server/_images \
  frangoteam/fuxa:latest

-d 表示在后台运行，终端返回一串容器 ID 而不是网页是正常现象。命名卷用于保存项目数据、历史数据、日志和上传的图片。此命令使用 Linux host 网络，因此不需要再加 -p 1881:1881。仅在可信网络内开放 1881 端口；若要扩大访问范围，应先配置访问控制。

步骤 3：验证服务

bash
sudo docker ps --filter name=fuxa-rk3576
sudo docker logs --tail 40 fuxa-rk3576
curl -I http://127.0.0.1:1881/
hostname -I

容器状态应为 Up，日志应出现 FUXA started!，本机网页请求应收到 HTTP 响应。在同一可信网络的电脑上，使用 hostname -I 显示的 RK3576 局域网地址打开：

  • 运行页面：http://<RK3576_IP>:1881/
  • 网页编辑器：http://<RK3576_IP>:1881/editor

首次打开运行页面时，可能只看到空白区域，因为尚未创建可视化画面。

步骤 4：检查编辑器

打开编辑器，在 Views 面板中选择 MainView。可以先从 General 工具中添加一个文字元素到画布，输入 RK3576 FUXA test 等短文字，点击磁盘图标保存，再使用预览按钮。确认保存的文字能够出现在运行画面中。

到这一步，FUXA 已安装，编辑器也可以使用；但尚未配置实时设备数据、MQTT 连接、报警或 SCADA 流程。

常见问题

  • 电脑无法打开页面： 检查容器状态、RK3576 本机的 curl -I http://127.0.0.1:1881/、局域网 IP，以及到 1881 端口的网络或防火墙设置。
  • 运行页面空白： 进入 /editor 保存一个画面。只有初始运行页面空白，不代表安装失败。
  • 拉取镜像失败： 检查磁盘空间与 Docker 守护进程的网络和代理配置。不要未经核对就清理其他镜像。

下一步

完成安装后，可以参考 FUXA 官方文档继续配置数据源、将标签绑定到仪表和图表，并在运行画面中查看实时数据。