Solución comunitaria

Instala OpenCloud en ZimaOS con Docker Compose

A ZimaOS user wanted a lightweight family file-sync platform but could not get OpenCloud working with AI-generated setup instructions.

OpenCloud puede ejecutarse en ZimaOS porque cuenta con opciones oficiales de implementación mediante Docker y Docker Compose. Para una prueba local rápida, usa el procedimiento de un solo contenedor; para sincronizar archivos familiares con HTTPS, usa la pila oficial de Compose con Traefik integrado o la arquitectura con proxy externo.

El usuario de origen tuvo dificultades durante dos semanas con instrucciones generadas por IA. La solución es dejar de improvisar con la pila y seguir el modelo de implementación actual de OpenCloud, especialmente las rutas persistentes de configuración/datos, la configuración inicial del administrador, la URL y los requisitos del proxy/TLS.

Empieza con una instancia de prueba local

La guía actual de Docker de OpenCloud documenta un contenedor sencillo en el puerto 9200.

mkdir -p /DATA/AppData/opencloud/config
mkdir -p /DATA/AppData/opencloud/data

docker pull opencloudeu/opencloud-rolling:latest

docker run --rm -it   -v /DATA/AppData/opencloud/config:/etc/opencloud   -v /DATA/AppData/opencloud/data:/var/lib/opencloud   -e IDM_ADMIN_PASSWORD=CHANGE_ME   opencloudeu/opencloud-rolling:latest init

Usa la prueba local solo para validar

El ejemplo oficial usa ajustes inseguros/locales para pruebas rápidas. No lo consideres una implementación de nube familiar para producción expuesta a Internet.

Usa Docker Compose en producción

La guía actual de Docker Compose de OpenCloud admite dos arquitecturas oficiales: Traefik integrado o un proxy inverso externo.

Vigila los puertos 80 y 443 en ZimaOS

La pila integrada de Traefik normalmente requiere los puertos HTTP/HTTPS estándar. Si ZimaOS u otro proxy inverso ya los ocupa, usa la opción de proxy externo o una IP de LAN/VM separada, en lugar de cambiar a la ligera el punto de acceso de administración de ZimaOS.

Conserva la configuración y los datos de usuario

Mantén /etc/opencloud y /var/lib/opencloud en almacenamiento duradero de ZimaOS. Un contenedor se puede recrear; la identidad y los datos de usuario, no.

Usa una imagen/versión estable para los datos familiares

El ejemplo de inicio rápido usa una imagen rolling. Para una implementación a largo plazo, sigue las recomendaciones de producción de OpenCloud y, tras validarla, fija una versión o rama estable adecuada en lugar de actualizar a ciegas.

Haz una copia de seguridad antes de actualizar

Protege tanto la configuración como los datos de OpenCloud y, después de las actualizaciones, prueba el inicio de sesión, el uso compartido, los clientes de sincronización y la restauración.

OpenCloud frente a Nextcloud

Si principalmente necesitas una sincronización ligera de archivos para varios usuarios, OpenCloud puede ser una buena opción. Si necesitas un ecosistema más amplio de calendario, contactos, aplicaciones de oficina, complementos e integraciones consolidadas, Nextcloud puede seguir siendo la opción con más funciones.

La guía de Docker personalizada explica la parte del flujo de trabajo correspondiente a ZimaOS.

Elige la URL pública o privada antes de configurar el entorno de producción

OpenCloud genera enlaces y redirecciones de autenticación según la URL configurada. Decide el nombre de host definitivo y la ruta HTTPS antes de invitar a familiares para no tener que migrar después los clientes desde una URL temporal de tipo localhost.

Verifica la sincronización de archivos con un usuario que no sea administrador

Crea una cuenta familiar normal, sube una carpeta de prueba desde un cliente, sincronízala con un segundo dispositivo y luego elimina y restaura un archivo de prueba. Así comprobarás el flujo real de sincronización multiusuario, no solo el inicio de sesión del administrador en la web.

Haz copias de seguridad de la identidad y la configuración junto con los archivos

Los archivos de los usuarios no son todo el servicio. Conserva la configuración y los datos de identidad de OpenCloud para poder recuperar las cuentas, los elementos compartidos y los permisos junto con los archivos almacenados.

Preguntas frecuentes

¿Se puede ejecutar OpenCloud en ZimaOS?

Sí. ZimaOS admite Docker/Compose y OpenCloud documenta oficialmente ambos métodos de implementación con contenedores.

¿Qué puerto usa la prueba sencilla de OpenCloud?

El ejemplo oficial de Docker local usa el puerto 9200.

¿Debería usar la imagen rolling en producción?

Úsala solo para pruebas, salvo que las recomendaciones de producción actuales de OpenCloud se ajusten explícitamente a tu estrategia de actualización.

¿Necesito Traefik?

No. OpenCloud admite Traefik integrado o implementarse detrás de un proxy inverso externo.