Instalar FUXA en la serie reComputer RK

Última actualización:

FUXA es una plataforma SCADA/HMI y de paneles accesible desde el navegador. Puede conectarse a fuentes de datos como MQTT, Modbus y OPC UA para mostrar sus valores en pantallas de supervisión. Esta guía explica cómo instalar FUXA en reComputer RK3576 y comprobar que funcionan el servicio y el editor web.

Entorno: reComputer RK3576 DevKit con Armbian ARM64 (Debian Bookworm) y Docker instalado. La imagen latest puede cambiar; para un despliegue reproducible, fija una versión o un digest que hayas verificado.

Antes de empezar

  • Conecta el RK3576 y tu ordenador a una red de confianza.
  • Prepara el acceso SSH o por terminal al RK3576 y comprueba que Docker Engine funciona.
  • Comprueba que el disco del sistema tiene espacio suficiente para la imagen.

En el RK3576, comprueba el entorno:

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

uname -m debe mostrar aarch64. Si Docker no está instalado, instálalo e inicia Docker Engine siguiendo las instrucciones adecuadas para tu imagen de Armbian.

Paso 1: Descargar la imagen ARM64 de FUXA

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

Si la descarga agota el tiempo de espera, comprueba el acceso a Docker Hub. Configurar un proxy solo en la sesión SSH no configura automáticamente el daemon de Docker. Si tu red requiere proxy, sigue las instrucciones del proxy para Docker daemon con la dirección de tu red.

Paso 2: Iniciar el contenedor

Tras descargar la imagen, ejecuta el contenedor de 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 ejecuta FUXA en segundo plano: es normal recibir un ID de contenedor en lugar de una página web. Los volúmenes con nombre guardan los datos del proyecto, el historial, los registros y las imágenes cargadas. Como el comando utiliza la red host de Linux, no necesita -p 1881:1881. Mantén el puerto 1881 dentro de una red de confianza y configura el control de acceso antes de exponer FUXA a más usuarios.

Paso 3: Verificar el servicio

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

El contenedor debe indicar Up, los registros deben incluir FUXA started! y la petición web local debe recibir una respuesta HTTP. Desde un ordenador de la misma red de confianza, utiliza la dirección LAN del RK3576 obtenida con hostname -I:

  • Página de ejecución: http://<RK3576_IP>:1881/
  • Editor web: http://<RK3576_IP>:1881/editor

La página de ejecución puede estar inicialmente en blanco porque todavía no se ha creado ninguna visualización.

Paso 4: Comprobar el editor

Abre el editor y selecciona MainView en el panel Views. Para una prueba sencilla, coloca un elemento de texto de General en el lienzo y escribe algo como RK3576 FUXA test. Guarda con el icono de disco y usa el botón de vista previa. Confirma que el texto guardado aparece en la página de ejecución.

Ahora FUXA está instalado y el editor funciona. Todavía no se han configurado datos de dispositivos en tiempo real, conexiones MQTT, alarmas ni procesos SCADA.

Resolución de problemas

  • La página no se abre desde el ordenador: Comprueba el estado del contenedor, curl -I http://127.0.0.1:1881/ en el RK3576, la IP LAN y la ruta de red o el cortafuegos hacia el puerto 1881.
  • La página de ejecución está en blanco: Abre /editor y guarda una vista. Una página inicial en blanco no significa por sí sola que haya fallado la instalación.
  • Falla la descarga de la imagen: Comprueba el espacio libre y la red o el proxy del daemon de Docker. No elimines otras imágenes sin revisarlas antes.

Siguientes pasos

Después de la instalación, consulta la documentación de FUXA para conectar una fuente de datos, vincular etiquetas con indicadores y gráficas y ver datos en tiempo real en la página de ejecución.