Tutoriales de VPS
PostgreSQL 18 en un VPS: Docker, TLS, PgBouncer y recuperación
Despliega PostgreSQL 18 con Docker, TLS/SCRAM y PgBouncer. Verifica permisos y volúmenes, ajusta conexiones y prueba copias y recuperación aislada.

Esta guía configura PostgreSQL en un VPS con Ubuntu 24.04, PostgreSQL 18, Compose, TLS/SCRAM y PgBouncer. Incluye acceso privado, usuarios, pool, recursos, copias, recuperación y migraciones. Un contenedor sano no demuestra recuperabilidad ni alta disponibilidad.
Revisión de versiones, 16 de noviembre de 2026: PostgreSQL 18.7 se publicó el 12 de noviembre. Los ejemplos originales conservan 18.6 como referencia; cambia cada postgres:18.6-bookworm, incluidas las consultas de propietario, por una etiqueta/digest 18.7 verificada antes de desplegar. PgBouncer 1.26.1 corrige CVE-2026-107350, que afecta de 1.17.0 a 1.26.0. El requisito original de 1.25.2 ya es insuficiente: usa 1.26.1 o una versión posterior soportada y corregida. Revisa las notas de PostgreSQL y el historial de PgBouncer.
PostgreSQL 18 salió en septiembre de 2025 con I/O asíncrono, UUIDv7, columnas generadas virtuales y checksums predeterminados en clústeres nuevos. Fija un parche 18.x soportado, sin latest.
- Aplicación/base comparten anfitrión o red privada y costes adecuados.
- Necesitas control de extensiones, ajustes y copias.
- Tu proyecto necesita SQL, transacciones, JSONB, búsqueda o extensiones geográficas compatibles.
- Puedes mantener actualizaciones, monitorización, recuperación e incidencias.
Una opción gestionada puede convenir para failover/PITR o poca capacidad operativa. Este host/disco/centro de datos sigue siendo un único punto de fallo.
| Uso | Referencia | Disco | Nota |
|---|---|---|---|
| Desarrollo/ligero | 2 vCPU, 4 GB | 60 GB NVMe | Conexiones conservadoras con aplicaciones compartidas |
| Producción pequeña | 4 vCPU, 8 GB | 120 GB NVMe+ | Pool y margen medido |
| Mayor carga | 8 vCPU, 16 GB+ | Almacenamiento dedicado | Considerar separar aplicación/base |
Reserva 2-3 veces el tamaño actual para WAL, índices, temporales, copias y migración. Usa fio sobre archivos de prueba prescindibles y mide IOPS sostenidas. Swap ayuda en emergencias, sin reemplazar RAM.
| Puerto | Función | Publicación |
|---|---|---|
5432/TCP | PostgreSQL | Solo 127.0.0.1 del host |
6432/TCP | PgBouncer | Solo 127.0.0.1 |
22/TCP | SSH | Claves y origen restringido |
Usa red privada o túnel verificado; no abras 5432 público. Aplicaciones en contenedores necesitan ruta Docker/privada real, no su loopback. Consulta exposición de bases.
Instala Docker/Compose soportados desde repositorio oficial:
sudo apt update
sudo apt full-upgrade -y
sudo apt install -y ca-certificates curl openssl jq
docker --version
docker compose version
Planifica actualizaciones/reinicio del host. Como administrador autorizado:
sudo install -d -m 0750 -o "$USER" -g "$USER" \
/opt/postgres18/{conf,initdb,secrets,tls,backups}
cd /opt/postgres18
umask 077
openssl rand -hex 32 > secrets/postgres_superuser_password
openssl rand -hex 32 > secrets/app_db_password
chmod 600 secrets/*
Protege secrets/, claves y copias fuera de Git. Root/administradores Docker siguen pudiendo leer secretos de archivo.
Distribuye ca.crt de forma segura y añade hostname privado real a SAN. Crea /opt/postgres18/tls/openssl.cnf:
[req]
distinguished_name = dn
prompt = no
req_extensions = server_ext
[dn]
CN = postgres
[server_ext]
subjectAltName = DNS:postgres,DNS:localhost,IP:127.0.0.1
keyUsage = critical,digitalSignature,keyEncipherment
extendedKeyUsage = serverAuth
cd /opt/postgres18/tls
openssl req -x509 -newkey rsa:4096 -sha256 -days 3650 -nodes \
-subj "/CN=PostgreSQL Internal CA" \
-keyout ca.key -out ca.crt
openssl req -newkey rsa:3072 -sha256 -nodes \
-config openssl.cnf -keyout server.key -out server.csr
openssl x509 -req -sha256 -days 825 \
-in server.csr -CA ca.crt -CAkey ca.key -CAcreateserial \
-extfile openssl.cnf -extensions server_ext \
-out server.crt
chmod 600 ca.key server.key
chmod 644 ca.crt server.crt
sudo chown 999:999 server.key server.crt
Conserva ca.key protegido para firma/renovación, sin montarlo en la base. Verifica UID/GID del postgres de la imagen, sin asumir siempre 999. server.key solo debe ser legible por el usuario adecuado.
Crea /opt/postgres18/conf/postgresql.conf:
listen_addresses = '*'
port = 5432
ssl = on
ssl_cert_file = '/run/postgres-tls/server.crt'
ssl_key_file = '/run/postgres-tls/server.key'
ssl_ca_file = '/run/postgres-tls/ca.crt'
ssl_min_protocol_version = 'TLSv1.2'
password_encryption = 'scram-sha-256'
shared_preload_libraries = 'pg_stat_statements'
max_connections = 100
shared_buffers = '2GB'
effective_cache_size = '5GB'
work_mem = '16MB'
maintenance_work_mem = '512MB'
checkpoint_timeout = '15min'
max_wal_size = '4GB'
min_wal_size = '1GB'
wal_compression = on
random_page_cost = 1.1
effective_io_concurrency = 200
track_io_timing = on
log_checkpoints = on
log_connections = on
log_disconnections = on
log_lock_waits = on
log_min_duration_statement = 1000
deadlock_timeout = '1s'
timezone = 'UTC'
Son referencias para host dedicado de 8 GB. shared_buffers cerca de 25% es un inicio; work_mem puede multiplicarse por nodos/workers/consultas. Con aplicaciones compartidas, reduce shared_buffers hacia 1 GB y mide memoria total, mantenimiento y límite de contenedor de 6 GB.
Crea /opt/postgres18/conf/pg_hba.conf:
local all postgres peer
local all all scram-sha-256
hostssl all all 0.0.0.0/0 scram-sha-256
hostssl all all ::0/0 scram-sha-256
hostnossl all all 0.0.0.0/0 reject
hostnossl all all ::0/0 reject
hostssl exige TLS TCP. CIDR amplios siguen necesitando publicación restringida y contenedores confiables; limita subredes al separar hosts. TLS/contraseña no autorizan cualquier origen.
Crea /opt/postgres18/initdb/01-app.sh:
#!/usr/bin/env bash
set -Eeuo pipefail
app_password="$(<"${APP_DB_PASSWORD_FILE}")"
psql -v ON_ERROR_STOP=1 \
--username "${POSTGRES_USER}" \
--dbname "${POSTGRES_DB}" \
--set=app_password="${app_password}" <<'EOSQL'
SELECT format('CREATE ROLE appuser LOGIN PASSWORD %L', :'app_password')
WHERE NOT EXISTS (SELECT 1 FROM pg_roles WHERE rolname = 'appuser')
\gexec
SELECT 'CREATE DATABASE app OWNER appuser'
WHERE NOT EXISTS (SELECT 1 FROM pg_database WHERE datname = 'app')
\gexec
REVOKE ALL ON DATABASE app FROM PUBLIC;
EOSQL
psql -v ON_ERROR_STOP=1 \
--username "${POSTGRES_USER}" \
--dbname app \
-c 'CREATE EXTENSION IF NOT EXISTS pg_stat_statements;'
chmod 700 /opt/postgres18/initdb/01-app.sh
Completa propietario antes de iniciar: un script 700 del usuario de despliegue no puede ejecutarlo postgres. Ese usuario también necesita leer el secreto de aplicación. Ajusta propietario al UID/GID real, permisos de recorrido de initdb y lectura de configuración sin secretos. Para Debian, adapta:
cd /opt/postgres18
pg18_uid=$(docker run --rm --entrypoint id postgres:18.6-bookworm -u postgres)
pg18_gid=$(docker run --rm --entrypoint id postgres:18.6-bookworm -g postgres)
sudo chown "$pg18_uid:$pg18_gid" initdb/01-app.sh secrets/app_db_password
sudo chmod 700 initdb/01-app.sh
sudo chmod 400 secrets/app_db_password
sudo chmod 755 initdb
sudo chmod 644 conf/postgresql.conf conf/pg_hba.conf
Tras cambiar propietario, el usuario de despliegue no puede leer el secreto con modo 400. Ejecuta los comandos posteriores que leen credenciales en una sesión root autorizada (sudo -i, después vuelve a /opt/postgres18) o adapta la lectura mediante sudo; no abras los permisos a todos. Inicialización solo actúa sobre clúster vacío; después usa ALTER ROLE y actualiza aplicación/pool, sin limitarte a cambiar archivos.
Crea /opt/postgres18/compose.yml:
name: postgres18
services:
postgres:
image: postgres:18.6-bookworm
environment:
POSTGRES_USER: postgres
POSTGRES_DB: postgres
POSTGRES_PASSWORD_FILE: /run/secrets/postgres_superuser_password
APP_DB_PASSWORD_FILE: /run/secrets/app_db_password
command:
- postgres
- -c
- config_file=/etc/postgresql/postgresql.conf
- -c
- hba_file=/etc/postgresql/pg_hba.conf
ports:
- "127.0.0.1:5432:5432"
volumes:
- postgres-data:/var/lib/postgresql
- ./conf/postgresql.conf:/etc/postgresql/postgresql.conf:ro
- ./conf/pg_hba.conf:/etc/postgresql/pg_hba.conf:ro
- ./initdb:/docker-entrypoint-initdb.d:ro
- ./tls/ca.crt:/run/postgres-tls/ca.crt:ro
- ./tls/server.crt:/run/postgres-tls/server.crt:ro
- ./tls/server.key:/run/postgres-tls/server.key:ro
secrets:
- postgres_superuser_password
- app_db_password
healthcheck:
test: ["CMD-SHELL", "pg_isready -U postgres -d postgres"]
interval: 10s
timeout: 5s
retries: 10
start_period: 30s
shm_size: 1gb
mem_limit: 6g
restart: unless-stopped
logging:
driver: json-file
options:
max-size: 20m
max-file: "5"
secrets:
postgres_superuser_password:
file: ./secrets/postgres_superuser_password
app_db_password:
file: ./secrets/app_db_password
volumes:
postgres-data:
Desde 18, PGDATA tiene subdirectorio versionado: monta /var/lib/postgresql. No copies mecánicamente /var/lib/postgresql/data ni borres un clúster aparentemente perdido. Consulta Compose.
cd /opt/postgres18
docker compose config --quiet
docker compose pull
docker compose up -d
docker compose ps
docker compose logs --tail=100 postgres
docker compose exec --user postgres postgres \
psql -U postgres -d postgres -c 'SELECT version();'
docker compose exec --user postgres postgres \
psql -U postgres -d postgres -c 'SHOW ssl; SHOW data_checksums; SHOW shared_preload_libraries;'
docker compose exec --user postgres postgres \
psql -U postgres -d app -c '\dx pg_stat_statements'
Verifica versión, TLS, checksums y extensión. Prueba usuario de aplicación:
sudo apt install -y postgresql-client
APP_DB_PASSWORD="$(<secrets/app_db_password)" \
PGPASSWORD="${APP_DB_PASSWORD}" \
psql "host=127.0.0.1 port=5432 dbname=app user=appuser sslmode=verify-full sslrootcert=/opt/postgres18/tls/ca.crt" \
-c 'SELECT current_user, current_database(), ssl FROM pg_stat_ssl WHERE pid = pg_backend_pid();'
ssl debe ser t. Evita secretos en historial y ejecuta unset APP_DB_PASSWORD PGPASSWORD. pg_isready no prueba permisos ni frescura de copias.
El pool reduce presión al llenar max_connections. Instala desde APT oficial PostgreSQL y comprueba que sea 1.26.1 o posterior con las correcciones necesarias. Detén la instalación si el repositorio solo ofrece la versión original vulnerable 1.25.2:
sudo apt install -y postgresql-common
sudo /usr/share/postgresql-common/pgdg/apt.postgresql.org.sh
sudo apt update
sudo apt install -y pgbouncer
pgbouncer --version
Crea /etc/pgbouncer/pgbouncer.ini:
[databases]
app = host=127.0.0.1 port=5432 dbname=app
[pgbouncer]
listen_addr = 127.0.0.1
listen_port = 6432
unix_socket_dir = /var/run/postgresql
auth_type = scram-sha-256
auth_file = /etc/pgbouncer/userlist.txt
pool_mode = transaction
max_client_conn = 300
default_pool_size = 20
min_pool_size = 5
reserve_pool_size = 5
reserve_pool_timeout = 3
max_prepared_statements = 200
server_tls_sslmode = verify-full
server_tls_ca_file = /etc/pgbouncer/ca.crt
admin_users = postgres
stats_users = postgres
ignore_startup_parameters = extra_float_digits
log_connections = 1
log_disconnections = 1
El archivo protegido de contraseñas permite SCRAM hacia backend:
cd /opt/postgres18
APP_DB_PASSWORD="$(<secrets/app_db_password)"
printf '"appuser" "%s"\n' "${APP_DB_PASSWORD}" > secrets/pgbouncer-userlist.txt
unset APP_DB_PASSWORD
sudo install -m 0640 -o postgres -g postgres \
secrets/pgbouncer-userlist.txt /etc/pgbouncer/userlist.txt
sudo install -m 0644 -o root -g root \
tls/ca.crt /etc/pgbouncer/ca.crt
sudo systemctl restart pgbouncer
sudo systemctl enable pgbouncer
sudo systemctl status --no-pager pgbouncer
Protege el archivo. admin_users/stats_users no crean una cuenta autenticada: añade usuario de control dedicado al auth_file y listas si necesitas consola, sin dar sus credenciales a aplicaciones.
Conecta a 127.0.0.1:6432/app mediante ruta privada. transaction puede afectar estado de sesión, temporales o SET entre transacciones; usa session cuando sea necesario. Prepared statements depende de versión/configuración. Comprueba descriptores al subir max_client_conn.
APP_DB_PASSWORD="$(</opt/postgres18/secrets/app_db_password)" \
PGPASSWORD="${APP_DB_PASSWORD}" \
psql -h 127.0.0.1 -p 6432 -U appuser -d app \
-c 'SELECT current_user, now();'
unset APP_DB_PASSWORD PGPASSWORD
El TLS configurado es al backend; el cliente-pool local no tiene TLS aquí. Configúralo antes de conexión entre hosts.
Usa pg_dump diario y roles/configuración; mayor carga puede necesitar pg_basebackup, WAL y PITR. No copies volumen activo como backup consistente.
cd /opt/postgres18
backup_time="$(date -u +%Y%m%dT%H%M%SZ)"
docker compose exec -T --user postgres postgres \
pg_dump -U postgres -d app -Fc \
> "backups/app-${backup_time}.dump"
docker compose exec -T --user postgres postgres \
pg_dumpall -U postgres --globals-only \
> "backups/globals-${backup_time}.sql"
sha256sum "backups/app-${backup_time}.dump" \
"backups/globals-${backup_time}.sql" \
> "backups/SHA256SUMS-${backup_time}"
Verifica cada salida antes de aceptar archivos/hashes. Protege hashes de contraseñas de roles. Conserva copia local breve, externa regional e independiente/offline, con permisos de almacenamiento mínimos, versiones/bloqueo y descargas probadas. Dumps diarios no dan recuperación continua.
Ejecuta solo después de cambiar a instancia/proyecto separado y compatible. Restaura roles/extensiones necesarios desde globals revisados; confirma archivo y hashes. No ejecutes el dropdb final hasta probar datos de negocio:
cd /opt/postgres18
latest_dump="$(find backups -name 'app-*.dump' -type f -print | sort | tail -1)"
docker compose exec -T --user postgres postgres \
createdb -U postgres -O appuser app_restore_test
docker compose exec -T --user postgres postgres \
pg_restore -U postgres -d app_restore_test \
--clean --if-exists < "${latest_dump}"
docker compose exec --user postgres postgres \
psql -U postgres -d app_restore_test \
-c "SELECT count(*) FROM pg_tables WHERE schemaname NOT IN ('pg_catalog', 'information_schema');"
docker compose exec -T --user postgres postgres \
dropdb -U postgres app_restore_test
Verifica filas exactas, extensiones, secuencias, permisos y conexión real. Registra tiempo y punto de recuperación, sin afectar producción.
Vigila CPU, RAM/swap, espacio/latencia, conexiones, transacciones, bloqueos, WAL/réplicas y edad de copias:
SELECT state, count(*)
FROM pg_stat_activity
GROUP BY state
ORDER BY count(*) DESC;
SELECT query, calls, total_exec_time, mean_exec_time, rows
FROM pg_stat_statements
ORDER BY total_exec_time DESC
LIMIT 20;
Corrige fugas/transacciones inactivas y prueba pool antes de subir max_connections de 100 a 1000. EXPLAIN (ANALYZE, BUFFERS) ejecuta consultas: úsalo con cuidado. Mejora índices/SQL sin atribuir todo a shared_buffers.
18.x normalmente no necesita pg_upgrade. Cambia tag/digest deliberadamente y copia/prueba antes de:
cd /opt/postgres18
: "先完成备份和恢复抽查"
docker compose pull postgres
docker compose up -d postgres
docker compose exec --user postgres postgres \
psql -U postgres -d postgres -c 'SELECT version();'
18 a 19 requiere pg_upgrade o migración lógica probada. El directorio versionado PGDATA no migra automáticamente.
Comprueba propietario de server.key, adaptando 999 si cambia:
sudo chown 999:999 /opt/postgres18/tls/server.key
sudo chmod 600 /opt/postgres18/tls/server.key
docker compose restart postgres
Detén escrituras, revisa volúmenes/proyecto y /var/lib/postgresql. Conserva originales e inspecciona copia de lectura antes de inicializar.
Revisa pg_stat_activity y SHOW POOLS; con cuenta autorizada. Corrige ciclo de conexiones antes de subir default_pool_size o max_connections.
Comprueba SAN, sslrootcert, CA y reloj. Repara errores de verify-full, sin usar sslmode=disable.
Está limitado a 127.0.0.1. Este túnel apunta a PgBouncer 6432:
ssh -N -L 15432:127.0.0.1:6432 user@your-vps
Usa 127.0.0.1:15432 local y TLS adecuado al listener del pool. Consulta conexión.
- Parche 18.x exacto soportado, sin
latest. - Volumen en
/var/lib/postgresqlcorrecto. - 5432/6432 en loopback o privado restringido.
- PostgreSQL TCP TLS/SCRAM, aplicación sin superusuario.
- PgBouncer parcheado y modo compatible.
- Memoria/conexiones medidas.
- Copias externas con restauración aislada registrada.
- Parches/migraciones con mantenimiento y recuperación.
- Alertas de disco, conexiones, consultas, bloqueos, WAL y copias.
Prueba carga real y reinicio/recuperación controlados antes de usar datos productivos.