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.
/opt/stacks/web-app/
├── compose.yaml # 核心编排文件(Compose V2 规范)
├── .env # 敏感环境变量(权限 600,禁止提交至公开仓库)
├── config/ # 挂载至容器的应用专属静态配置文件
│ └── nginx.conf
└── data/ # 宿主机绑定挂载的数据目录(非必要时优先使用命名卷)
└── app-uploads/Pautas de gestión de directorios y credenciales#
- Convenciones de nomenclatura actualizadas: los complementos modernos de Compose utilizan sistemáticamente
compose.yaml(ocompose.yml) como archivo de configuración predeterminado; la antigua línea de declaración de nivel superiorversion: '3.8'. El comando es consistentementedocker compose(con un espacio entre las palabras), en lugar del binario independiente obsoletodocker-compose. - 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
.envdel 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:chmod 600 /opt/stacks/web-app/.env chown -R root:root /opt/stacks/web-app - 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.gitignoreexcluya estrictamente.envy todos los directoriosdata/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:
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: bridgeConsideraciones clave de arquitectura#
- Aislamiento de red de dos capas: El contenedor
dbse une únicamente abackend_net, eliminando por completo la posibilidad de comunicación con el internet público; los contenedoreswebutilizan el DNS integrado de Compose y el nombre del serviciodbpara 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-sizeymax-filepuede 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 ramamariadb: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”:
# 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 webAl 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#
- 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:Luego abra en su navegador local# 在本地工作电脑建立安全隧道,将远程端口转发至本地 ssh -N -L 9443:127.0.0.1:9443 user@vps-ip -i ~/.ssh/id_ed25519https://127.0.0.1:9443para acceder al panel. - 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.yamlno se ha sincronizado, la próxima vez que ejecutedocker compose up -dmediante 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#
[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.
# 进入部署目录
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:
# 仅拉取更新的镜像层
docker compose pull web
# 触发依赖项计算,仅重新创建发生了配置或镜像变更的容器
docker compose up -d web
# 清理不再使用的孤儿容器与旧版本镜像
docker compose ps
docker image prune -fdocker 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:
- Detenga los contenedores de aplicaciones inmediatamente:
docker compose stop web - Restablezca la base de datos utilizando la copia de seguridad exportada anteriormente:
# 清空并恢复数据库 gunzip < backup_YYYY-MM-DD.sql.gz | docker compose exec -T db mariadb -u ghost -p"${MYSQL_PASSWORD}" ghost_prod - Modifique
compose.yamlpara restaurar la etiqueta de imagen anterior y sus archivos de configuración correspondientes. - Reconstruya la versión anterior del contenedor:
docker compose up -d web
Advertencia: Evite
docker compose down -vdocker compose downsolo 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 encompose.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
rootdel 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 derootpara 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ón | Comprobaciones clave | Método de verificación / Comportamiento esperado |
|---|---|---|
| Aislamiento de red | Los puertos de base de datos/middleware no están expuestos a la red pública de Internet | Ejecutar en el host ss -tulpn | grep -E '3306|5432|6379' Sin escucha externa |
| Revisión de privilegios | Los contenedores de aplicaciones no deben usar el modo privilegiado | compose.yaml no contiene privileged: true, sin montajes de host innecesarios |
| Límites de recursos | Los límites estrictos de memoria y CPU están configurados y son efectivos | Tras el inicio, use docker stats --no-stream Verifique que los límites de memoria del contenedor hayan surtido efecto |
| Rotación de registros | Los registros no llenarán el disco del host | Compruebe que cada servicio declare max-size y max-file Restricciones |
| Inicio automático tras un corte de energía | Recuperación automática tras el reinicio del host | Configuración del servicio restart: unless-stopped, tras reiniciar docker ps Aparece |
| Copias de seguridad sin conexión | Estrategia de copia de seguridad remota y validación del respaldo | Verifique 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 emergencia | Consola de operaciones disponible en todo momento | Verifique 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 |