Solución de la comunidad

Por qué apt y yum no funcionan en ZimaOS: Buildroot, módulos zpkg, contenedores y WebDAV

A November 2024-July 2025 thread where apt, apt-get, and yum failed because ZimaOS is Buildroot-based rather than Debian/Ubuntu. A later user wanted davfs2 for a host-level WebDAV mount so it would appear in Files. IceWhale did not provide an apt-style package-manager solution and instead explored container alternatives.

apt install, apt-get update, y yum install fallan en ZimaOS porque ZimaOS no es una distribución de propósito general al estilo de Debian, Ubuntu, Fedora o RHEL. Está construido con Buildroot como sistema operativo para dispositivos y mantiene la mayoría de las carpetas del sistema en modo de solo lectura.

El ZimaOS actual sí cuenta con mecanismos similares a los paquetes para fines específicos, sobre todo los módulos de zpkg, y parte de la documentación para desarrolladores utiliza Entware/opkg para herramientas especializadas. Eso no convierte el sistema operativo base en una distribución Linux mutable normal donde se puedan instalar e integrar paquetes arbitrarios del host como paquetes de Debian.

El usuario de origen probó apt, apt-get y yum

La publicación original de 2024 informaba que los tres enfoques de gestores de paquetes fallaban mediante SSH. Una respuesta de la comunidad explicó que ZimaOS está construido con Buildroot y combina componentes de Linux, glibc, systemd, Docker y virtualización sin una base de datos de paquetes al estilo de Debian.

Esa explicación arquitectónica sigue siendo precisa.

El ZimaOS actual mantiene la mayoría de las rutas del sistema en modo de solo lectura

La guía actual de IceWhale para la CLI indica explícitamente que la mayoría de las carpetas del sistema permanecen en modo de solo lectura incluso como root. Los datos de usuario y de las aplicaciones deben ubicarse en /DATA.

Consulta el modelo actual del sistema de archivos de la CLI de ZimaOS.

Para las aplicaciones, Docker es el modelo principal de extensiones

Si el software existe como una imagen de Docker mantenida o una pila de Compose, normalmente esa es la ruta de implementación más nativa de ZimaOS. Las dependencias permanecen dentro del contenedor y no modifican el sistema operativo base.

Por eso, la respuesta de IceWhale a la solicitud posterior de WebDAV exploró una aplicación basada en Docker en lugar de indicar al usuario que instalara davfs2 con APT.

zpkg es un gestor de módulos de ZimaOS, no apt

El ZimaOS actual utiliza zpkg para módulos del sistema instalables, como extensiones de IA/búsqueda y módulos comunitarios/oficiales. Un módulo está diseñado para el mecanismo de extensiones de ZimaOS y puede incluir su propia política de servicio.

No es un reemplazo genérico para nombres de paquetes arbitrarios de Debian, como davfs2 se puede instalar.

IceWhale también documenta opkg para entornos de desarrollo especializados

La guía actual de IceWhale para Python y desarrolladores muestra cómo instalar Entware en /opt y luego usar opkg para utilidades de desarrollo como git-http.

Este es un patrón avanzado compatible en esa guía específica, no un permiso para asumir que cualquier demonio de Linux instalado desde Entware se integrará de forma segura con el arranque, los archivos, la red o los servicios de almacenamiento de ZimaOS.

Usa el flujo de trabajo actual de Entware/opkg para desarrolladores solo cuando coincida con el caso de uso previsto.

La solicitud posterior de WebDAV necesitaba integración a nivel del host

El usuario de 2025 quería montar una unidad en la nube WebDAV a nivel del sistema operativo para que fuera accesible desde la experiencia de ZimaOS Files y desde otras aplicaciones. Especificó que una aplicación independiente al estilo de AList no era equivalente.

Ese requisito es más complejo que «ejecutar un contenedor de cliente WebDAV», porque un montaje del contenedor no se convierte automáticamente en un montaje nativo del host visible para Files y todos los demás contenedores.

Un contenedor también puede resolver algunos flujos de trabajo de WebDAV

Si el objetivo real es explorar, sincronizar o copiar datos a un proveedor WebDAV, una herramienta en contenedor puede ser más segura que modificar el host. Algunos ejemplos son clientes de sincronización, gestores de archivos o herramientas de copia de seguridad compatibles directamente con WebDAV.

Asigna únicamente las carpetas de ZimaOS que necesite el contenedor y conserva las credenciales del proveedor en la configuración protegida de la aplicación.

Usa una máquina virtual cuando el software requiera un host Linux mutable normal

Si un flujo de trabajo realmente necesita apt install davfs2, los paquetes del sistema, el comportamiento de FUSE/el kernel o los servicios de arranque personalizados, una máquina virtual de Debian/Ubuntu puede ser un límite más limpio. Dentro del invitado, la gestión normal de paquetes es compatible porque el invitado realmente es Debian/Ubuntu.

Después, expón los datos montados de nuevo a ZimaOS u otros clientes mediante un protocolo de red/almacenamiento definido deliberadamente, si es necesario.

Las modificaciones del host deben sobrevivir al ciclo de vida inmutable

Incluso cuando una solución avanzada permite disponer de un binario en /opt o /DATA, verifica:

  • el servicio se inicia después de reiniciar;
  • sobrevive a las actualizaciones OTA;
  • las credenciales se conservan de forma segura;
  • el montaje existe antes de que se inicien las aplicaciones dependientes;
  • un fallo no hace que las aplicaciones escriban en un punto de montaje local vacío.

Un montaje del host no es automáticamente una integración con Files

ZimaOS Files es un servicio nativo con su propio modelo de almacenamiento y ubicaciones de red. Crear un montaje FUSE/WebDAV personalizado desde un shell no garantiza que aparezca como una ubicación de primer nivel en Files ni que reciba los mismos permisos y la misma gestión del ciclo de vida.

Preguntas frecuentes sobre el gestor de paquetes de ZimaOS

¿Por qué no funciona apt en ZimaOS?

ZimaOS se basa en Buildroot y no utiliza la arquitectura de gestión de paquetes APT de Debian/Ubuntu.

¿Es zpkg un reemplazo general de apt?

No. zpkg instala módulos de ZimaOS creados para el sistema de módulos de la plataforma.

¿IceWhale documenta alguna vez opkg?

Sí, en una configuración especializada de desarrollo/Python mediante Entware en /opt. Eso no convierte al sistema operativo base en una distribución mutable normal.

¿Y si necesito específicamente davfs2 u otro demonio del host?

Prefiere un contenedor o módulo compatible cuando esté disponible, o ejecuta una máquina virtual de Linux de propósito general cuando el flujo de trabajo dependa realmente de la gestión normal de paquetes y los servicios del host.