Despliegue de aplicaciones

Compose, paneles de contenedores y gestión de actualizaciones

De un vistazo: Al administrar aplicaciones de múltiples contenedores en un VPS Linux, los comandos docker run dispersos pueden provocar fácilmente el olvido de parámetros, una topología de red confusa y actualizaciones desastrosas. La entrega moderna de contenedores estandariza las etiquetas de imagen, las variables de entorno, los volúmenes persistentes, las redes y los límites de recursos en Docker Compose como infraestructura como código (Infrastructure as Code).

Redacción de VPSMap · Actualizado 2026-09-26 · 20 min de lectura · Versión de texto sin formato

Al administrar aplicaciones de múltiples contenedores en un VPS Linux, el uso directo de comandos docker run dispersos puede causar fácilmente el olvido de parámetros, una topología de red confusa y actualizaciones desastrosas. La entrega moderna de contenedores utiliza Docker Compose para definir etiquetas de imagen, variables de entorno, volúmenes persistentes, redes y límites de recursos como infraestructura como código (Infrastructure as Code).

Centrado en la alta disponibilidad y la seguridad de los datos en entornos de producción, este artículo explica la organización estandarizada de directorios de Compose, el aislamiento de redes internas, permisos más estrictos para los paneles de administración gráfica y procedimientos de actualización fluida y reversión de emergencia que tienen en cuenta las migraciones de bases de datos. También utiliza las capacidades de la consola de los principales proveedores en la nube, como BandwagonHost y DMIT, para ofrecer orientación sobre la resolución de problemas de bajo nivel y la recuperación ante desastres en las operaciones.


1. Estándares de arquitectura: un directorio de aplicación y estado aislado#

Para garantizar la portabilidad y la migración en frío en cuestión de segundos, la orquestación de contenedores a nivel de host debe seguir el principio de un directorio por pila de aplicaciones. Se recomienda estandarizar en /srv/stacks/<应用名> o /opt/stacks/<应用名> como la ruta raíz para el aislamiento.

texto
/opt/stacks/web-app/
├── compose.yaml          # 核心编排文件(Compose V2 规范)
├── .env                  # 敏感环境变量(权限 600,禁止提交至公开仓库)
├── config/               # 挂载至容器的应用专属静态配置文件
│   └── nginx.conf
└── data/                 # 宿主机绑定挂载的数据目录(非必要时优先使用命名卷)
    └── app-uploads/

Pautas de gestión de directorios y credenciales#

  1. Convenciones de nomenclatura actualizadas: los complementos modernos de Compose utilizan sistemáticamente compose.yaml (o compose.yml) como archivo de configuración predeterminado; la antigua línea de declaración de nivel superior version: '3.8'. El comando es consistentemente docker compose (con un espacio entre las palabras), en lugar del binario independiente obsoleto docker-compose.
  2. Aislar las credenciales de entorno: los valores de configuración dinámica, como las contraseñas de bases de datos y los tokens de API, deben extraerse en el archivo .env del mismo directorio, con Compose realizando automáticamente la interpolación de variables (${VARIABLE_NAME}). Para proteger el host, los permisos de este archivo deben restringirse estrictamente:
    bash
    chmod 600 /opt/stacks/web-app/.env
    chown -R root:root /opt/stacks/web-app
  3. Límites del control de versiones: Si utiliza Git para realizar el seguimiento de la configuración operativa, incluya en el repositorio la plantilla .env.example, y en .gitignore excluya estrictamente .env y todos los directorios data/ que contengan el estado comercial real.

2. Estándares de orquestación de nivel de producción y aislamiento de red#

Mapear directamente todos los puertos de los contenedores a 0.0.0.0 del host es un grave riesgo de seguridad de red. El demonio de Docker modifica directamente las reglas de iptables del sistema e inserta la cadena DOCKER, lo que omite la configuración de UFW o firewalld del sistema. Una vez que un servicio de base de datos o caché se mapea externamente, su puerto queda expuesto directamente al internet público.

