Guía de despliegue

Alojar Dockge en un VPS: gestor visual de Docker Compose

Desplegar en un VPS Cloud →

Tutorial

Alojar Dockge en un VPS: gestor visual de Docker Compose

Autoalojamiento4 min de lectura6 pasos

Gestionar los stacks de Docker Compose a mano funciona muy bien con una o dos aplicaciones, pero se vuelve inmanejable en cuanto se ejecutan una decena de servicios en un VPS. Dockge (MIT, 23,7k estrellas) es un gestor visual para Docker Compose desarrollado por Louis Lam, el creador de Uptime Kuma. Le ofrece una interfaz web depurada para crear, editar, iniciar, detener y supervisar cada stack de su servidor, con salida de terminal en directo y estado en tiempo real. Así se despliega en un VPS en menos de 10 minutos.

Contenido· Por qué un gestor visual para Docker Compose1/5
  1. 01Por qué un gestor visual para Docker Compose
  2. 02Lo que le aporta Dockge autoalojado
  3. 03Requisitos previos
  4. 04Desplegar Dockge con Docker Compose
  5. 05La consola web está desactivada por defecto: déjela así

Por qué un gestor visual para Docker Compose

En cuanto ejecuta más de un puñado de stacks de Docker Compose, el ritual de conectarse por SSH a cada servidor, navegar hasta el directorio correcto y lanzar docker compose up -d o docker compose logs se vuelve tedioso. Dockge centraliza todo eso en una sola pestaña del navegador: ve cada stack, su estado en directo y sus logs de un vistazo. Crear una nueva stack consiste en rellenar un formulario: pega su compose.yaml y hace clic en Start. Sin gestor de archivos, sin SSH.

Lo que le aporta Dockge autoalojado

  • Editor visual para los archivos compose.yaml — cree o edite sus stacks directamente en el navegador, con resaltado de sintaxis.
  • Inicio, parada, reinicio y actualización con un clic para cada stack — sin SSH ni comandos compose que memorizar.
  • Transmisión de logs en directo por stack y por contenedor, con salida coloreada.
  • Panel en tiempo real que indica qué stacks están en ejecución, detenidas o en error.
  • Soporte multiinstancia (v1.4+): controle instancias Dockge en hosts Docker remotos desde una única interfaz principal.
  • Se ejecuta en un solo contenedor, con menos de 150 MB de RAM — se añade sin riesgo a cualquier VPS existente, sin afectar a las cargas de trabajo en curso.

Requisitos previos

Un VPS con Ubuntu 22.04 (o Debian 12) con Docker y Docker Compose v2 ya instalados. Dockge necesita menos de 150 MB de RAM y unos pocos MB de disco para su base de datos SQLite. No hace falta ningún nombre de dominio: Dockge sirve su interfaz en el puerto 5001 por HTTP simple, accesible mediante la IP de su servidor. Si quiere HTTPS, coloque delante un reverse proxy Caddy o Nginx y emita un certificado Let's Encrypt.

Desplegar Dockge con Docker Compose

  1. Crear el directorio de stacks

    Dockge almacena cada stack que gestiona como un archivo compose.yaml en un directorio dedicado del host — /opt/stacks por defecto. Créelo antes de iniciar el contenedor: mkdir -p /opt/stacks. Dockge monta ese directorio dentro del contenedor para que los archivos sobrevivan a los reinicios y a las actualizaciones del contenedor.

  2. Redactar el archivo Compose

    Cree /opt/dockge/compose.yaml con el contenido siguiente. El contenedor monta el socket Docker (/var/run/docker.sock) para poder gestionar los demás contenedores del mismo host, el directorio /opt/stacks para leer y escribir los archivos de stack, y un volumen con nombre para su propia base de datos SQLite. Ajuste DOCKGE_STACKS_DIR a la ruta del host que haya elegido.

  3. Iniciar Dockge

    Ejecute docker compose up -d en /opt/dockge. La imagen (louislam/dockge:1) pesa unos 200 MB en la primera descarga. Una vez iniciada, abra http://<ip-de-su-servidor>:5001 en su navegador. Dockge le invita a crear una cuenta de administrador en la primera visita: defina de inmediato una contraseña robusta.

  4. Añadir su primera stack

    Haga clic en «+ Compose» en la interfaz de Dockge, dé un nombre a la stack (será el subdirectorio dentro de /opt/stacks), pegue el contenido de su compose.yaml y haga clic en Start. Por detrás, Dockge ejecuta docker compose up -d y le muestra en directo los logs de descarga y de arranque. La stack aparece en el panel con estado verde en cuanto todos los servicios están sanos.

  5. Opcional: restringir el acceso con un reverse proxy

    Por defecto, Dockge escucha en todas las interfaces en el puerto 5001. Para no exponerlo a Internet, o bien lo enlaza a 127.0.0.1:5001 en el archivo Compose (añada "127.0.0.1:5001:5001" a ports) y lo coloca detrás de Caddy o Nginx, o bien añade una regla ufw que solo permita el puerto 5001 desde su IP: ufw allow from <su-ip> to any port 5001. No exponga nunca la interfaz de Dockge a Internet sin autenticación.

  6. Conectarse por primera vez

    Abra la URL: Dockge muestra una pantalla de creación de la cuenta de administrador (no hay credenciales por defecto). Créela de inmediato con una contraseña robusta.

La consola web está desactivada por defecto: déjela así

Dockge v1.5.0 desactivó por defecto la consola de terminal integrada (acceso shell web) a raíz de un aviso de seguridad (GHSA-7vx4-hf96-mqq6). No la active en una instancia expuesta públicamente salvo que valore bien el riesgo. El resto de Dockge — gestión de stacks, logs, estado — sigue siendo plenamente funcional sin la consola. Si necesita acceso shell, use una sesión SSH real o una herramienta de terminal dedicada.

Despliegue Dockge en su VPS con un clic

Deje de gestionar sus stacks Docker Compose por SSH. ServOrbit provisiona una instancia Dockge lista para usar en un VPS — socket Docker y directorio de stacks preconfigurados, accesible desde su navegador en pocos minutos.

¿Necesita ayuda?

Consulte nuestro centro de ayuda y nuestra FAQ, o contacte con nuestro equipo: llamada, WhatsApp o correo electrónico. Soporte en francés, inglés y árabe.

Escribir por WhatsAppse abre en una pestaña nueva