Tutoriales de VPS
MongoDB 8 en VPS: TLS, inicialización y copias comprobadas
Instale MongoDB 8.0.38 con Replica Set de un miembro y TLS privado. Corrija certificados, permisos, creación autenticada de cuentas y rutas CA; compruebe copias oplog y recuperación aislada.

Los fallos de MongoDB suelen venir de exposición, falta de autenticación, Replica Set sin inicializar, certificados incorrectos, memoria o copias nunca restauradas, más que de insertar el primer documento JSON.
La guía utiliza Ubuntu 24.04 y Compose con MongoDB Community en un Replica Set de un miembro: cuentas SCRAM, keyfile interno, TLS obligatorio, puertos privados, recursos limitados y copias con oplog. El parche del 11 de septiembre de 2026 era 8.0.32. La imagen y notas oficiales consultadas el 16 de noviembre ofrecen 8.0.38-noble, publicado el 10 de noviembre. Use ese parche 8.0 revisado para instalación nueva; evite latest y revise avisos de seguridad. La comparación anterior con la serie estable 8.3 es histórica.
- Atributos variables de productos, metadatos y configuración.
- Documentos anidados que se leen/escriben juntos.
- Eventos, dispositivos, catálogos y gestión de contenidos.
- Proyectos con Change Streams, transacciones o planificación de escala.
Decida por consultas, transacciones y ciclo de datos. PostgreSQL/MySQL pueden encajar mejor con relaciones, contabilidad y joins; para relevancia textual, considere Elasticsearch. Tener JSON no justifica por sí solo la elección.
Inicializar un mongod como Replica Set permite:
- Oplog para Change Streams.
- Transacciones multidocumento.
mongodump --oplogpara capturar escrituras durante una copia lógica completa.
No aporta tolerancia a fallo del host: solo existe una copia online.
| Arquitectura | Redundancia | Failover automático | Uso |
|---|---|---|---|
| Standalone | Ninguna | No | Pruebas temporales |
| Replica Set de un miembro | Ninguna | No | Despliegues recuperables con transacciones |
| Tres nodos de datos independientes | Sí | Con mayoría de votos disponible | Servicios críticos y mantenimiento gradual |
| Tres miembros en una VPS | Fallo compartido | El host interrumpe todos | Aprendizaje |
Evalúe latencia, elecciones, majority write concern y tráfico entre regiones. La replicación transmite errores y borrados; siguen haciendo falta copias independientes.
WiredTiger utiliza su caché y la del sistema de archivos.
| Carga | VPS orientativa | Caché inicial | Condición |
|---|---|---|---|
| Desarrollo | 2 vCPU, 4GB RAM, 40GB SSD | 1GB | Datos ligeros y reconstruibles |
| Producción pequeña | 4 vCPU, 8GB RAM, 100GB NVMe | 1,5–2GB | Margen para caché, Docker y supervisión |
| Servicio crítico | Al menos 3 hosts, 4–8 vCPU/16GB+ cada uno | Medida | Dominios separados y copias externas |
El contenedor se limita a 4GB y caché a 1,5GB. Conexiones, agregaciones, índices y compresión necesitan más memoria; acercar caché al límite puede provocar la muerte de mongod.
Prefiera NVMe y vigile datos, índices, journal y oplog. XFS está fuertemente recomendado; EXT4 se admite y necesita pruebas reales. MongoDB 8.0 recomienda activar Transparent Huge Pages, al contrario de muchos consejos para 7.0 o anteriores.
| Puerto | Uso | Exposición |
|---|---|---|
27017/TCP | Clientes | Solo 127.0.0.1 |
Interno 27017 | Aplicación/base | Red Compose |
22/TCP | Administración/túnel | Orígenes limitados y claves SSH |
No publique 27017:27017 a todo Internet. Use red Docker, VPN/red privada o túneles SSH con TLS verificado. Consulte la guía de exposición de bases.
Instale antes Docker Engine y Compose v2 con las instrucciones 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
En amd64, confirme AVX en la CPU virtual y arquitectura compatible. Las notas advierten de TCMalloc entre kernel 6.19 y 7.0.13; 7.0.14 o posterior resuelve ese intervalo. Revise uname -r sin suponer que Ubuntu mantiene su kernel original.
Use la lista de Compose para producción.
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
Crea secretos nuevos y sobrescribe entorno; no lo ejecute con credenciales existentes. Proteja .env y no publique docker compose config expandido. Hexadecimal simplifica URI; un gestor de secretos es preferible.
Seleccione el parche 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
Admite 6–1024 caracteres base64 y permisos Unix restrictivos. Los futuros miembros deben compartir al menos una clave común distribuida de forma segura, sin repositorios públicos ni chats ordinarios.
Cubra mongo, localhost y 127.0.0.1. Antes de firmar, cambie extendedKeyUsage en server.ext a serverAuth,clientAuth: el proceso del Replica Set puede actuar como servidor TLS y 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 combina certificado y clave privada. Para varios hosts, use SAN DNS reales e infraestructura PKI. Las conexiones TLS internas pueden necesitar clientAuth además de serverAuth; prepárelo antes de ampliar. No dependa de tlsAllowInvalidCertificates ni tlsAllowInvalidHostnames.
Cree /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 estos clientes SCRAM sobre TLS, añada la propiedad dentro de net.tls existente, junto a mode y CAFile:
allowConnectionsWithoutCertificates: true
Por defecto es false y exigiría certificados de cliente no suministrados aquí. True conserva cifrado obligatorio y autenticación tras bootstrap; los certificados presentados siguen verificándose. Si pretende mTLS, mantenga false y emita certificados apropiados.
bindIpAll solo controla escucha en el contenedor. El límite externo depende de 127.0.0.1:27017:27017, Docker y cortafuegos; no lo sustituya por 0.0.0.0.
Cree /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 es el ejemplo histórico; el entorno actualizado selecciona el parche revisado. Estas variables de usuario no crean cuentas automáticamente: se usa bootstrap explícito.
Antes de arrancar, ajuste al usuario de la imagen. Cambiar solo el keyfile no basta si su directorio impide acceder, y el contenedor de la base necesita escribir copias:
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
Supone un servicio Compose. La clave de firma CA debe conservar propietario separado y modo 600 sin acceso de aplicación; su mantenimiento puede necesitar privilegios tras cambiar directorios.
cd /opt/mongodb
docker compose config --quiet
docker compose pull
docker compose up -d
docker compose logs --tail=100 mongo
Antes de crear administrador, los health checks pueden mostrar starting o unhealthy. Use localhost exception para inicializar:
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 es mongo:27017, resoluble en mongo-net. Clientes remotos necesitan nombres de miembro enrutables y SAN coincidentes: tunelizar solo bootstrap no hace accesible el nombre Docker anunciado. En diagnóstico de un miembro, directConnection=true permite elegirlo; para uso continuo, diseñe topología privada correcta.
La excepción localhost termina al crear el primer usuario. Inserte esta línea inmediatamente después del createUser del administrador y antes de las otras cuentas:
admin.auth(process.env.MONGO_ADMIN_USER, process.env.MONGO_ADMIN_PASSWORD);
Después ejecute:
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
Si se interrumpió tras crear administrador, autentíquese con él y cree solo las cuentas ausentes; no borre datos ni reinicialice. Las aplicaciones usan appUser, no mongoAdmin. El ejemplo combina backup/restore por comodidad; en producción deje solo backup y separe credenciales de recuperación.
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 y PRIMARY. Compruebe 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"}));
'
Verifique también denegación de administración y otras bases. Use:
mongodb://appUser:PASSWORD@mongo:27017/appdb?authSource=appdb&replicaSet=rs0&tls=true&tlsCAFile=/run/secrets/mongodb-ca.crt
Cambie PASSWORD con seguridad, no guarde URI reales en Git y 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
La imagen app es un marcador. Copie solo /opt/mongodb/tls/ca.crt al secret de aplicación. El nombre predeterminado del secret es mongodb_ca, pero la URI usa mongodb-ca.crt: configure target mongodb-ca.crt o cambie la ruta a /run/secrets/mongodb_ca. No entregue claves del servidor/Replica Set ni administrador.
--oplog captura escrituras y --oplogReplay las reproduce:
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
Es una copia de toda la instancia, no de una base filtrada. Mantenga ventana oplog superior al tiempo de copia y evite cambios concurrentes no admitidos. Compruebe salida y archivo legible.
/opt/mongodb/backups comparte el fallo del host. Cifre y suba archivos/digests a almacenamiento independiente con credenciales, retención, versionado, cifrado del proveedor y reglas de ciclo de vida. El checksum usa ruta absoluta del contenedor: ajústela al verificar fuera.
En grandes bases, mongodump consume CPU/I/O/red. Evalúe snapshots coherentes admitidos, Ops Manager/Cloud Manager o Atlas y efectos sobre Primary.
No pruebe --drop en producción. Prepare otro Replica Set compatible, archivo/CA y restoreUser con los privilegios necesarios:
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 requiere permisos adicionales al rol restore. Conceda a la cuenta del destino aislado el privilegio documentado anyAction sobre anyResource y retírelo después del ensayo. El dump completo puede restaurar usuarios/roles: conserve el administrador respaldado, sin asumir que sobrevive la cuenta temporal.
Revise bases, colecciones, documentos, índices, cuentas, lecturas/escrituras y replicación. mongodump no copia el host: respalde aparte .env, claves CA, configuración, supervisión y manual. Las fechas de archivo son ejemplos; sustituya el nombre real.
opcounters, latencia y consultas lentas.- Conexiones, capacidad y creación.
- Caché WiredTiger, dirty bytes, eviction y checkpoints.
- Page faults, RAM, swap y OOM.
- Datos, índices, journal/oplog y latencia I/O.
- Réplicas, lag, elecciones y fallos majority.
- Tiempo/tamaño de copia, subida y restauraciones.
Use Prometheus y Grafana. serverStatus y dbStats dan señales básicas:
db.serverStatus().connections
db.serverStatus().wiredTiger.cache
db.serverStatus().opcounters
db.getSiblingDB("appdb").stats(1024 * 1024)
rs.printReplicationInfo()
Corrija consultas/índices y limite resultados antes de ampliar caché o hardware. Los índices cuestan memoria, disco y escritura; valide con explain("executionStats").
Lea notas, copie externamente y pruebe recuperación:
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
Cambie el parche explícito antes: descargar la misma etiqueta no actualiza. Revise versión, Replica Set, aplicaciones, consultas y copias. Evite mongo:8 como cambio incontrolado; avance por rutas admitidas y espere a compatibilidad de nodos/drivers antes de elevar FCV.
Un nodo requiere parada. En conjuntos independientes, siga la secuencia secundaria/primaria 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}}'
Revise keyfile/server.pem, directorios, YAML, volumen, memoria y kernel con la guía de contenedores.
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 y directorio. No use chmod 777: se rechazan claves legibles por grupo/todos.
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 necesita DNS:mongo; 127.0.0.1 requiere IP SAN. Compruebe confianza y caducidad.
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())'
En un miembro, revise mongo:27017, red y volumen originales. En varios, DNS, reloj, claves, SAN, rutas y mayoría.
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})'
Compruebe mongo-net. Antes de considerar 0.0.0.0, establezca acceso privado/túnel y DNS/SAN. Consulte puertos y cortafuegos.
Revise docker inspect, dmesg, caché y agregaciones. Reducir cacheSizeGB no corrige $group sin límites, ordenaciones, resultados grandes o construcción de índices. Limite consultas y deje margen.
Desarrollo desde 2 vCPU/4GB; producción pequeña suele requerir 4 vCPU/8GB y NVMe. Mida conjunto de trabajo, consultas, caché y disco.
No: aporta oplog, transacciones y Change Streams. Hace falta separación de miembros de datos/votos, supervisión y copias.
Mantenga 127.0.0.1, Docker localmente y VPN/red privada/túnel remotamente con TLS y autorización.
Las etiquetas flotantes pueden cambiar compatibilidad. 8.0.32-noble histórico y su reemplazo son parches explícitos; actualice tras comprobar recuperación.
No: sirve para datos lógicos manejables. Conserve claves/configuración y copias externas; evalúe snapshots o herramientas admitidas para sistemas grandes.
Replicación da redundancia/failover; sharding distribuye capacidad entre shards, normalmente Replica Sets. No añada complejidad antes de necesitarla.