La siguiente es una plantilla compose.yaml estándar que integra una red de aplicaciones independiente, límites de rotación de registros, restricciones de recursos y disposiciones para un proxy inverso:

yaml
services:
  web:
    image: ghost:5-alpine
    container_name: production_blog_web
    restart: unless-stopped
    depends_on:
      db:
        condition: service_healthy
    environment:
      database__client: mysql
      database__connection__host: db
      database__connection__user: ghost
      database__connection__password: ${MYSQL_PASSWORD}
      database__connection__database: ghost_prod
      url: https://example.com
    volumes:
      - blog_content:/var/lib/ghost/content
    ports:
      # 严格限制仅监听宿主机本地环回接口,交由外部 Nginx 或 Caddy 处理 TLS 与反代
      - "127.0.0.1:2368:2368"
    networks:
      - frontend_net
      - backend_net
    deploy:
      resources:
        limits:
          cpus: '1.50'
          memory: 1024M
    logging:
      driver: json-file
      options:
        max-size: "20m"
        max-file: "3"

  db:
    image: mariadb:10.11
    container_name: production_blog_db
    restart: unless-stopped
    environment:
      MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD}
      MYSQL_DATABASE: ghost_prod
      MYSQL_USER: ghost
      MYSQL_PASSWORD: ${MYSQL_PASSWORD}
    volumes:
      - db_data:/var/lib/mysql
    # 绝不发布 ports,仅在内部网络被同栈应用发现
    networks:
      - backend_net
    healthcheck:
      test: ["CMD", "healthcheck.sh", "--connect", "--innodb_initialized"]
      interval: 10s
      timeout: 5s
      retries: 5
      start_period: 30s
    logging:
      driver: json-file
      options:
        max-size: "10m"
        max-file: "2"

volumes:
  blog_content:
    name: blog_app_content
  db_data:
    name: blog_app_db_data

networks:
  frontend_net:
    driver: bridge
  backend_net:
    driver: bridge

Consideraciones clave de arquitectura#

  • Aislamiento de red de dos capas: El contenedor db se une únicamente a backend_net, eliminando por completo la posibilidad de comunicación con el internet público; los contenedores web utilizan el DNS integrado de Compose y el nombre del servicio db para resolver y establecer una conexión.
  • Diseño para evitar el agotamiento del disco: El controlador de registro predeterminado de Docker permite que los registros stdout/stderr del contenedor crezcan sin límite. Declarar explícitamente en la configuración max-size y max-file puede forzar la rotación de registros y evitar que las instancias VPS de bajas especificaciones se caigan debido a que sus discos se llenen.
  • Fijar versiones de imágenes: Nunca utilice directamente lo siguiente en producción: :latest. Utilice imágenes estables con versiones principales explícitas o hashes de compilación fijados (como la rama mariadb:10.11, alpine) para evitar descargar una compilación con cambios disruptivos durante un reinicio inesperado.

3. Verificación del despliegue y flujos de trabajo de comandos habituales#

Después de configurar la estructura de directorios, siga la secuencia estándar: “comprobación de sintaxis $\to$ descarga de imagen $\to$ compilación en segundo plano $\to$ auditoría de estado”:

bash
# 1. 验证配置文件合法性与变量解析状态(不显示敏感数据)
docker compose config --quiet

# 2. 预先抓取所有编排中的镜像,降低上线中断时长
docker compose pull

# 3. 后台守护模式创建并启动容器
docker compose up -d

# 4. 检查服务健康状态与端口监听
docker compose ps

# 5. 持续观测业务输出以排查初始化异常
docker compose logs -f --tail=100 web

Al solucionar problemas, recuerde: docker compose config hará que .env todas las variables internas queden completamente expandidas. Al compartir información de depuración con su equipo o con un sistema de tickets de soporte, nunca pegue la configuración completa sin depurar.


