Tutoriais de VPS
Odoo 19 na VPS: Docker privado, HTTPS e recuperação
Implante Odoo 19 Community com PostgreSQL privado, Caddy e WebSocket. Corrija permissões, troque credenciais e copie banco e filestore na mesma janela.

Odoo reúne CRM, vendas, compras, estoque, projetos e sites; contabilidade e funções avançadas dependem da edição/módulos. Hospedar Community 19 permite controlar módulos e versões, mas exige operar PostgreSQL, HTTPS, e-mail, segurança e recuperação.
Este desenho de uma VPS mantém portas internas, limita gestão de bancos e copia banco/filestore juntos. Não oferece alta disponibilidade.
| Opção | Vantagem | Custo/limite | Uso |
|---|---|---|---|
| Online | Pouca manutenção | Personalização/controle restritos | Funções padrão |
| Odoo.sh | Testes e upgrades gerenciados | Assinatura/licenças | Enterprise e personalização |
| Community na VPS | Controle de dados/módulos/releases | Operação própria | Equipe com experiência Linux |
Community não inclui Enterprise automaticamente; módulos externos podem exigir licença. Revise módulos, usuários, e-mail, requisitos locais e parada tolerável antes de comparar mensalidades.
| Uso | Referência | Condição |
|---|---|---|
| Teste ou 1-3 usuários | 2 vCPU, 4 GB, 50 GB NVMe | Evitar dados produtivos importantes |
| 5-15 usuários | 4 vCPU, 8 GB, 100 GB NVMe | Poucos workers/banco/proxy |
| 20-50 ou muitos relatórios | 8 vCPU, 16 GB, 200 GB+ | Medir e avaliar separar banco |
| Muitos anexos/imagens | Computação e armazenamento/backup separados | Contar IOPS e recuperação |
São estimativas. Meça CPU/disco reais e reserve /var/lib/odoo, imagens, logs e backups além do banco. Mais CPU não corrige latência de escrita.
- Ubuntu 24.04.
- Domínio correto como
erp.example.com. - Docker/Compose v2 suportados.
- TCP 80/443 públicas e SSH restrito.
- Senhas distintas para inicializador, aplicação e master Odoo.
docker --version
docker compose version
free -h
df -h
sudo ss -lntup | grep -E ':(80|443|8069|8072|5432)\b' || true
Deixe 8069/8072/5432 privadas; entre por HTTPS.
sudo mkdir -p /opt/odoo19/{config,addons,postgres-init,backups}
sudo chown -R "$USER":"$USER" /opt/odoo19
cd /opt/odoo19
umask 077
Crie .env:
POSTGRES_DB=odoo
POSTGRES_USER=odoo_db_owner
POSTGRES_PASSWORD=替换为数据库所有者强密码
ODOO_DB_USER=odoo_app
ODOO_DB_PASSWORD=替换为不同的应用数据库强密码
Troque cada senha por valor aleatório distinto. Hex evita ambiguidade shell/Compose; o arquivo depois é executado como configuração Bash, então revise e proteja.
chmod 600 .env
odoo_app não é superusuário nem tem CREATEDB.
Crie 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
Só atua em cluster vazio. Corrija proprietário antes de iniciar: script 700 do usuário de deploy não executa como postgres. Consulte UID/GID da imagem, atribua script e permita travessia do diretório. Instale extensões necessárias como unaccent/pg_trgm com dono autorizado na inicialização: o papel do exemplo só tem CONNECT/permissões public. Verifique módulos sem conceder superusuário indiscriminado.
Não apague volume produtivo para repetir.
Crie 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 é master de gestão, separado do login. list_db=False e db_name/dbfilter limitam seleção. proxy_mode=True só atrás de proxy confiável.
Três workers é referência para 4 vCPU/8 GB; limites por worker multiplicam, além de cron/banco/host. Meça ou reduza workers.
chmod 600 config/odoo.conf
mkdir -p addons
Imagem oficial executa como odoo. Config 600 de outro proprietário não é legível: atribua ao UID/GID real, preserve 600 e diretórios transitáveis/módulos legíveis. Não presuma UID universal nem abra segredos.
Teste addons externos com compatibilidade Odoo 19 e dependências: executam código no ERP.
Crie 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:
O exemplo mantém 19.0-20260908. Em 16 de novembro de 2026, a lista oficial oferece 19.0-20261112: troque por tag/digest 19 revisado e patches compatíveis PostgreSQL 16/Caddy antes do deploy. latest agora acompanha Odoo 20; não use para atualizar 19.
Banco não tem ports; só redes previstas acessam Odoo. Complete permissões 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
O arquivo resolvido contém senhas: limite permissões, remova cópia diagnóstica ao terminar e não compartilhe.
Crie 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 e proxy_mode corretos são necessários. /websocket/ usa gevent: proxy só 8069 não basta. Confira DNS/80/443, preserve estado Caddy e HSTS só com subdomínios HTTPS.
docker compose pull
docker compose up -d db
docker compose ps
docker compose logs --tail=100 db
Depois da prontidão:
docker compose run --rm odoo \
odoo -c /etc/odoo/odoo.conf \
-d odoo -i base --without-demo=all --stop-after-init
Troque administrador imediatamente:
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
Escolha login [email protected] deliberado, sem padrões:
docker compose up -d
docker compose ps
docker compose logs --tail=100 odoo caddy
Em https://erp.example.com, configure empresa, fuso e e-mail. Instale módulos necessários: alteram esquema/tarefas/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, permita SSH real/origem. Confira publicação Docker, que UFW sozinho não controla completamente.
curl -I https://erp.example.com
curl -I https://erp.example.com/web/database/manager
Login deve funcionar, sem criação/exclusão/cópia pública de bancos. Valide list_db=False, db_name, dbfilter e configuração carregada. Não compartilhe master.
Convites, resets, propostas e avisos precisam de envio real. Saída 25, reputação/PTR complicam e-mail próprio. Provedor SMTP com 587/STARTTLS ou 465/TLS costuma simplificar.
Configure servidor de saída nos ajustes técnicos; confira inbox/spam/devoluções, não só conexão. SPF/DKIM/DMARC atendem remetente/provedor real.
Registros PostgreSQL e arquivos /var/lib/odoo/filestore/ precisam corresponder. Copiar só um perde relações ou anexos.
Esboço com parada de escritas:
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
Ative erros estritos, diretório único e confira volume real, sem presumir prefixo. Inclua .env protegido: o tar do exemplo não salva. Confira dump, arquivos e hashes antes de aceitar backup/reiniciar.
Preserve cópia externa; criptografe .env/admin_passwd. Veja recuperação.
pg_restore --listlê dump.- Banco/filestore pertencem à mesma janela sem escrita.
- Login, anexos, imagens, templates e módulos funcionam isolados.
- Código dos módulos corresponde.
- Tempo atende RTO.
Teste pelo menos trimestralmente, sem envio/pagamentos/integrações reais.
- Em 19.0, teste patches de bugs/segurança numa cópia restaurada.
- De 18 para 19, migre banco/módulos; trocar tag não basta.
docker compose pull odoo
docker compose up -d odoo
docker compose logs -f --tail=200 odoo
Tag/digest fixado exige mudança explícita; pull não altera data. Preserve imagem/backup anterior e teste migrações, módulos e corte. Evite troca de versão maior sem acompanhamento.
- Memória/swap, disco/inodes/latência.
- Conexões, consultas lentas, tamanho e backups.
- Reinícios, 5xx, latência e cron com falha.
- Certificados e tráfego anormal.
- HTTPS/login e entrega de e-mail.
Confira docker compose ps/docker compose logs --tail=200 odoo db. Use diagnóstico de disco sem apagar volumes.
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'
Confirme odoo_app, credenciais, saúde e DNS interno. Não abra 5432; veja banco.
docker compose logs --tail=200 caddy odoo
docker compose exec caddy wget -S -O- http://odoo:8069/web/login
docker stats --no-stream
Separe startup/migração, OOM e proxy. Aumente RAM/reduza workers para OOM; reinícios repetidos não corrigem capacidade. Veja proxy.
Confira HTTPS coerente, proxy_mode=True, hora, cookies e headers de cada proxy.
Confira /websocket para 8072 e logs:
docker compose exec caddy caddy validate --config /etc/caddy/Caddyfile
docker compose exec caddy caddy reload --config /etc/caddy/Caddyfile
Restaure banco/filestore anteriores em testes e confira versão/Python/migração. Apagar pasta não corrige estado de instalação no banco.
- Só SSH/80/443 previstas públicas; 5432/8069/8072 privadas.
- Papel da aplicação sem superusuário/CREATEDB.
list_db=False,db_nameedbfiltervalidados.- Login padrão e
admin_passwdtrocados separadamente. - HTTPS/WebSocket/SMTP/reset testados.
- Banco/filestore/config/addons com backup externo consistente.
- Restauração isolada documentada.
- Tags/digests e reversão compatível testados.
- Alertas disco/5xx/reinícios/backups.
docker compose up -d inicia contêineres; operação confiável exige coordenar dados, arquivos, e-mail e upgrades. Meça workers/relatórios. Se não consegue manter backups/incidentes, considere suporte gerenciado, sem comparar apenas aluguel da VPS.