Documentación

Inicio rápido + descripción de cada función y de cada dispositivo (en constante actualización)

Catálogo de aplicaciones

Este documento presenta el «Catálogo de aplicaciones» del panel: la guía completa para desplegar aplicaciones de uso común con un solo clic.

Entenderlo en una frase

El Catálogo de aplicaciones es la «tienda de aplicaciones» integrada, que reúne un gran número de aplicaciones de código abierto habituales (blogs, almacenamiento en la nube, notas, monitorización, bases de datos, etc.). Con un clic, el despliegue de Docker se completa automáticamente en el servidor de destino, sin escribir a mano un docker-compose ni buscar tutoriales.

Descripción de la función

El Catálogo de aplicaciones reúne aplicaciones de código abierto de uso común; cada aplicación incluye de serie «cuenta y contraseña predeterminadas + puerto + directorio de datos + pasos de despliegue + advertencias». Tú solo tienes que pulsar «Instalar», elegir el servidor y rellenar unos pocos parámetros clave; el resto (descargar la imagen, crear la base de datos, configurar las variables de entorno, arrancar el contenedor) se hace automáticamente.

Casos de uso

  • Quieres desplegar rápido una aplicación (como el almacenamiento en la nube Nextcloud, el blog WordPress o las notas Memos)
  • No quieres investigar por tu cuenta variables de entorno, mapeo de puertos o persistencia de datos
  • Quieres que cada aplicación tenga de serie «cuenta y contraseña predeterminadas + pasos de despliegue + advertencias»

Cómo se usa

1. Entra en «Catálogo de aplicaciones» y explora o busca aplicaciones

2. Cambia entre «Todas» o «Instaladas» para verlas

3. Pulsa una aplicación para ver sus detalles (cuenta y contraseña predeterminadas, puerto, directorio de datos, advertencias)

4. Pulsa «Instalar», elige el servidor de destino y rellena la configuración según las indicaciones (contraseña, puerto, etc.)

Instalación de sistemas de gestión de contenido (CMS) con un clic

El Catálogo de aplicaciones incluye la categoría «Sistema de gestión de contenido (instalación de CMS con un clic)», con los CMS más populares como WordPress, Joomla, Drupal, MediaWiki, Halo y Ghost, todos compatibles con instalación con un clic + configuración automática de la base de datos, sin escribir SQL a mano en ningún momento:

1. Comprueba/instala Docker automáticamente

2. Arranca automáticamente el contenedor compartido de la base de datos MariaDB (sshe-mysql; solo hace falta una vez, los siguientes CMS lo reutilizan)

3. Crea automáticamente una base de datos y un usuario independientes para cada sitio (contraseña fuerte aleatoria; la contraseña root se guarda de forma persistente en el servidor en /opt/sshe-mysql/.root_password para poder reutilizarla)

4. Arranca automáticamente el contenedor del CMS e inyecta la configuración de la base de datos

5. Al terminar la instalación, una ventana emergente muestra la dirección de acceso + las credenciales de la base de datos, que se pueden copiar con un clic

Tres modalidades:

  • Totalmente automática (WordPress / Joomla): la imagen oficial admite variables de entorno de base de datos, así que queda lista para usar al terminar
  • Asistente web (Drupal / MediaWiki): la herramienta crea la base de datos y el usuario automáticamente; en el asistente web de instalación solo tienes que introducir las credenciales generadas automáticamente (sin escribir SQL)
  • Base de datos integrada (Halo / Ghost): no necesitan base de datos externa y se ejecutan directamente con un clic

> Aviso: si en un servidor en China continental Docker Hub tarda demasiado en descargar la imagen, configura antes en el servidor un acelerador de imágenes de Docker (aceleradores públicos como docker.1ms.run / docker.m.daocloud.io).

Ver / hacer copia de seguridad de las credenciales de base de datos de un sitio

Tras la instalación con un clic, las credenciales de base de datos de cada sitio se guardan automáticamente en el servidor de destino: /opt/sshe-db-creds/<nombre-del-contenedor>.conf (contiene DB_HOST / DB_NAME / DB_USER / DB_PASS / DB_ROOT, permisos 600).