4. Elección de paneles visuales (Portainer / 1Panel) y reducción de su superficie de ataque#

Algunos equipos añaden paneles ligeros de gestión de contenedores para simplificar la colaboración o la monitorización. Sin embargo, es fundamental reconocer que: Todos los paneles de gestión conectados a Docker son esencialmente procesos con privilegios.

Límites de seguridad del socket de Docker#

Casi todos los paneles de gestión visuales, como Portainer, necesitan montar el socket de comunicación de Docker del host: -v /var/run/docker.sock:/var/run/docker.sock

Montar este socket en un contenedor le otorga los mismos privilegios de control equivalentes a root a nivel de host. Si la contraseña del frontend del panel se filtra o tiene una vulnerabilidad de ejecución remota de código, un atacante puede usar este socket para crear un contenedor privilegiado que monte el directorio raíz del host, tomando el control de todo el sistema.

Pautas para el fortalecimiento del panel#

  1. No exponer al internet público: Nunca exponga los puertos de los paneles de gestión, como el 9443 de Portainer o el puerto de 1Panel, directamente al internet público. En producción, exija la escucha únicamente local (127.0.0.1), proporcionando acceso únicamente a través del reenvío de puertos locales mediante un túnel seguro basado en clave SSH:
    bash
    # 在本地工作电脑建立安全隧道,将远程端口转发至本地
    ssh -N -L 9443:127.0.0.1:9443 user@vps-ip -i ~/.ssh/id_ed25519
    Luego abra en su navegador local https://127.0.0.1:9443 para acceder al panel.
  2. Evitar la desviación de configuración por la gestión bidireccional: Pueden surgir conflictos de estado fácilmente entre un panel gráfico y los archivos YAML locales. Si modifica los puertos mapeados o las variables de entorno de un contenedor directamente en la WebUI del panel mientras el archivo local compose.yaml no se ha sincronizado, la próxima vez que ejecute docker compose up -d mediante la terminal, cualquier cambio temporal realizado en el panel se borrará por completo. Prácticas recomendadas: Utilice el panel únicamente como monitor de solo lectura o herramienta de auditoría de registros. Mantenga el repositorio de control de versiones y los scripts de terminal como la única fuente de información fidedigna (Single Source of Truth) para todas las operaciones de creación, lectura, actualización y eliminación.

5. Actualizaciones graduales de imágenes, migración de datos y control de reversión#

Muchos principiantes asumen que actualizar un contenedor solo significa descargar la imagen más reciente y reiniciarlo. Para aplicaciones empresariales persistentes, esto puede interrumpir fácilmente las migraciones del esquema de la base de datos o dañar los datos.

Método estándar de actualización continua en cuatro pasos#

texto
[1. 业务静态化与状态备份] ──> [2. 拉取新镜像] ──> [3. 差异化重建容器] ──> [4. 健康校验]

Paso uno: Realizar copias de seguridad en frío de la aplicación y la base de datos#

Antes de cambiar a una nueva imagen, cree un volcado lógico de los datos en lugar de depender únicamente de una instantánea del disco del host.

bash
# 进入部署目录
cd /opt/stacks/web-app

# 逻辑导出当前数据库数据并压缩
docker compose exec db mariadb-dump -u ghost -p"${MYSQL_PASSWORD}" ghost_prod | gzip > backup_$(date +%F_%H%M).sql.gz

# 备份持久化配置与上传目录
tar -czvf app_data_$(date +%F).tar.gz config/ data/

Paso dos: Actualizar imágenes y reemplazar contenedores#

Modifique en compose.yaml la etiqueta de versión del servicio de destino (como web), luego realice una reconstrucción diferencial:

bash
# 仅拉取更新的镜像层
docker compose pull web

# 触发依赖项计算,仅重新创建发生了配置或镜像变更的容器
docker compose up -d web

