Solución de la comunidad

Construye un quiosco con pantalla táctil en ZimaBoard 2 usando Docker, X.Org, Chromium y un panel local

A detailed April 2026 community tutorial for turning a ZimaBoard 2 1664 on ZimaOS 1.5.4 into a fullscreen touchscreen kiosk. The author ran Debian/X.Org/Chromium inside Docker, exposed Intel graphics and udev input, hosted the dashboard with nginx, added a touch-event workaround, and later shared photos of the working 24/7 home-assistant setup.

Esta fuente es un buen ejemplo de cómo utilizar ZimaOS como host de dispositivo en lugar de intentar convertir su capa de sistema de solo lectura en una distribución de escritorio. Como ZimaOS no tiene un apt entorno o un escritorio X.Org integrado, el autor creó toda la pila del quiosco dentro de Docker: Debian + X.Org + Chromium para la pantalla, además de un pequeño contenedor nginx para el panel local.

El resultado fue un quiosco táctil de 22 pulgadas funcional conectado a un ZimaBoard 2 1664. Esto sigue siendo una configuración avanzada de la comunidad, no un modo de escritorio compatible con IceWhale. Utiliza redes del host, acceso directo a los gráficos y dispositivos de entrada, además de un contenedor de quiosco privilegiado, por lo que los usuarios deben comprender las implicaciones de seguridad y acceso a dispositivos antes de copiarlo.

Panel de quiosco con pantalla táctil de 22 pulgadas conectado a un ZimaBoard 2 y mostrando un panel de inicio personalizado a pantalla completa
El autor del código fuente compartió el quiosco terminado funcionando como un panel siempre encendido junto al PC principal.

El quiosco ejecuta una pila de escritorio dentro de Docker

El Dockerfile de origen parte de Debian Bookworm Slim e instala X.Org, libinput, Openbox, Chromium, utilidades de X11, fuentes y Mesa. El host sigue siendo ZimaOS; el espacio de usuario gráfico vive dentro del contenedor.

Este es exactamente el tipo de aislamiento de cargas de trabajo que el modelo de dispositivo de ZimaOS busca fomentar.

La GPU Intel se expone al contenedor del quiosco

La guía utiliza el modesetting controlador y pasa el dispositivo DRM de Intel al contenedor. El autor descubrió específicamente que la compatibilidad necesaria de Mesa requería los backports de Bookworm para la pila gráfica N100 utilizada por ZimaBoard 2.

El hardware actual de ZimaBoard 2 utiliza un Intel N150, por lo que quienes reproduzcan la guía deberían validar la compatibilidad actual con Mesa/X.Org en lugar de asumir que el detalle histórico del N100 es idéntico.

La entrada táctil llega a través de la capa de entrada/Udev del host

La señal de vídeo utilizaba HDMI/miniDP, mientras que el controlador de la pantalla táctil se conectaba mediante USB. La guía inspecciona /proc/bus/input/devices, asigna el dispositivo de eventos correcto en X.Org y comparte /run/udev para que el contenedor pueda identificar el hardware de entrada.

Configuración de quiosco de ZimaBoard 2 con monitor táctil, altavoces y PC de escritorio principal en el mismo espacio de Home Assistant
La pantalla táctil formaba parte de una arquitectura más amplia de bajo consumo, en la que Zima permanecía conectado y el potente PC principal entraba en suspensión hasta que se necesitaba.

Un contenedor nginx independiente sirve el panel

El código fuente ejecuta nginx:alpine en un puerto distinto al de ZimaOS (8888 en el ejemplo) y monta los archivos del panel en modo de solo lectura. Chromium abre esa URL local en modo quiosco.

Usar un contenedor web independiente facilita actualizar los archivos del panel sin tener que reconstruir el contenedor gráfico.

No reutilices el puerto 80 de ZimaOS para el panel

La guía señala explícitamente que ZimaOS ya usa el puerto 80 para su panel. Si Chromium abre la página equivocada, verifica el puerto del panel personalizado y el KIOSK_URL valor en lugar de cambiar ZimaOS inesperadamente.

El autor añadió una solución alternativa basada en eventos de puntero para los toques táctiles

En el panel de la fuente, un pequeño movimiento del dedo podía impedir que Chromium activara los eventos tradicionales de onclick controladores. El autor sustituyó el control de clics por pointerup además de un umbral de movimiento.

Ese JavaScript es específico de la aplicación. Las interfaces web modernas diseñadas para el uso táctil deberían preferir controles compatibles con puntero y táctiles en lugar de ejecutar globalmente controladores onclick cadenas.

El modo privilegiado es el mayor compromiso de seguridad

La fuente inicia el contenedor del quiosco con --privileged. Esto proporciona un acceso amplio a los dispositivos y al kernel del host, y es mucho más permisivo que un contenedor de panel normal.

Si reproduces la compilación, primero comprueba si es explícito /dev/dri, montajes de dispositivos de entrada y udev, además de capacidades estrictamente delimitadas, son suficientes. Mantén el panel en una LAN de confianza.

La fuente usa unless-stopped para la recuperación automática

Tanto el contenedor de nginx como el del quiosco usan restart: unless-stopped comportamiento para que la pantalla vuelva a mostrarse después de reiniciar ZimaOS. Guarda el Dockerfile, la configuración de X.Org, el punto de entrada y el panel en un almacenamiento persistente /DATA almacenamiento.

La versión actual de ZimaOS puede empaquetar esto de forma más reproducible con Compose

La versión actual de ZimaOS admite importaciones estándar de Docker Compose/YAML. En lugar de mantener varios archivos largos docker run comandos, un usuario avanzado puede expresar ambos servicios, las políticas de reinicio, los dispositivos, los volúmenes y las redes en un único archivo de Compose revisado.

Usa el modelo actual de Compose de ZimaOS.

PC de escritorio grande y personalizado utilizado junto con el quiosco ZimaBoard 2 siempre encendido y el concentrador de Home Assistant
El diseño más amplio del autor mantiene el ZimaBoard 2 conectado las 24 horas del día y solo activa el PC principal, que consume mucha energía, para cargas de trabajo más pesadas.

Preguntas frecuentes sobre quioscos con pantalla táctil

¿ZimaOS necesita tener apt o un entorno de escritorio instalado en el host?

No. La fuente mantiene intencionadamente X.Org, Openbox, Mesa y Chromium dentro de Docker.

¿Es este un modo de escritorio oficial de ZimaOS?

No. Es una compilación de la comunidad que IceWhale solicitó permiso para compartir con la debida atribución.

¿Por qué el contenedor del quiosco presenta un riesgo elevado en comparación con una aplicación normal?

La fuente le otorga el modo privilegiado y acceso directo a los gráficos y dispositivos de entrada, lo que reduce el aislamiento de Docker.