Guía Completa: Gestión de Docker en aaPanel

Docker es una plataforma de gestión de contenedores que permite desplegar y administrar aplicaciones de forma rápida y aislada.
aaPanel ofrece una integración completa con Docker, incluyendo instalación de apps con un solo clic, gestión de contenedores, imágenes, redes, volúmenes y Compose.

Menú de Docker en aaPanel

• One-Click Install
• Overview
• Container
• Cloud image
• Local image
• Compose
• Network
• Volume
• Repository
• Settings

1. One-Click Install (Instalación con un clic)

aaPanel proporciona una función de instalación rápida de aplicaciones populares mediante contenedores Docker (ej. Wiki.js, Nextcloud, WordPress, etc.).

Pasos para instalar una app con un clic (ejemplo: Wiki.js)

Acciones después de la instalación

• Actualizar lista de apps
• Backup (crear, subir, restaurar, descargar, eliminar backups)
• Detener / Reiniciar
• Detalles
• Reconstruir (rebuild)
• Desinstalar (¡haz backup antes!)
• Ver logs (ejecución e instalación)
• Entrar al directorio de instalación

2. Overview (Resumen)

Muestra el uso de recursos del servidor y de cada contenedor.
Haz clic en el nombre del contenedor para gestionarlo.

3. Container (Contenedores)

Lista todos los contenedores con su estado, ID, imagen, puertos, IP, etc.

Acciones principales

• Crear contenedor (desde imagen o Compose)
• Gestionar logs
• Limpiar contenedores (elimina contenedores detenidos)
• Gestionar contenedor (clic en el nombre)

Gestión de un contenedor (Container name / Manage)

Opciones avanzadas

• Terminal (elige bash o sh, acceso root)
• Detalles (inspect, archivos, volúmenes, redes, política de reinicio)
• Crear imagen (simple o avanzado)
• Renombrar
• Logs en tiempo real
• Proxy (usa Sitios → Proxy en Nginx)
• Eliminar (¡haz backup antes!)

Logs del contenedor

• Cortar logs automáticamente
• Descargar, limpiar, ver todos, últimos 7/30 días o rango personalizado

4. Cloud image (Imágenes en la nube)

Lista imágenes oficiales de Docker Hub.
Puedes buscar, descargar (Pull), crear contenedor o eliminar.

5. Local image (Imágenes locales)

Imágenes descargadas o construidas en tu servidor.

Acciones

• Pull desde repositorio
• Importar imagen
• Construir imagen (desde directorio o contenido)
• Descargar desde Docker Hub
• Limpiar imágenes (elimina imágenes no usadas)
• Push a repositorio
• Exportar a archivo
• Crear contenedor desde la imagen

6. Compose

Permite definir y ejecutar múltiples contenedores mediante archivos compose.yaml.

Acciones

• Agregar Compose (manual o desde plantilla)
• Lista de plantillas
• Buscar
• Iniciar / Detener / Reiniciar / Actualizar imagen / Eliminar
• Ver contenedores de Compose
• Logs (de todos los contenedores o individuales)
• Editar compose.yaml y .env

Ejemplo de compose.yaml

version: '3'
services:
  db_nextcloud:
    image: mariadb:10.7
    container_name: db_nextcloud
    restart: always
    ports:
      - 3366:3306
    volumes:
      - db_data:/var/lib/mysql
    environment:
      - MYSQL_ROOT_PASSWORD=btnextcloud
      - MYSQL_DATABASE=nextcloud
      - MYSQL_USER=nextcloud
      - MYSQL_PASSWORD=nextcloud
  nextcloud:
    image: nextcloud:latest
    container_name: nextcloud_server
    restart: always
    ports:
      - 8001:80
    volumes:
      - nextcloud_data:/var/www/html
    environment:
      - MYSQL_HOST=db_nextcloud
      - MYSQL_PASSWORD=nextcloud
      - MYSQL_DATABASE=nextcloud
      - MYSQL_USER=nextcloud
volumes:
  nextcloud_data:
  db_data:

7. Network (Redes)

• Agregar, eliminar y limpiar redes
• Configurar driver (bridge, host, overlay, etc.), subred IPv4/IPv6, gateways, etc.

8. Volume (Volúmenes)

• Agregar, eliminar y limpiar volúmenes
• Persistencia de datos para contenedores

9. Repository (Repositorios)

• Agregar repositorios privados (Docker Hub, Harbor, etc.)
• Autenticación con usuario/contraseña

10. Settings (Configuración)

• Estado del servicio Docker (iniciar, reiniciar, reparar, detener)
• URL de aceleración (para descargas más rápidas)
• Ruta de Docker Compose
• Archivo de configuración de Docker
• Habilitar/deshabilitar IPv6
• Desinstalar Docker (¡haz backup antes!)

Recomendaciones

• Siempre haz backup antes de eliminar, reconstruir o modificar contenedores.
• Usa volúmenes para persistir datos importantes.
• Configura aceleración de imágenes si las descargas son lentas.
• Para producción, usa políticas de reinicio adecuadas (unless-stopped o always).