# 清理不再使用的孤儿容器与旧版本镜像
docker compose ps
docker image prune -f

docker compose up -d puede actualizar la pila en el lugar sin interrumpir un servicio de base de datos independiente que continúe en buen estado.

El error fatal del rollback: La trampa del esquema#

Cuando una nueva versión del servicio no se inicia correctamente y se necesita una reversión urgente, muchas personas simplemente cambian en compose.yaml la versión de la imagen a la etiqueta anterior y ejecutan up -d.

Riesgo crítico oculto: Muchas aplicaciones web, como Nextcloud, WordPress y Ghost, realizan automáticamente migraciones irreversibles del esquema de la base de datos cuando se inicia una nueva versión por primera vez, lo que incluye eliminar columnas, renombrar campos o convertir juegos de caracteres. El código de la aplicación anterior no puede interpretar las tablas modificadas por la versión más reciente, por lo que los errores y bloqueos continuarán incluso si la reversión de la imagen se completa con éxito.

Procedimiento completo de reversión:

  1. Detenga los contenedores de aplicaciones inmediatamente: docker compose stop web
  2. Restablezca la base de datos utilizando la copia de seguridad exportada anteriormente:
    bash
    # 清空并恢复数据库
    gunzip < backup_YYYY-MM-DD.sql.gz | docker compose exec -T db mariadb -u ghost -p"${MYSQL_PASSWORD}" ghost_prod
  3. Modifique compose.yaml para restaurar la etiqueta de imagen anterior y sus archivos de configuración correspondientes.
  4. Reconstruya la versión anterior del contenedor: docker compose up -d web

Advertencia: Evite docker compose down -v
docker compose down solo detiene y elimina contenedores y redes puente; sin embargo, si incluye el parámetro -v (o --volumes), Docker borrará directamente los volúmenes con nombre declarados en compose.yaml. A menos que tenga la intención de destruir completamente el entorno, nunca utilice la siguiente opción en un servidor de producción: el comando -v.


6. Coordinación de la red en la nube subyacente y operaciones de emergencia#

La orquestación de contenedores se ejecuta en el servidor en la nube subyacente. Los problemas en las interfaces de red, los bloqueos de firewall o la pérdida de credenciales pueden interrumpir directamente el ciclo de vida de los contenedores. Aprovechar eficazmente las características de infraestructura del host es la última línea de defensa contra desastres operativos.

Solución de problemas de firewall y fallos de conectividad subyacente#

Dado que Docker gestiona por sí mismo las tablas NAT y los puentes (docker0 / br-xxxx), en ocasiones pueden producirse conflictos en la tabla de enrutamiento tras reiniciar los contenedores, lo que incluso puede hacer que el demonio SSH del host quede inaccesible.

  • Acceso de emergencia de DMIT: el panel de control de instancias de DMIT proporciona un punto de entrada dedicado a la Web Console. Si no se puede acceder a SSH porque un contenedor Docker ocupa el puerto o las políticas de red lo bloquean, utilice la Console del panel para enviar una interrupción de hardware o iniciar sesión directamente para solucionar el problema. Además, para prevenir ataques de fuerza bruta, DMIT deshabilita el inicio de sesión remoto con contraseña de root, favoreciendo enérgicamente el acceso mediante clave SSH; si necesita reemplazar o inyectar claves públicas de forma masiva a través del menú Access del panel, después de la operación reinicie la instancia (Reboot) según las instrucciones del panel, tras lo cual los mecanismos subyacentes de autenticación y cloud-init surtirán efecto.
  • Solución detallada de problemas de KiwiVM en BandwagonHost: BandwagonHost asigna a cada VPS un panel KiwiVM independiente. Tenga en cuenta que la contraseña del panel KiwiVM, la contraseña de la cuenta del área de clientes y las contraseñas internas de root del sistema son completamente independientes. Si la red del host falla, utilice la Interactive Console integrada de KiwiVM para omitir la pila de red habitual y acceder directamente a un terminal TTY, luego introduzca la contraseña de root para tomar el control del servidor. Si una configuración de red de contenedores incorrecta inhabilita toda la red, el panel incluso puede iniciar una reinstalación del sistema operativo o la restauración de una instantánea.

