Tutoriales de VPS
MySQL 8.4 en un VPS: Docker, acceso privado y copias probadas
Despliega MySQL 8.4 desde cero con volumen persistente, SSH y TLS. Separa permisos, automatiza dumps comprobados y restaura en un contenedor independiente.

Instalar MySQL en Docker no termina al arrancar el contenedor. Antes de conectar una aplicación, comprueba quién alcanza 3306, dónde quedan los datos al recrear el servicio y si una copia externa se puede restaurar. Esta guía recorre esas etapas en una instancia nueva de MySQL 8.4 con Compose y un túnel SSH.
Usa la imagen oficial Docker mysql:8.4, no mysql/mysql-server. No apliques el ejemplo a un directorio existente de MySQL o MariaDB sin comprobar compatibilidad de migración. Los recursos son referencias de planificación, no resultados de rendimiento.
| Uso | Punto de partida | Comprobar |
|---|---|---|
| Aprendizaje o herramienta ocasional | 2 vCPU, 2 GB RAM, 30 GB SSD | Memoria libre, copias y latencia de disco |
| Web pequeña con aplicación en el mismo host | 2-4 vCPU, 4 GB RAM, 60 GB SSD | Picos, competencia por CPU y crecimiento |
| Base dedicada con escritura sostenida | 4 vCPU, 8 GB RAM o más | IOPS, ampliación, red privada y recuperación |
No prometen un número de conexiones: pocas consultas lentas pueden consumir más que cientos cortas. Incluye almacenamiento externo, tráfico de salida y administración. Mantén aplicación y base en una región adecuada y cercana; mide disco y memoria antes de pagar por una ruta concreta.
mysql:8.4 sigue la serie 8.4. latest y lts no garantizan compatibilidad. Revisa el parche disponible, registra su digest y prueba futuras actualizaciones en una copia restaurada. Consulta la imagen oficial para etiquetas y variables vigentes.
Usa Docker Engine y Compose soportados. Los comandos asumen Ubuntu 24.04 y Bash; consulta instalación Docker. Las operaciones siguientes requieren una sesión root autorizada y /opt/mysql84.
Comprueba que 3306 no esté ocupado y prepara directorios:
docker version
docker compose version
ss -lntp 'sport = :3306'
install -d -m 700 /opt/mysql84
cd /opt/mysql84
install -d -m 700 secrets backups
Genera contraseñas diferentes una sola vez en el directorio nuevo:
umask 077
openssl rand -hex 32 > secrets/mysql_root_password
openssl rand -hex 32 > secrets/mysql_app_password
printf '[client]\nuser=root\npassword=%s\nprotocol=socket\n' \
"$(cat secrets/mysql_root_password)" > secrets/mysql_admin.cnf
chmod 600 secrets/*
Guarda en /opt/mysql84/compose.yaml:
name: mysql84
services:
mysql:
image: mysql:8.4
restart: unless-stopped
stop_grace_period: 1m
environment:
MYSQL_ROOT_PASSWORD_FILE: /run/secrets/mysql_root_password
MYSQL_ROOT_HOST: localhost
MYSQL_DATABASE: appdb
MYSQL_USER: appuser
MYSQL_PASSWORD_FILE: /run/secrets/mysql_app_password
secrets:
- mysql_root_password
- mysql_app_password
- mysql_admin
ports:
- "127.0.0.1:3306:3306"
volumes:
- mysql_data:/var/lib/mysql
command:
- --character-set-server=utf8mb4
- --collation-server=utf8mb4_0900_ai_ci
- --require-secure-transport=ON
- --innodb-buffer-pool-size=256M
- --max-connections=50
- --binlog-expire-logs-seconds=604800
mem_limit: 1g
healthcheck:
test:
- CMD
- mysql
- --defaults-extra-file=/run/secrets/mysql_admin
- --batch
- --skip-column-names
- -e
- SELECT 1
interval: 15s
timeout: 5s
retries: 10
start_period: 90s
logging:
driver: json-file
options:
max-size: "10m"
max-file: "3"
volumes:
mysql_data:
secrets:
mysql_root_password:
file: ./secrets/mysql_root_password
mysql_app_password:
file: ./secrets/mysql_app_password
mysql_admin:
file: ./secrets/mysql_admin.cnf
mysql_data sobrevive al reemplazo del contenedor. No añadas -v a docker compose down al investigar fallos: solicita borrar volúmenes. Los secretos de Compose son archivos montados; root y administradores Docker pueden leerlos.
Root queda limitado a localhost, con otra cuenta para la aplicación. La inicialización solo crea usuarios/bases en datos vacíos; cambiar un archivo no cambia la contraseña existente. Consulta el entrypoint.
127.0.0.1:3306:3306 restringe la publicación del host; tampoco abras 3306 en reglas cloud. Usa Engine soportado de al menos 28.0.0: versiones anteriores tienen una excepción para equipos en la misma red de capa 2, descrita en publicación de puertos. Contenedores de la misma red Docker aún pueden conectar; admite solo aplicaciones confiables.
cd /opt/mysql84
docker compose config --quiet
docker compose pull
docker compose up -d
docker compose ps
docker compose logs --tail=100 mysql
docker compose exec -T mysql \
mysql --defaults-extra-file=/run/secrets/mysql_admin \
-e 'SELECT VERSION(); SHOW DATABASES;'
docker image inspect mysql:8.4 --format '{{json .RepoDigests}}'
Espera a terminar la inicialización y comprueba healthy junto con SQL autenticado. Usa el mysql@sha256:… real completo para fijar image, sin copiar puntos suspensivos. El healthcheck también detecta contraseñas administrativas descoordinadas.
Desde tu ordenador, sustituye usuario SSH y dirección VPS:
ssh -N -T -o ExitOnForwardFailure=yes \
-o ServerAliveInterval=30 -o ServerAliveCountMax=3 \
-L 127.0.0.1:13306:127.0.0.1:3306 deploy@VPS_IP
Verifica la huella SSH y deja la sesión abierta. Configura host 127.0.0.1, puerto 13306, base appdb, usuario appuser y contraseña obtenida de secrets/mysql_app_password de forma segura. Con túnel integrado del cliente, el destino de la base es 127.0.0.1:3306 en el VPS; evita duplicar túneles.
require_secure_transport exige TLS para TCP. Prueba con cliente compatible MySQL 8.4:
mysql --protocol=TCP -h 127.0.0.1 -P 13306 \
-u appuser -p --ssl-mode=REQUIRED appdb
SHOW SESSION STATUS LIKE 'Ssl_cipher';
SELECT CURRENT_USER(), DATABASE();
Ssl_cipher debe mostrar un cifrado. REQUIRED cifra sin verificar hostname; aquí la identidad del host remoto la aporta SSH con huella verificada. Para conexión directa entre hosts, usa red controlada, CA confiable, hostname real en certificado y VERIFY_IDENTITY. El certificado autofirmado automático no cumple necesariamente esa validación. Consulta TLS MySQL.
En la red Compose controlada, la aplicación suele conectar a mysql:3306; su 127.0.0.1 apunta a sí misma. Conecta a la red correcta y configura TLS del driver. Un proxy HTTP convencional no transporta MySQL.
appuser tiene permisos amplios sobre appdb para crear tablas. Tras migrar, crea una cuenta cotidiana distinta:
docker compose exec mysql \
mysql --defaults-extra-file=/run/secrets/mysql_admin
Sustituye la contraseña de ejemplo por otra aleatoria:
CREATE USER 'app_runtime'@'%'
IDENTIFIED BY 'REPLACE_WITH_A_NEW_RANDOM_PASSWORD' REQUIRE SSL;
GRANT SELECT, INSERT, UPDATE, DELETE ON appdb.* TO 'app_runtime'@'%';
SHOW GRANTS FOR 'app_runtime'@'%';
Configura la aplicación con app_runtime. Reserva DDL para migraciones y considera programas que migran al arrancar. % coincide con cualquier origen; no abre puertos. Acceso depende también de red y autenticación.
MySQL 8.4 desactiva mysql_native_password por defecto. Actualiza drivers antiguos en vez de copiar --default-authentication-plugin=mysql_native_password. Consulta autenticación.
El script exporta appdb, tablas, triggers, rutinas y eventos. No guarda otras bases ni recrea permisos de cuentas. Usa el archivo administrativo del contenedor; para uso permanente, considera una cuenta con los permisos exactos del dump.
Guarda como /opt/mysql84/backup.sh:
#!/usr/bin/env bash
set -euo pipefail
umask 077
cd /opt/mysql84
backup_stamp=$(date -u +%Y%m%dT%H%M%SZ)
backup_file="backups/appdb-${backup_stamp}.sql.gz"
test ! -e "$backup_file"
test ! -e "${backup_file}.partial"
docker compose exec -T mysql \
mysqldump --defaults-extra-file=/run/secrets/mysql_admin \
--single-transaction --quick --routines --events --triggers \
--hex-blob --no-tablespaces --set-gtid-purged=OFF \
--databases appdb | gzip > "${backup_file}.partial"
gzip -t "${backup_file}.partial"
mv "${backup_file}.partial" "$backup_file"
sha256sum "$backup_file" > "${backup_file}.sha256"
printf 'Backup ready: %s\n' "$backup_file"
chmod 700 /opt/mysql84/backup.sh
/opt/mysql84/backup.sh
pipefail evita que gzip esconda un fallo del dump; el archivo incompleto conserva .partial. --single-transaction sirve principalmente para InnoDB: evita DDL mientras exportas. MyISAM y otras tablas no transaccionales requieren bloqueo o pausa de escrituras. Consulta mysqldump.
Tras probarlo manualmente, programa crontab -e de root a las 03:20 del huso del servidor:
20 3 * * * /bin/bash /opt/mysql84/backup.sh >> /opt/mysql84/backups/backup.log 2>&1
Vigila fallos y última copia válida, rota logs y evita solapamientos si el dump tarda demasiado. Guarda archivos completos, hashes, Compose, digest y SQL necesario para cuentas en almacenamiento externo cifrado; separa las claves. Una copia en el mismo VPS no sobrevive a perderlo. Consulta copias automáticas.
Ajusta retención a capacidad y pérdida tolerable. Un dump diario puede perder casi un día; PITR necesita además binlogs archivados y coordenadas del backup. Este ejemplo no configura PITR completo.
Reserva RAM/disco adicionales. La prueba crea volumen propio, sin red ni puertos productivos. Usa nombres libres; no borres un recurso homónimo sin identificarlo.
En /opt/mysql84, selecciona archivo real:
cd /opt/mysql84
backup_file='backups/appdb-YYYYMMDDTHHMMSSZ.sql.gz'
sha256sum -c "${backup_file}.sha256"
gzip -t "$backup_file"
restore_volume=$(docker volume create)
restore_image=$(docker compose images -q mysql)
test -n "$restore_image"
docker run -d --name mysql84-restore --network none --memory 1g \
--mount "type=volume,src=${restore_volume},dst=/var/lib/mysql" \
--mount "type=bind,src=$PWD/secrets/mysql_root_password,dst=/run/secrets/mysql_root_password,readonly" \
--mount "type=bind,src=$PWD/secrets/mysql_admin.cnf,dst=/run/secrets/mysql_admin,readonly" \
-e MYSQL_ROOT_PASSWORD_FILE=/run/secrets/mysql_root_password \
-e MYSQL_ROOT_HOST=localhost \
"$restore_image" --event-scheduler=OFF --innodb-buffer-pool-size=256M
docker logs --tail=50 mysql84-restore
El ID local de imagen evita que 8.4 cambie de parche durante la prueba. Espera inicialización y SQL válido antes de importar:
docker exec mysql84-restore \
mysql --defaults-extra-file=/run/secrets/mysql_admin -e 'SELECT 1;'
set -o pipefail
gzip -dc "$backup_file" | docker exec -i mysql84-restore \
mysql --defaults-extra-file=/run/secrets/mysql_admin
docker exec mysql84-restore \
mysql --defaults-extra-file=/run/secrets/mysql_admin \
-e 'SHOW TABLES FROM appdb;'
Importa solo SQL confiable, porque se ejecuta. Mantén eventos desactivados. Comprueba filas exactas, registros recientes y tiempo; SHOW TABLES no demuestra recuperación funcional.
Para probar la aplicación, recrea usuarios/permisos, revisa DEFINER en vistas/rutinas/eventos y conecta a red aislada, sin correo, pagos ni otras acciones reales. docker stop mysql84-restore libera RAM dejando volumen para revisión. Consulta simulacro de restauración.
256 MB de buffer pool y límite de 1 GB son referencias pequeñas. Conexiones, ordenaciones y temporales consumen más; no iguale buffer pool al límite. Ajusta con mediciones y documentación InnoDB:
docker stats --no-stream
df -h
docker compose exec -T mysql \
mysql --defaults-extra-file=/run/secrets/mysql_admin \
-e "SHOW GLOBAL STATUS WHERE Variable_name IN ('Threads_connected','Max_used_connections','Slow_queries'); SHOW BINARY LOGS;"
Investiga pools y fugas antes de duplicar max_connections. Binlogs están activados; siete días limita edad, no bytes. Mucha escritura puede llenar disco antes. Sigue retención binlog, sin borrar archivos manualmente.
Antes de actualizar, valida restauración, conserva digest anterior, prueba parche/aplicación y programa mantenimiento de escrituras. Una imagen fijada requiere cambiar image; pull no sustituye ese digest.
Al migrar versiones antiguas, revisa rutas admitidas y compatibilidad. Para volver, reconstruye con imagen antigua y copia previa; no abras un volumen actualizado con servidor anterior.
La inicialización solo afecta datos vacíos. Usa ALTER USER sobre la cuenta y coordina secretos/clientes; conserva volumen. Consulta conexiones.
Revisa túnel, 13306, usuario appuser en vez de root y TLS. Tener SSH no confirma inicialización.
Compara servidor, plugin y driver. En instancias nuevas usa driver compatible con caching_sha2_password; prueba antes de migrar autenticación.
Quizá arranque, pero el ejemplo necesita memoria adicional para el host. No lo apliques sin cambios a 1 GB total. En OOM/137, revisa límites y diagnóstico de memoria.
Una copia en vivo puede ser inconsistente. Usa dumps probados para bases pequeñas y herramientas físicas compatibles para mayores. Snapshot local no sustituye copia externa.
Contenedores del host usan red Docker controlada; administración remota, SSH; aplicaciones entre hosts, red privada o túnel con TLS y permisos mínimos. Completa restauración independiente antes de conectar producción.