En los detalles del CMS, tanto en el Catálogo de aplicaciones como en el Catálogo de imágenes, pulsa «Ver credenciales de la base de datos» para consultarlas en cualquier momento; la ventana emergente incluye además:

  • 🚀 Despliegue de phpMyAdmin con un clic: con un clic despliega phpMyAdmin en la red sshe-cms-net (elige automáticamente un puerto libre, por defecto 8888, apuntando a sshe-mysql) y ofrece un botón «Abrir phpMyAdmin (con el inicio de sesión ya rellenado)» para entrar directamente en la base de datos y explorar / importar / exportar / consultar de forma visual y sencilla.
  • Comando de copia de seguridad: docker exec sshe-mysql mariadb-dump -uroot -p'<DB_ROOT>' <DB_NAME> > /opt/sshe-db-creds/<DB_NAME>.bak.sql
  • Inicio de sesión alternativo en phpMyAdmin: en servidor pon sshe-mysql y usa el usuario/contraseña de la base de datos de arriba.

> Nota: el archivo de credenciales solo se genera cuando el CMS se despliega mediante «instalación con un clic»; si lo despliegas a mano con docker run, consulta tú mismo la configuración de la aplicación (por ejemplo wp-config.php en WordPress).

Qué incluyen los detalles de cada aplicación

InformaciónDescripción
Cuenta / contraseña predeterminadascuenta inicial de la aplicación (p. ej. el admin de Nextcloud)
Puerto predeterminadopuerto en el que escucha la aplicación
Directorio de datosubicación de la persistencia de datos
Pasos de desplieguepasos completos para aplicaciones que dependen de una base de datos (instalar la base → crear base y usuario → configurar variables de entorno → inicializar)
Advertenciasconflictos de puertos, consumo de recursos, avisos de seguridad, etc.

Gestión de las aplicaciones instaladas

Cambia a «Instaladas»: cada aplicación instalada ofrece acciones en línea: instalar / desinstalar / detener / iniciar / reiniciar / eliminar, para facilitar la operación diaria.

Aplicaciones que dependen de una base de datos

Algunas aplicaciones (como Nextcloud o WordPress) dependen de MySQL/PostgreSQL. Los pasos de despliegue de estas aplicaciones incluyen automáticamente:

1. Desplegar primero la base de datos (MySQL/MariaDB/PostgreSQL)

2. Crear la base de datos y el usuario

3. Configurar las variables de entorno de la aplicación (dirección de la base de datos, cuenta, contraseña)

4. Inicializar la aplicación

El panel encadena estos pasos; tú solo tienes que rellenar la información clave, como la contraseña, siguiendo las indicaciones.

Compatibilidad con varias distribuciones

Los comandos de instalación del Catálogo de aplicaciones se adaptan automáticamente al gestor de paquetes del servidor de destino, sin que tengas que elegirlo:

DistribuciónGestor de paquetesModo de adaptación
Debian / Ubuntuaptcomando nativo
Fedora / Rocky / CentOS / RHELdnf / yummapeo automático (apt-get → dnf/yum)
Alpineapkmapeo automático

Además, gestiona automáticamente las diferencias habituales de nombres de paquetes (como apache2 → httpd, apache2-utils → httpd-tools) y de nombres de servicios (apache2.service → httpd.service).

> ⚠️ Atención: algunas aplicaciones dependen de un método de instalación específico de la distribución (por ejemplo, ufw es exclusivo de Ubuntu y el repositorio deb.nodesource de Node.js solo existe en Debian/Ubuntu), por lo que en Fedora/Rocky puede que no se puedan instalar. Si la instalación falla, el panel muestra el mensaje de error tal cual.

Advertencias

1. Para desplegar aplicaciones, el servidor de destino debe tener Docker ya instalado.

2. Los marcadores de posición de contraseñas se señalan claramente (p. ej. «<tu contraseña de base de datos>»); sustitúyelos por tu propia contraseña fuerte.

3. Las aplicaciones se vinculan por defecto a un puerto del servidor de destino; si ese servidor no tiene IP pública (servidor NAT/de penetración), necesitarás Penetración de puertos o Reenvío de puertos para poder acceder desde fuera.

4. Las distribuciones demasiado antiguas (como Fedora 32 u otras ya EOL) tienen los repositorios sin mantenimiento: la instalación puede agotar el tiempo de espera o fallar. Se recomienda actualizar a una versión soportada.