Renovación automática y límites de conservación de datos#

La orquestación de contenedores permite reconstruir aplicaciones rápidamente, pero no reemplaza la recuperación ante desastres entre nodos para datos persistentes. Si una factura vence o las políticas del centro de datos cambian, todos los volúmenes de datos del host podrían borrarse directamente.

  • Ventanas de facturación y retención:
    • BandwagonHost: el proveedor no cobra automáticamente a una tarjeta de crédito o cuenta de PayPal vinculada sin su intervención. Si la renovación está habilitada, se genera una factura 7 días antes del vencimiento. Si el saldo de la cuenta prepaga es suficiente, el sistema lo descuenta para renovar el servicio; de lo contrario, un administrador debe completar el pago manualmente.
    • DMIT: las facturas de renovación mensual también se generan 7 días antes del vencimiento. Si la falta de pago provoca la suspensión, el centro de datos suele proporcionar únicamente un período de gracia de retención de datos de 3 días; una vez que expira, los procesos automatizados destruyen de forma permanente la instancia y sus datos de Docker montados, sin posibilidad de recuperación.
  • Restricciones de migración entre centros de datos: aunque BandwagonHost ofrece una cómoda migración entre centros de datos de distintas regiones, si una actividad saliente prohibida o un abuso provocan que la IP de una instancia quede en una lista negra, el sistema restringe estrictamente la migración en el panel subyacente. Si un contenedor mal configurado se ve comprometido y se utiliza para escanear redes externas, las consecuencias abarcan desde el bloqueo de la IP y la interrupción del servicio hasta la pérdida de los privilegios de migración y recuperación.
  • Requisitos mínimos de recuperación ante desastres fuera de las instalaciones: independientemente del proveedor subyacente, los directorios persistentes (Volumes) y las copias de seguridad Dump de bases de datos deben cifrarse y subirse fuera del host según una programación diaria mediante clientes de almacenamiento de objetos, como AWS S3, R2 o Backblaze B2. Nunca ponga todos los huevos en el disco virtual de una sola instancia.

7. Lista de verificación para el traspaso a producción#

Después de cualquier despliegue con Docker Compose o actualización de versión principal, complete la auditoría de traspaso siguiendo estos pasos:

Categoría de validaciónComprobaciones claveMétodo de verificación / Comportamiento esperado
Aislamiento de redLos puertos de base de datos/middleware no están expuestos a la red pública de InternetEjecutar en el host ss -tulpn | grep -E '3306|5432|6379' Sin escucha externa
Revisión de privilegiosLos contenedores de aplicaciones no deben usar el modo privilegiadocompose.yaml no contiene privileged: true, sin montajes de host innecesarios
Límites de recursosLos límites estrictos de memoria y CPU están configurados y son efectivosTras el inicio, use docker stats --no-stream Verifique que los límites de memoria del contenedor hayan surtido efecto
Rotación de registrosLos registros no llenarán el disco del hostCompruebe que cada servicio declare max-size y max-file Restricciones
Inicio automático tras un corte de energíaRecuperación automática tras el reinicio del hostConfiguración del servicio restart: unless-stopped, tras reiniciar docker ps Aparece
Copias de seguridad sin conexiónEstrategia de copia de seguridad remota y validación del respaldoVerifique que los archivos de copia de seguridad SQL automatizados no estén vacíos y puedan importarse a un entorno de prueba
Canal de acceso de emergenciaConsola de operaciones disponible en todo momentoVerifique con antelación las credenciales de inicio de sesión de la consola del proveedor para garantizar el acceso de bajo nivel a la resolución de problemas durante un corte de red