Tutoriales de VPS
Odoo 19 en un VPS: Docker privado, HTTPS y recuperación
Despliega Odoo 19 Community con PostgreSQL privado, Caddy y WebSocket. Corrige permisos, sustituye credenciales y copia base y filestore en la misma ventana.

Odoo reúne CRM, ventas, compras, inventario, proyectos y webs; contabilidad y funciones avanzadas dependen de edición/módulos. Alojar Community 19 permite controlar módulos y versiones, pero exige operar PostgreSQL, HTTPS, correo, seguridad y recuperación.
Este diseño de una VPS mantiene puertos internos, limita gestión de bases y copia base/filestore conjuntamente. No ofrece alta disponibilidad.
| Opción | Ventaja | Coste/límite | Uso |
|---|---|---|---|
| Online | Poco mantenimiento | Personalización/control restringidos | Funciones estándar |
| Odoo.sh | Pruebas y upgrades gestionados | Suscripción/licencias | Enterprise y personalización |
| Community en VPS | Control de datos/módulos/releases | Operación propia | Equipo con experiencia Linux |
Community no incluye Enterprise automáticamente; módulos terceros pueden requerir licencia. Revisa módulos, usuarios, correo, requisitos locales y parada tolerable antes de comparar cuotas.
| Uso | Referencia | Condición |
|---|---|---|
| Prueba o 1-3 usuarios | 2 vCPU, 4 GB, 50 GB NVMe | Evitar datos productivos importantes |
| 5-15 usuarios | 4 vCPU, 8 GB, 100 GB NVMe | Pocos workers/base/proxy |
| 20-50 o muchos reportes | 8 vCPU, 16 GB, 200 GB+ | Medir y evaluar separar base |
| Muchos adjuntos/imágenes | Cómputo y almacenamiento/copia aparte | Contar IOPS y recuperación |
Son estimaciones. Mide CPU/disco reales y reserva /var/lib/odoo, imágenes, logs y copias además de base. Más CPU no arregla latencia de escritura.
- Ubuntu 24.04.
- Dominio correcto como
erp.example.com. - Docker/Compose v2 soportados.
- TCP 80/443 públicos y SSH restringido.
- Contraseñas distintas para inicializador, aplicación y master Odoo.
docker --version
docker compose version
free -h
df -h
sudo ss -lntup | grep -E ':(80|443|8069|8072|5432)\b' || true
Deja 8069/8072/5432 privados; entra por HTTPS.
sudo mkdir -p /opt/odoo19/{config,addons,postgres-init,backups}
sudo chown -R "$USER":"$USER" /opt/odoo19
cd /opt/odoo19
umask 077
Crea .env:
POSTGRES_DB=odoo
POSTGRES_USER=odoo_db_owner
POSTGRES_PASSWORD=替换为数据库所有者强密码
ODOO_DB_USER=odoo_app
ODOO_DB_PASSWORD=替换为不同的应用数据库强密码
Reemplaza cada contraseña por valor aleatorio distinto. Hex evita ambigüedad shell/Compose; el archivo luego se ejecuta como configuración Bash, así que revísalo y protégelo.
chmod 600 .env
odoo_app no es superusuario ni tiene CREATEDB.
Crea postgres-init/01-odoo-role.sh:
#!/bin/sh
set -eu
psql -v ON_ERROR_STOP=1 \
--username "$POSTGRES_USER" \
--dbname "$POSTGRES_DB" \
--set=odoo_password="$ODOO_DB_PASSWORD" <<'SQL'
CREATE ROLE odoo_app
LOGIN
PASSWORD :'odoo_password'
NOSUPERUSER
NOCREATEDB
NOCREATEROLE;
GRANT CONNECT ON DATABASE odoo TO odoo_app;
GRANT USAGE, CREATE ON SCHEMA public TO odoo_app;
SQL
chmod 700 postgres-init/01-odoo-role.sh
Solo actúa en clúster vacío. Corrige propietario antes de arrancar: script 700 del usuario de despliegue no lo ejecuta postgres. Consulta UID/GID de la imagen, asigna script y permite recorrido del directorio. Instala extensiones necesarias como unaccent/pg_trgm con dueño autorizado durante inicialización: el rol de ejemplo solo tiene CONNECT/permisos public. Verifica módulos sin conceder superusuario indiscriminado.
No borres volumen productivo para repetirlo.
Crea config/odoo.conf:
[options]
admin_passwd = 替换为独立的Odoo主密码
db_host = db
db_port = 5432
db_name = odoo
dbfilter = ^odoo$
list_db = False
proxy_mode = True
workers = 3
max_cron_threads = 1
gevent_port = 8072
limit_time_cpu = 600
limit_time_real = 1200
limit_memory_soft = 1610612736
limit_memory_hard = 2147483648
addons_path = /usr/lib/python3/dist-packages/odoo/addons,/mnt/extra-addons
data_dir = /var/lib/odoo
admin_passwd es master de gestión, distinto del login. list_db=False y db_name/dbfilter limitan selección. proxy_mode=True solo detrás de proxy confiable.
Tres workers es referencia para 4 vCPU/8 GB; límites por worker se multiplican, más cron/base/host. Mide o reduce workers.
chmod 600 config/odoo.conf
mkdir -p addons
Imagen oficial ejecuta como odoo. Config 600 de otro propietario no es legible: asígnalo al UID/GID real, conserva 600 y directorios transitables/módulos legibles. No supongas un UID universal ni abras secretos.
Prueba addons de terceros con compatibilidad Odoo 19 y dependencias: ejecutan código en ERP.
Crea compose.yaml:
name: odoo19
services:
db:
image: postgres:16
restart: unless-stopped
environment:
POSTGRES_DB: ${POSTGRES_DB}
POSTGRES_USER: ${POSTGRES_USER}
POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
ODOO_DB_PASSWORD: ${ODOO_DB_PASSWORD}
volumes:
- postgres-data:/var/lib/postgresql/data
- ./postgres-init:/docker-entrypoint-initdb.d:ro
healthcheck:
test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER} -d ${POSTGRES_DB}"]
interval: 10s
timeout: 5s
retries: 10
networks:
- backend
odoo:
image: odoo:19.0-20260908
restart: unless-stopped
depends_on:
db:
condition: service_healthy
environment:
HOST: db
PORT: 5432
USER: ${ODOO_DB_USER}
PASSWORD: ${ODOO_DB_PASSWORD}
command: ["odoo", "-c", "/etc/odoo/odoo.conf"]
volumes:
- odoo-data:/var/lib/odoo
- ./config:/etc/odoo:ro
- ./addons:/mnt/extra-addons
expose:
- "8069"
- "8072"
networks:
- frontend
- backend
caddy:
image: caddy:2.10-alpine
restart: unless-stopped
depends_on:
- odoo
ports:
- "80:80"
- "443:443"
- "443:443/udp"
volumes:
- ./Caddyfile:/etc/caddy/Caddyfile:ro
- caddy-data:/data
- caddy-config:/config
networks:
- frontend
networks:
frontend:
backend:
internal: true
volumes:
postgres-data:
odoo-data:
caddy-data:
caddy-config:
El ejemplo conserva 19.0-20260908. El 16 de noviembre de 2026, la lista oficial ofrece 19.0-20261112: cambia a tag/digest 19 revisado y parches compatibles PostgreSQL 16/Caddy antes de desplegar. latest ahora sigue Odoo 20; no lo uses para actualizar 19.
Base no tiene ports; solo redes previstas acceden a Odoo. Completa permisos antes de inicializar.
docker compose config > /tmp/odoo19-compose.resolved.yaml
grep -nE 'image:|POSTGRES_DB:|POSTGRES_USER:|HOST:|USER:' \
/tmp/odoo19-compose.resolved.yaml
El archivo resuelto contiene contraseñas: limita permisos, elimina copia diagnóstica al terminar y no compartas.
Crea Caddyfile:
erp.example.com {
encode zstd gzip
@websocket path /websocket /websocket/*
reverse_proxy @websocket odoo:8072
reverse_proxy odoo:8069
header {
Strict-Transport-Security "max-age=31536000; includeSubDomains"
X-Content-Type-Options "nosniff"
Referrer-Policy "strict-origin-when-cross-origin"
}
log {
output file /data/access.log {
roll_size 50MiB
roll_keep 5
}
}
}
HTTPS y proxy_mode correctos son necesarios. /websocket/ usa gevent: proxy solo 8069 no basta. Verifica DNS/80/443, conserva estado Caddy y HSTS solo con subdominios HTTPS.
docker compose pull
docker compose up -d db
docker compose ps
docker compose logs --tail=100 db
Tras readiness:
docker compose run --rm odoo \
odoo -c /etc/odoo/odoo.conf \
-d odoo -i base --without-demo=all --stop-after-init
Cambia administrador inmediatamente:
read -rsp "新的 Odoo 管理员密码: " ODOO_ADMIN_PASSWORD; echo
docker compose run --rm -T \
-e ODOO_ADMIN_PASSWORD="$ODOO_ADMIN_PASSWORD" \
odoo odoo shell -c /etc/odoo/odoo.conf -d odoo <<'PY'
import os
admin = env.ref('base.user_admin')
admin.write({
'login': '[email protected]',
'password': os.environ['ODOO_ADMIN_PASSWORD'],
})
env.cr.commit()
PY
unset ODOO_ADMIN_PASSWORD
Elige login [email protected] deliberado, sin defaults:
docker compose up -d
docker compose ps
docker compose logs --tail=100 odoo caddy
En https://erp.example.com, configura empresa, huso y correo. Instala módulos necesarios: cambian esquema/tareas/recursos.
sudo ufw allow OpenSSH
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw allow 443/udp
sudo ufw enable
sudo ufw status verbose
Antes de UFW permite tu SSH real/origen. Revisa también publicación Docker, que UFW solo no controla completamente.
curl -I https://erp.example.com
curl -I https://erp.example.com/web/database/manager
Debe funcionar login, sin creación/borrado/copia pública de bases. Verifica list_db=False, db_name, dbfilter y configuración cargada. No compartas master.
Invitaciones, resets, presupuestos y avisos necesitan envío real. Salida 25, reputación/PTR complican correo propio. Proveedor SMTP con 587/STARTTLS o 465/TLS suele simplificar.
Configura servidor saliente en ajustes técnicos; verifica inbox/spam/rebotes, no solo conexión. SPF/DKIM/DMARC corresponden al remitente/proveedor real.
Registros PostgreSQL y archivos /var/lib/odoo/filestore/ deben corresponder. Copiar uno solo pierde relaciones o adjuntos.
Esquema con parada de escrituras:
cd /opt/odoo19
set -a
. ./.env
set +a
STAMP=$(date +%Y%m%d-%H%M%S)
BACKUP_DIR="$PWD/backups/$STAMP"
mkdir -p "$BACKUP_DIR"
docker compose stop odoo
docker compose exec -T db \
pg_dump -U "$POSTGRES_USER" -d "$POSTGRES_DB" -Fc \
> "$BACKUP_DIR/odoo.dump"
docker run --rm \
-v odoo19_odoo-data:/source:ro \
-v "$BACKUP_DIR":/backup \
alpine:3.22 \
tar -czf /backup/odoo-data.tar.gz -C /source .
tar -czf "$BACKUP_DIR/odoo-config.tar.gz" \
compose.yaml Caddyfile config addons postgres-init
sha256sum "$BACKUP_DIR"/* > "$BACKUP_DIR/SHA256SUMS"
docker compose start odoo
Activa errores estrictos, directorio único y verifica volumen real, sin asumir prefijo. Incluye .env protegido: el tar del ejemplo no lo guarda. Comprueba dump, archivos y hashes antes de aceptar copia/reiniciar.
Retén copia externa; cifra .env/admin_passwd. Consulta recuperación.
pg_restore --listlee dump.- Base/filestore pertenecen a la misma ventana sin escritura.
- Login, adjuntos, imágenes, plantillas y módulos funcionan en aislamiento.
- Código de módulos coincide.
- Tiempo cumple RTO.
Ensaya al menos trimestralmente, sin envío/pagos/integraciones reales.
- En 19.0 prueba parches de errores/seguridad sobre copia restaurada.
- De 18 a 19 migra base/módulos; no basta cambiar tag.
docker compose pull odoo
docker compose up -d odoo
docker compose logs -f --tail=200 odoo
Tag/digest fijo exige modificación explícita; pull no cambia fecha. Guarda imagen/copia previa y prueba migraciones, módulos y corte. Evita reemplazo mayor desatendido.
- Memoria/swap, disco/inodes/latencia.
- Conexiones, consultas lentas, tamaño y backups.
- Reinicios, 5xx, latencia y cron fallido.
- Certificados y tráfico anormal.
- HTTPS/login y entrega de correo.
Revisa docker compose ps/docker compose logs --tail=200 odoo db. Usa diagnóstico de disco sin borrar volúmenes.
docker compose ps
docker compose logs --tail=200 db odoo
docker compose exec db pg_isready -U odoo_db_owner -d odoo
docker compose exec db psql -U odoo_db_owner -d odoo -c '\du'
Confirma odoo_app, credenciales, salud y DNS interno. No abras 5432; consulta base.
docker compose logs --tail=200 caddy odoo
docker compose exec caddy wget -S -O- http://odoo:8069/web/login
docker stats --no-stream
Separa startup/migración, OOM y proxy. Aumenta RAM/reduce workers para OOM; reinicios repetidos no arreglan capacidad. Consulta proxy.
Verifica HTTPS coherente, proxy_mode=True, hora, cookies y headers en cada proxy.
Comprueba /websocket hacia 8072 y logs:
docker compose exec caddy caddy validate --config /etc/caddy/Caddyfile
docker compose exec caddy caddy reload --config /etc/caddy/Caddyfile
Restaura base/filestore previos en pruebas y verifica versión/Python/migración. Borrar carpeta no corrige estado de instalación en base.
- Solo SSH/80/443 previstos públicos; 5432/8069/8072 privados.
- Rol de aplicación sin superusuario/CREATEDB.
list_db=False,db_nameydbfiltercomprobados.- Login predeterminado y
admin_passwdreemplazados por separado. - HTTPS/WebSocket/SMTP/reset probados.
- Base/filestore/config/addons con copia externa consistente.
- Restauración aislada documentada.
- Tags/digests y reversión compatible probados.
- Alertas disco/5xx/reinicios/backups.
docker compose up -d inicia contenedores; operación fiable requiere coordinar datos, archivos, correo y upgrades. Mide workers/reportes. Si no puedes mantener copias/incidentes, considera soporte gestionado, sin comparar solo alquiler VPS.