Solución de la comunidad

Añadir CoolStore a CasaOS de forma segura: guía de la fuente actual

A 2023 tutorial introduced CoolStore as a CasaOS third-party app store; the current repository still publishes an Add Source ZIP URL.

CoolStore todavía se puede añadir a CasaOS mediante la función «Añadir fuente» de la tienda de aplicaciones, usando la URL ZIP actual publicada por el repositorio de CoolStore. Sin embargo, es una tienda de terceros, no una fuente seleccionada por IceWhale, así que revisa la imagen, los volúmenes, los puertos y el responsable de cada aplicación antes de instalarla.

El tutorial del foro de 2023 ya es demasiado antiguo para utilizarlo como única instrucción. Actualmente, el repositorio de CoolStore publica una URL de fuente mantenida, mientras que el ecosistema más amplio de tiendas de aplicaciones de CasaOS/ZimaOS ha avanzado hacia protocolos de tienda más recientes y una validación más estricta.

URL actual de la fuente de CoolStore

El repositorio actual del proyecto indica:

https://casaos-appstore.paodayag.dev/coolstore.zip

El repositorio de CasaOS CoolStore debe considerarse la fuente de referencia, en lugar de utilizar un enlace acortado de un tutorial antiguo.

Cómo añadir CoolStore en CasaOS

  1. Abre el panel de CasaOS.
  2. Abre la tienda de aplicaciones.
  3. Selecciona Añadir fuente.
  4. Pega la URL ZIP actual de CoolStore.
  5. Espera a que se actualice la fuente.
  6. Confirma que aparecen las aplicaciones de CoolStore antes de instalar nada.

Si «Añadir fuente» indica que se realizó correctamente, pero no aparecen aplicaciones

Actualiza la página de la tienda de aplicaciones y comprueba si la fuente sigue registrada. CasaOS ha tenido problemas de compatibilidad con tiendas de terceros cuando han cambiado los formatos de las fuentes o las raíces de las tiendas, por lo que un mensaje de éxito no siempre demuestra que la tienda se haya interpretado correctamente.

No consideres oficiales de CasaOS las aplicaciones de tiendas de terceros

Una tienda comunitaria puede incluir software excelente, pero el manifiesto de la aplicación puede estar mantenido por una persona distinta del desarrollador de la aplicación original. Antes de instalarla, revisa:

  • origen de la imagen de Docker;
  • estrategia de versiones y etiquetas;
  • asignaciones de volúmenes a rutas del host;
  • modo privilegiado o acceso a dispositivos;
  • puertos publicados;
  • historial de actualizaciones.

Prefiere la documentación de Docker del proyecto original para aplicaciones críticas

Si vas a instalar una base de datos, un proxy inverso, un gestor de contraseñas u otro servicio importante, compara el manifiesto de CoolStore con la documentación actual de Docker del proyecto original. Los paquetes de terceros pueden tardar en adaptarse a cambios importantes del proyecto original.

Comprende la nueva dirección de las tiendas de aplicaciones

La documentación actual para desarrolladores de la tienda de aplicaciones de IceWhale define ahora un protocolo de tienda v2 más reciente, con archivos store.json e index.json generados, Compose por aplicación, metadatos y recursos. Las tiendas ZIP heredadas todavía pueden existir por compatibilidad, pero ya no son el único formato de tienda de aplicaciones.

La documentación actual para desarrolladores de la tienda de aplicaciones explica la nueva arquitectura de las tiendas.

Eliminar una fuente de tienda sin borrar los datos de tus aplicaciones

La eliminación de una fuente de tienda debe considerarse por separado de la desinstalación de las aplicaciones instaladas desde ella. Un contenedor que ya está en ejecución no desaparece automáticamente solo porque se elimine la fuente del catálogo.

Haz una copia de seguridad de los datos importantes de las aplicaciones antes de desinstalar una aplicación empaquetada por la comunidad.

Cuándo es mejor usar Docker manualmente

Si una aplicación de CoolStore está desactualizada o solicita permisos de riesgo, instala manualmente la definición de Compose del proyecto original. Esto facilita la auditoría de las etiquetas de imagen, los volúmenes, las redes y los secretos.

La guía de Docker personalizado ofrece el mismo enfoque de implementación transparente.

Haz una copia de seguridad de la aplicación antes de cambiar de paquete de tienda

Si ya instalaste una aplicación desde CoolStore y quieres reemplazarla por la versión de otra tienda, no des por hecho que ambos manifiestos utilizan las mismas rutas del host, variables de entorno o nombres de contenedor. Exporta o haz primero una copia de seguridad de los datos persistentes de la aplicación y, después, compara las dos definiciones de Compose antes de desinstalar nada.

Cómo evaluar si una entrada de tienda está en buen estado

Comprueba si la imagen de Docker subyacente sigue recibiendo actualizaciones, si el manifiesto de la tienda fija una versión razonable y si los usuarios recientes informan de instalaciones correctas. Una tienda puede seguir siendo accesible mientras un paquete concreto se ha quedado obsoleto silenciosamente.

En servicios sensibles desde el punto de vista de la seguridad, verifica también que el manifiesto no solicite el modo privilegiado, redes del host, dispositivos sin procesar o montajes amplios del sistema de archivos sin una razón clara.

Preguntas frecuentes

¿CoolStore es una tienda oficial de CasaOS?

No. Es una tienda comunitaria de terceros.

¿Qué URL debo usar?

Usa la URL ZIP actual publicada en el repositorio de CoolStore en GitHub, en lugar de un enlace acortado antiguo.

¿Añadir CoolStore modificará el propio CasaOS?

Añade otra fuente de catálogo de aplicaciones. Aun así, las aplicaciones individuales pueden solicitar puertos, volúmenes, privilegios o acceso al host, así que revisa cada manifiesto por separado.

¿Qué ocurre si una aplicación de CoolStore está desactualizada?

Utiliza la documentación de Docker/Compose del proyecto original u otro paquete de tienda mantenido, en lugar de forzar un manifiesto antiguo.