Tutoriais de VPS
MySQL 8.4 na VPS: Docker, acesso privado e backups testados
Implante MySQL 8.4 do zero com volume persistente, SSH e TLS. Separe permissões, automatize dumps verificados e restaure em um contêiner independente.

Instalar MySQL no Docker não termina quando o contêiner inicia. Antes de conectar uma aplicação, confira quem alcança a porta 3306, onde os dados permanecem após recriar o serviço e se um backup externo realmente pode ser restaurado. Este guia percorre essas etapas com uma instância nova do MySQL 8.4, Compose e túnel SSH.
Use a imagem oficial Docker mysql:8.4, não mysql/mysql-server. Não aplique o exemplo a diretórios existentes de MySQL ou MariaDB sem verificar compatibilidade de migração. Os recursos são referências de planejamento, não medições de desempenho.
| Uso | Ponto de partida | Conferir |
|---|---|---|
| Aprendizado ou ferramenta ocasional | 2 vCPU, 2 GB RAM, 30 GB SSD | Memória livre, backups e latência de disco |
| Site pequeno com aplicação no mesmo host | 2-4 vCPU, 4 GB RAM, 60 GB SSD | Picos, disputa por CPU e crescimento |
| Banco dedicado com escrita contínua | 4 vCPU, 8 GB RAM ou mais | IOPS, expansão, rede privada e recuperação |
Esses números não garantem quantidade de conexões: poucas consultas lentas podem custar mais que centenas curtas. Inclua armazenamento externo, tráfego de saída e administração. Mantenha aplicação e banco em região adequada e próxima; meça disco e memória antes de pagar por uma rota específica.
mysql:8.4 acompanha a série 8.4. latest e lts não garantem compatibilidade. Revise o patch disponível, registre o digest e teste atualizações numa instância restaurada. Consulte a imagem oficial para tags e variáveis atuais.
Use Docker Engine e plugin Compose suportados. Os comandos pressupõem Ubuntu 24.04 e Bash; veja instalação Docker. As operações seguintes usam uma sessão root autorizada e /opt/mysql84.
Confira se 3306 está ocupada e prepare diretórios:
docker version
docker compose version
ss -lntp 'sport = :3306'
install -d -m 700 /opt/mysql84
cd /opt/mysql84
install -d -m 700 secrets backups
Gere senhas diferentes uma única vez no diretório novo:
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/*
Salve em /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 à substituição do contêiner. Não acrescente -v a docker compose down para investigar falhas: isso solicita exclusão dos volumes. Segredos Compose são arquivos montados; root e administradores Docker podem lê-los.
Root fica restrito a localhost, com conta separada para a aplicação. A inicialização cria usuários/bancos somente em diretório vazio; trocar arquivo não altera senha existente. Veja o entrypoint.
127.0.0.1:3306:3306 restringe publicação no host; também mantenha 3306 fechada nas regras cloud. Use Engine suportado de pelo menos 28.0.0: versões anteriores têm exceção para equipamentos na mesma rede de camada 2, descrita em publicação de portas. Contêineres da mesma rede Docker ainda conectam; admita somente aplicações confiáveis.
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}}'
Aguarde inicialização e confira healthy com SQL autenticado. Use o mysql@sha256:… real completo para fixar image, sem copiar reticências. O healthcheck também detecta senhas administrativas descoordenadas.
No seu computador, substitua usuário SSH e endereço 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
Confira a impressão digital SSH e deixe a sessão aberta. Configure host 127.0.0.1, porta 13306, banco appdb, usuário appuser e senha obtida com segurança de secrets/mysql_app_password. No túnel integrado da interface, o destino do banco é 127.0.0.1:3306 na VPS; evite duplicar túneis.
require_secure_transport exige TLS para TCP. Teste com cliente compatível 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 deve mostrar uma cifra. REQUIRED criptografa sem validar hostname; aqui SSH com impressão digital verificada identifica o host remoto. Em conexão direta entre hosts, use rede controlada, CA confiável, hostname real no certificado e VERIFY_IDENTITY. O certificado autoassinado automático não atende necessariamente à validação de nome. Veja TLS MySQL.
Na rede Compose controlada, a aplicação costuma conectar a mysql:3306; seu 127.0.0.1 aponta para ela mesma. Entre na rede correta e configure TLS no driver. Um proxy HTTP comum não transporta MySQL.
appuser tem permissões amplas em appdb para criar tabelas. Depois das migrações, crie uma conta cotidiana separada:
docker compose exec mysql \
mysql --defaults-extra-file=/run/secrets/mysql_admin
Substitua a senha de exemplo por outra aleatória:
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'@'%';
Configure a aplicação com app_runtime. Reserve DDL para migrações e considere programas que migram ao iniciar. % corresponde a qualquer origem; não abre portas. O acesso depende também de rede e autenticação.
MySQL 8.4 desativa mysql_native_password por padrão. Atualize drivers antigos em vez de copiar --default-authentication-plugin=mysql_native_password. Consulte autenticação.
O script exporta appdb, tabelas, triggers, rotinas e eventos. Não salva outros bancos nem recria permissões de contas. Usa o arquivo administrativo do contêiner; para uso contínuo, avalie uma conta com os privilégios exatos do dump.
Salve 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 impede gzip de esconder uma falha do dump; o arquivo incompleto mantém .partial. --single-transaction atende principalmente InnoDB: evite DDL durante exportação. MyISAM e outras tabelas não transacionais exigem bloqueio ou pausa de escritas. Veja mysqldump.
Depois do teste manual, programe crontab -e de root às 03:20 no fuso do servidor:
20 3 * * * /bin/bash /opt/mysql84/backup.sh >> /opt/mysql84/backups/backup.log 2>&1
Monitore falhas e último backup válido, faça rotação dos logs e evite sobreposição se o dump demorar demais. Guarde arquivos completos, hashes, Compose, digest e SQL necessário para contas em armazenamento externo criptografado; separe as chaves. Uma cópia na mesma VPS não sobrevive à perda dela. Veja backups automáticos.
Ajuste retenção à capacidade e à perda tolerável. Dump diário pode perder quase um dia; PITR exige também binlogs arquivados e coordenadas do backup. Este exemplo não configura PITR completo.
Reserve RAM/disco adicionais. O teste usa volume próprio, sem rede nem portas produtivas. Escolha nomes livres; não apague recurso de mesmo nome sem identificá-lo.
Em /opt/mysql84, selecione arquivo 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
O ID local da imagem evita que 8.4 selecione outro patch durante o teste. Aguarde inicialização e SQL válido antes da importação:
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;'
Importe somente SQL confiável, pois ele é executado. Mantenha eventos desativados. Confira linhas exatas, registros recentes e tempo; SHOW TABLES não comprova recuperação funcional.
Para testar a aplicação, recrie usuários/permissões, revise DEFINER em views/rotinas/eventos e conecte a uma rede isolada, sem e-mails, pagamentos ou outras ações reais. docker stop mysql84-restore libera RAM mantendo o volume para inspeção. Veja simulado de restauração.
Buffer pool de 256 MB e limite de 1 GB são referências pequenas. Conexões, ordenações e temporários consomem mais; não iguale buffer pool ao limite. Ajuste com medições e documentação 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;"
Investigue pools e vazamentos antes de dobrar max_connections. Binlogs estão ativados; sete dias limita idade, não bytes. Muitas escritas podem encher disco antes. Siga retenção binlog, sem apagar arquivos manualmente.
Antes de atualizar, valide restauração, preserve digest anterior, teste patch/aplicação e programe manutenção de escritas. Imagem fixada exige alterar image; pull não substitui esse digest.
Na migração de versões antigas, confira caminhos suportados e compatibilidade. Para voltar, reconstrua com imagem antiga e backup anterior; não abra volume atualizado com servidor antigo.
Inicialização só afeta dados vazios. Use ALTER USER na conta e coordene segredos/clientes; preserve o volume. Veja conexões.
Confira túnel, 13306, usuário appuser em vez de root e TLS. Ter SSH não confirma inicialização.
Compare servidor, plugin e driver. Em instâncias novas, use driver compatível com caching_sha2_password; teste antes de migrar autenticação.
Talvez inicie, mas o exemplo precisa de memória adicional para o host. Não o aplique sem ajustes a 1 GB total. Em OOM/137, confira limites e diagnóstico de memória.
Cópia ao vivo pode ser inconsistente. Use dumps testados para bancos pequenos e ferramentas físicas compatíveis para maiores. Snapshot local não substitui cópia externa.
Contêineres do host usam rede Docker controlada; administração remota, SSH; aplicações entre hosts, rede privada ou túnel com TLS e permissões mínimas. Conclua restauração independente antes de conectar produção.