Tutoriais de VPS
MongoDB 8 na VPS: TLS, inicialização e backups testados
Implante MongoDB 8.0.38 com Replica Set de um membro e TLS privado. Corrija certificados, permissões, criação autenticada de contas e caminhos CA; teste backups oplog e recuperação isolada.

Problemas de MongoDB costumam vir de exposição, falta de autenticação, Replica Set não inicializado, certificados, memória ou backups nunca restaurados, mais do que da inserção do primeiro documento JSON.
O guia usa Ubuntu 24.04 e Compose com MongoDB Community em um Replica Set de um membro: contas SCRAM, keyfile interno, TLS obrigatório, portas privadas, limites e backups com oplog. O patch de 11 de setembro de 2026 era 8.0.32. A imagem e notas oficiais consultadas em 16 de novembro oferecem 8.0.38-noble, lançado em 10 de novembro. Use esse patch 8.0 revisado em instalação nova; evite latest e consulte avisos de segurança. A comparação anterior com a série estável 8.3 é histórica.
- Atributos variáveis de produtos, metadados e configurações.
- Documentos aninhados lidos ou escritos juntos.
- Eventos, dispositivos, catálogos e gestão de conteúdo.
- Projetos com Change Streams, transações e planejamento de escala.
Escolha por consultas, transações e ciclo dos dados. PostgreSQL/MySQL podem atender melhor relações, contabilidade e joins; para relevância textual, considere Elasticsearch. Ter JSON sozinho não justifica a escolha.
Inicializar um mongod como Replica Set permite:
- Oplog para Change Streams.
- Transações com vários documentos.
mongodump --oplogpara capturar gravações durante um backup lógico completo.
Não oferece tolerância a falha do host: existe só uma cópia online.
| Arquitetura | Redundância | Failover automático | Uso |
|---|---|---|---|
| Standalone | Nenhuma | Não | Testes temporários |
| Replica Set de um membro | Nenhuma | Não | Implantação recuperável com transações |
| Três nós de dados independentes | Sim | Com maioria de votos disponível | Serviços críticos e manutenção gradual |
| Três membros na mesma VPS | Falha compartilhada | Host interrompe todos | Aprendizado |
Avalie latência, eleições, majority write concern e tráfego entre regiões. Replicação propaga erros e exclusões; backups independentes continuam necessários.
WiredTiger usa seu cache e o cache do sistema de arquivos.
| Carga | VPS sugerida | Cache inicial | Premissa |
|---|---|---|---|
| Desenvolvimento | 2 vCPU, 4GB RAM, SSD de 40GB | 1GB | Dados leves e reconstruíveis |
| Produção pequena | 4 vCPU, 8GB RAM, NVMe de 100GB | 1,5–2GB | Folga para cache, Docker e monitoramento |
| Serviço crítico | Pelo menos 3 hosts, 4–8 vCPU/16GB+ cada | Medido | Domínios separados e backups externos |
O contêiner tem limite de 4GB e cache de 1,5GB. Conexões, agregações, índices e compressão precisam de memória extra; cache perto do limite pode provocar a morte de mongod.
Prefira NVMe e acompanhe dados, índices, journal e oplog. XFS é fortemente recomendado; EXT4 é suportado e precisa de teste real. MongoDB 8.0 recomenda ativar Transparent Huge Pages, ao contrário de muitos conselhos para 7.0 e anteriores.
| Porta | Uso | Exposição |
|---|---|---|
27017/TCP | Clientes | Apenas 127.0.0.1 |
Interna 27017 | Aplicativo/banco | Rede Compose |
22/TCP | Administração/túnel | Origens restritas e chaves SSH |
Não publique 27017:27017 para toda a internet. Use rede Docker, VPN/rede privada ou túnel SSH com validação TLS. Veja o guia de exposição dos bancos.
Instale antes Docker Engine e Compose v2 pelas instruções Ubuntu:
sudo apt update
sudo apt full-upgrade -y
sudo apt install -y ca-certificates curl jq openssl
docker --version
docker compose version
uname -r
Em amd64, confira AVX na CPU virtual e arquitetura suportada. As notas alertam sobre TCMalloc entre kernel 6.19 e 7.0.13; 7.0.14 ou posterior resolve esse intervalo. Confira uname -r sem presumir que Ubuntu mantém o kernel original.
sudo install -d -m 0750 -o "$USER" -g "$USER" \
/opt/mongodb/{config,secrets,tls,backups}
cd /opt/mongodb
umask 077
MONGO_ADMIN_PASSWORD="$(openssl rand -hex 32)"
MONGO_APP_PASSWORD="$(openssl rand -hex 32)"
MONGO_BACKUP_PASSWORD="$(openssl rand -hex 32)"
{
printf 'MONGODB_VERSION=8.0.32-noble\n'
printf 'MONGO_ADMIN_USER=mongoAdmin\n'
printf 'MONGO_ADMIN_PASSWORD=%s\n' "$MONGO_ADMIN_PASSWORD"
printf 'MONGO_APP_USER=appUser\n'
printf 'MONGO_APP_PASSWORD=%s\n' "$MONGO_APP_PASSWORD"
printf 'MONGO_BACKUP_USER=backupUser\n'
printf 'MONGO_BACKUP_PASSWORD=%s\n' "$MONGO_BACKUP_PASSWORD"
} > .env
chmod 600 .env
Cria segredos novos e sobrescreve o ambiente; não execute com credenciais existentes. Proteja .env e não publique docker compose config expandido. Hexadecimal simplifica URI; um gerenciador de segredos é preferível.
Selecione o patch consultado:
cd /opt/mongodb
sed -i 's/^MONGODB_VERSION=.*/MONGODB_VERSION=8.0.38-noble/' .env
chmod 600 .env
cd /opt/mongodb
openssl rand -base64 756 > secrets/mongodb-keyfile
chmod 400 secrets/mongodb-keyfile
sudo chown 999:999 secrets/mongodb-keyfile
Aceita 6–1024 caracteres base64 e permissões Unix restritas. Membros futuros precisam compartilhar pelo menos uma chave comum distribuída com segurança, sem repositórios públicos ou conversas comuns.
Cubra mongo, localhost e 127.0.0.1. Antes de assinar, altere extendedKeyUsage em server.ext para serverAuth,clientAuth: o processo do Replica Set pode atuar como servidor TLS e cliente interno.
cd /opt/mongodb/tls
openssl genrsa -out ca.key 4096
openssl req -x509 -new -sha256 -days 3650 \
-key ca.key \
-subj '/CN=VPS MongoDB Internal CA' \
-out ca.crt
openssl genrsa -out server.key 4096
openssl req -new -sha256 \
-key server.key \
-subj '/CN=mongo' \
-out server.csr
{
printf 'subjectAltName=DNS:mongo,DNS:localhost,IP:127.0.0.1\n'
printf 'extendedKeyUsage=serverAuth\n'
printf 'keyUsage=digitalSignature,keyEncipherment\n'
} > server.ext
openssl x509 -req -sha256 -days 825 \
-in server.csr \
-CA ca.crt -CAkey ca.key -CAcreateserial \
-extfile server.ext \
-out server.crt
cat server.crt server.key > server.pem
chmod 600 ca.key server.key server.pem
chmod 644 ca.crt server.crt
sudo chown 999:999 server.pem
openssl verify -CAfile ca.crt server.crt
openssl x509 -in server.crt -noout -subject -issuer -dates -ext subjectAltName
server.pem reúne certificado e chave privada. Para vários hosts, use SAN DNS reais e PKI gerenciada. TLS interno pode precisar de clientAuth além de serverAuth; planeje antes de ampliar. Não dependa de tlsAllowInvalidCertificates nem tlsAllowInvalidHostnames.
Crie /opt/mongodb/config/mongod.conf:
storage:
dbPath: /data/db
wiredTiger:
engineConfig:
cacheSizeGB: 1.5
net:
port: 27017
bindIpAll: true
tls:
mode: requireTLS
certificateKeyFile: /etc/mongo/tls/server.pem
CAFile: /etc/mongo/tls/ca.crt
replication:
replSetName: rs0
security:
authorization: enabled
keyFile: /etc/mongo/secrets/mongodb-keyfile
setParameter:
diagnosticDataCollectionEnabled: true
Para esses clientes SCRAM com TLS, adicione a propriedade dentro do net.tls existente, junto de mode e CAFile:
allowConnectionsWithoutCertificates: true
O padrão false exigiria certificados de cliente não fornecidos aqui. True mantém criptografia obrigatória e autenticação após bootstrap; certificados apresentados continuam validados. Para mTLS intencional, mantenha false e emita certificados apropriados.
bindIpAll controla apenas escuta no contêiner. O limite externo depende de 127.0.0.1:27017:27017, Docker e firewall; não substitua por 0.0.0.0.
Crie /opt/mongodb/compose.yml:
services:
mongo:
image: mongo:${MONGODB_VERSION}
container_name: mongodb
restart: unless-stopped
command: ["mongod", "--config", "/etc/mongo/mongod.conf"]
ports:
- "127.0.0.1:27017:27017"
environment:
MONGO_ADMIN_USER: ${MONGO_ADMIN_USER}
MONGO_ADMIN_PASSWORD: ${MONGO_ADMIN_PASSWORD}
MONGO_APP_USER: ${MONGO_APP_USER}
MONGO_APP_PASSWORD: ${MONGO_APP_PASSWORD}
MONGO_BACKUP_USER: ${MONGO_BACKUP_USER}
MONGO_BACKUP_PASSWORD: ${MONGO_BACKUP_PASSWORD}
volumes:
- mongo-data:/data/db
- ./config/mongod.conf:/etc/mongo/mongod.conf:ro
- ./secrets:/etc/mongo/secrets:ro
- ./tls:/etc/mongo/tls:ro
- ./backups:/backups
mem_limit: 4g
ulimits:
nofile:
soft: 64000
hard: 64000
healthcheck:
test:
- CMD-SHELL
- >-
mongosh --quiet --host localhost --port 27017 --tls
--tlsCAFile /etc/mongo/tls/ca.crt
-u "$${MONGO_ADMIN_USER}" -p "$${MONGO_ADMIN_PASSWORD}"
--authenticationDatabase admin
--eval 'quit(db.adminCommand({ping:1}).ok ? 0 : 2)'
interval: 15s
timeout: 10s
retries: 20
start_period: 90s
logging:
driver: json-file
options:
max-size: 10m
max-file: "5"
networks:
- mongo-net
volumes:
mongo-data:
networks:
mongo-net:
name: mongo-net
8.0.32-noble é o exemplo histórico; o ambiente atualizado seleciona o patch revisado. Essas variáveis não criam usuários automaticamente: o bootstrap é explícito.
Antes de iniciar, ajuste ao usuário da imagem. Mudar só o keyfile não basta se o diretório bloquear acesso; o contêiner do banco também precisa gravar backups:
cd /opt/mongodb
MONGO_SELECTED_IMAGE="$(docker compose config --images)"
MONGO_CONTAINER_UID="$(docker run --rm --entrypoint id "$MONGO_SELECTED_IMAGE" -u mongodb)"
MONGO_CONTAINER_GID="$(docker run --rm --entrypoint id "$MONGO_SELECTED_IMAGE" -g mongodb)"
sudo chown "$MONGO_CONTAINER_UID:$MONGO_CONTAINER_GID" secrets tls backups
sudo chmod 750 secrets tls
sudo chmod 700 backups
sudo chown "$MONGO_CONTAINER_UID:$MONGO_CONTAINER_GID" secrets/mongodb-keyfile tls/server.pem
sudo chmod 400 secrets/mongodb-keyfile
sudo chmod 600 tls/server.pem
sudo chown "root:$MONGO_CONTAINER_GID" config/mongod.conf
sudo chmod 640 config/mongod.conf
unset MONGO_SELECTED_IMAGE MONGO_CONTAINER_UID MONGO_CONTAINER_GID
Pressupõe um serviço Compose. A chave de assinatura CA mantém proprietário separado e modo 600, sem acesso do aplicativo; a manutenção pode exigir privilégios após alterar diretórios.
cd /opt/mongodb
docker compose config --quiet
docker compose pull
docker compose up -d
docker compose logs --tail=100 mongo
Antes de criar administrador, health checks podem indicar starting ou unhealthy. Use localhost exception na inicialização:
docker compose exec -T mongo mongosh --quiet \
--host localhost --port 27017 \
--tls --tlsCAFile /etc/mongo/tls/ca.crt \
--eval '
rs.initiate({
_id: "rs0",
members: [{ _id: 0, host: "mongo:27017" }]
})
'
until docker compose exec -T mongo mongosh --quiet \
--host localhost --port 27017 \
--tls --tlsCAFile /etc/mongo/tls/ca.crt \
--eval 'quit(db.hello().isWritablePrimary ? 0 : 2)'
do
sleep 2
done
members[0].host é mongo:27017, resolvível em mongo-net. Clientes remotos precisam de nomes de membros roteáveis e SANs correspondentes: tunelar somente bootstrap não torna o nome Docker anunciado acessível. Para diagnóstico de um membro, directConnection=true seleciona esse membro; em uso contínuo, planeje a topologia privada.
A exceção localhost termina quando o primeiro usuário é criado. Insira esta linha logo após createUser do administrador e antes das outras contas:
admin.auth(process.env.MONGO_ADMIN_USER, process.env.MONGO_ADMIN_PASSWORD);
Depois execute:
docker compose exec -T mongo mongosh --quiet \
--host localhost --port 27017 \
--tls --tlsCAFile /etc/mongo/tls/ca.crt \
--eval '
const admin = db.getSiblingDB("admin");
admin.createUser({
user: process.env.MONGO_ADMIN_USER,
pwd: process.env.MONGO_ADMIN_PASSWORD,
roles: [{ role: "root", db: "admin" }]
});
const app = db.getSiblingDB("appdb");
app.createUser({
user: process.env.MONGO_APP_USER,
pwd: process.env.MONGO_APP_PASSWORD,
roles: [{ role: "readWrite", db: "appdb" }]
});
admin.createUser({
user: process.env.MONGO_BACKUP_USER,
pwd: process.env.MONGO_BACKUP_PASSWORD,
roles: [
{ role: "backup", db: "admin" },
{ role: "restore", db: "admin" }
]
});
'
docker compose ps
Se parou após criar administrador, autentique-se com ele e crie só as contas faltantes; não apague dados nem reinicialize. Aplicativos usam appUser, não mongoAdmin. O exemplo reúne backup/restore por conveniência; em produção mantenha só backup e separe credenciais de recuperação.
cd /opt/mongodb
set -a
. ./.env
set +a
docker compose exec -T mongo mongosh --quiet \
--host localhost --port 27017 \
--tls --tlsCAFile /etc/mongo/tls/ca.crt \
-u "$MONGO_ADMIN_USER" -p "$MONGO_ADMIN_PASSWORD" \
--authenticationDatabase admin \
--eval '
printjson(db.hello());
printjson(rs.status().members.map(m => ({name:m.name,stateStr:m.stateStr})));
'
Espere setName: "rs0", isWritablePrimary: true e PRIMARY. Confira appdb:
docker compose exec -T mongo mongosh --quiet \
--host localhost --port 27017 \
--tls --tlsCAFile /etc/mongo/tls/ca.crt \
-u "$MONGO_APP_USER" -p "$MONGO_APP_PASSWORD" \
--authenticationDatabase appdb \
--eval '
const app = db.getSiblingDB("appdb");
app.healthcheck.insertOne({checkedAt:new Date(),source:"deploy"});
printjson(app.healthcheck.findOne({source:"deploy"}));
'
Teste também negação de administração e outros bancos. Use:
mongodb://appUser:PASSWORD@mongo:27017/appdb?authSource=appdb&replicaSet=rs0&tls=true&tlsCAFile=/run/secrets/mongodb-ca.crt
Troque PASSWORD com segurança, não guarde URI reais no Git e codifique caracteres reservados.
services:
app:
image: your-app:stable
networks:
- app-net
- mongo-net
secrets:
- mongodb_ca
networks:
app-net:
mongo-net:
external: true
secrets:
mongodb_ca:
file: ./secrets/mongodb-ca.crt
A imagem app é um marcador. Copie só /opt/mongodb/tls/ca.crt para o secret. O nome padrão é mongodb_ca, mas a URI usa mongodb-ca.crt: configure target mongodb-ca.crt ou ajuste para /run/secrets/mongodb_ca. Não entregue chaves do servidor/Replica Set nem administrador.
--oplog captura gravações e --oplogReplay as reproduz:
cd /opt/mongodb
docker compose exec -T mongo sh -lc '
set -eu
ts="$(date -u +%Y%m%dT%H%M%SZ)"
mongodump \
--host localhost --port 27017 \
--tls --tlsCAFile /etc/mongo/tls/ca.crt \
-u "$MONGO_BACKUP_USER" -p "$MONGO_BACKUP_PASSWORD" \
--authenticationDatabase admin \
--oplog --gzip \
--archive="/backups/mongodb-${ts}.archive.gz"
sha256sum "/backups/mongodb-${ts}.archive.gz" \
> "/backups/mongodb-${ts}.archive.gz.sha256"
'
find backups -maxdepth 1 -type f -printf '%TY-%Tm-%Td %TH:%TM %s %f\n' | sort
É backup da instância inteira, não de um banco filtrado. Mantenha a janela oplog maior que a duração e evite mudanças concorrentes não suportadas. Confira resultado e arquivo legível.
/opt/mongodb/backups compartilha a falha do host. Criptografe e envie arquivos/digests a armazenamento independente com credenciais separadas, retenção, versionamento, criptografia do provedor e regras de ciclo de vida. O checksum usa caminho absoluto do contêiner; ajuste ao verificar externamente.
Em bancos grandes, mongodump consome CPU/I/O/rede. Avalie snapshots consistentes suportados, Ops Manager/Cloud Manager ou Atlas e o impacto no Primary.
Não teste --drop em produção. Prepare outro Replica Set compatível, arquivo/CA e restoreUser com os privilégios exigidos:
mongorestore \
--host localhost --port 27017 \
--tls --tlsCAFile /path/to/ca.crt \
-u restoreUser -p \
--authenticationDatabase admin \
--drop --gzip \
--archive=/path/to/mongodb-20260916T120000Z.archive.gz \
--oplogReplay
Oplog replay exige permissões além do papel restore. Conceda à conta do destino isolado o privilégio documentado anyAction sobre anyResource e remova esse acesso amplo depois do ensaio. O dump completo pode restaurar usuários/papéis: preserve as credenciais administrativas copiadas, sem presumir que a conta temporária sobreviverá.
Confira bancos, coleções, documentos, índices, contas, leitura/gravação e replicação. mongodump não copia o host: preserve separadamente .env, chaves CA, configuração, monitoramento e manual. Datas de arquivos são exemplos; use o nome real.
opcounters, latência e consultas lentas.- Conexões, capacidade e taxa de criação.
- Cache WiredTiger, dirty bytes, eviction e checkpoints.
- Page faults, RAM, swap e OOM.
- Dados, índices, journal/oplog e latência I/O.
- Réplicas, lag, eleições e falhas majority.
- Duração/tamanho do backup, upload e restauração.
Use Prometheus e Grafana. serverStatus e dbStats fornecem sinais básicos:
db.serverStatus().connections
db.serverStatus().wiredTiger.cache
db.serverStatus().opcounters
db.getSiblingDB("appdb").stats(1024 * 1024)
rs.printReplicationInfo()
Corrija consultas/índices e limite resultados antes de ampliar cache ou hardware. Índices custam memória, disco e gravação; valide com explain("executionStats").
Leia notas, faça backup externo e teste recuperação:
cd /opt/mongodb
docker compose exec -T mongo mongosh --quiet \
--host localhost --port 27017 \
--tls --tlsCAFile /etc/mongo/tls/ca.crt \
-u "$MONGO_ADMIN_USER" -p "$MONGO_ADMIN_PASSWORD" \
--authenticationDatabase admin \
--eval 'printjson(db.adminCommand({getParameter:1,featureCompatibilityVersion:1}))'
docker compose pull mongo
docker compose up -d mongo
docker compose ps
docker compose logs --tail=150 mongo
Troque primeiro o patch explícito: baixar a mesma tag não atualiza. Confira versão, Replica Set, aplicativos, consultas e backups. Evite mongo:8 como transição sem controle; siga caminhos suportados e só eleve FCV após compatibilidade de membros/drivers.
Um nó exige parada. Em conjuntos independentes, siga a sequência secundária/primária oficial.
cd /opt/mongodb
docker compose ps
docker compose logs --since=15m --tail=300 mongo
docker inspect mongodb --format '{{.State.Status}} {{.State.ExitCode}} {{.State.OOMKilled}}'
Confira keyfile/server.pem, diretórios, YAML, volume, memória e kernel pelo guia de contêineres.
ls -l /opt/mongodb/secrets/mongodb-keyfile
sudo chown 999:999 /opt/mongodb/secrets/mongodb-keyfile
sudo chmod 400 /opt/mongodb/secrets/mongodb-keyfile
docker compose restart mongo
Confirme UID/GID e diretório. Não use chmod 777: chaves legíveis por grupo/todos são rejeitadas.
openssl verify -CAfile /opt/mongodb/tls/ca.crt \
/opt/mongodb/tls/server.crt
openssl x509 -in /opt/mongodb/tls/server.crt \
-noout -ext subjectAltName
mongo precisa de DNS:mongo; 127.0.0.1 exige IP SAN. Confira confiança e validade.
docker compose exec -T mongo mongosh --quiet \
--host localhost --port 27017 \
--tls --tlsCAFile /etc/mongo/tls/ca.crt \
-u "$MONGO_ADMIN_USER" -p "$MONGO_ADMIN_PASSWORD" \
--authenticationDatabase admin \
--eval 'printjson(rs.status())'
Com um membro, confira mongo:27017, rede e volume originais. Com vários, DNS, relógio, chaves, SANs, rotas e maioria.
ss -lntp | grep 27017
docker network inspect mongo-net
docker compose exec -T mongo mongosh --quiet \
--host localhost --port 27017 \
--tls --tlsCAFile /etc/mongo/tls/ca.crt \
-u "$MONGO_ADMIN_USER" -p "$MONGO_ADMIN_PASSWORD" \
--authenticationDatabase admin \
--eval 'db.adminCommand({ping:1})'
Confira mongo-net. Antes de considerar 0.0.0.0, estabeleça acesso privado/túnel e DNS/SAN. Veja portas e firewall.
Confira docker inspect, dmesg, cache e agregações. Reduzir cacheSizeGB não resolve $group sem limite, ordenações, resultados grandes ou índices. Limite consultas e deixe folga.
Desenvolvimento a partir de 2 vCPU/4GB; produção pequena costuma exigir 4 vCPU/8GB e NVMe. Meça conjunto de trabalho, consultas, cache e disco.
Não: oferece oplog, transações e Change Streams. É necessário separar membros de dados/votos e manter monitoramento e backups.
Mantenha 127.0.0.1, Docker localmente e VPN/rede privada/túnel remotamente com TLS e autorização.
Tags flutuantes podem mudar compatibilidade. 8.0.32-noble histórico e o substituto são patches explícitos; atualize após testar recuperação.
Não: atende dados lógicos manejáveis. Preserve chaves/configuração e backups externos; avalie snapshots ou ferramentas suportadas para sistemas grandes.
Replicação dá redundância/failover; sharding distribui capacidade entre shards, normalmente Replica Sets. Não acrescente complexidade antes de precisar.