← 返回知识库

Odoo 19 安装部署指南 — 2026最新版

2026年Odoo 19部署全攻略:Ubuntu 24.04手动安装、Docker Compose一键部署(含Redis)、Nginx+SSL反向代理、PostgreSQL 16调优、自动备份。

Odoo 19 安装部署指南(2026最新版)

Odoo 19基于 Python 3.12 构建,推荐 Ubuntu 24.04 LTS(自带Python 3.12和PostgreSQL 16)。本文提供三种方案:传统手动安装、Docker Compose一键部署、生产环境最佳实践。

系统要求

组件最低配置推荐配置(生产)
CPU2核4核+
内存2 GB4-8 GB
磁盘20 GB SSD50 GB+ SSD
操作系统Ubuntu 22.04/24.04 LTSUbuntu 24.04 LTS
Python3.10+3.12(24.04默认)
PostgreSQL13+15/16(24.04默认16)

方案一:传统手动安装(Ubuntu 24.04)

1. 更新系统

sudo apt update && sudo apt upgrade -y
sudo timedatectl set-timezone Asia/Shanghai

2. 创建系统用户

sudo useradd -m -d /opt/odoo19 -U -r -s /bin/bash odoo19

3. 安装PostgreSQL 16

sudo apt install -y postgresql postgresql-contrib
sudo systemctl enable postgresql
sudo -u postgres createuser -s odoo19

4. 安装Node.js(前端资源编译)

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs
sudo npm install -g rtlcss

5. 安装系统依赖

sudo apt install -y git python3-pip python3-dev python3-venv \
  build-essential wget libxslt1-dev libzip-dev libldap2-dev \
  libsasl2-dev libssl-dev libjpeg-dev libpq-dev \
  libxml2-dev zlib1g-dev libffi-dev libfreetype6-dev \
  libtiff5-dev libjpeg8-dev libopenjp2-7-dev \
  liblcms2-dev libwebp-dev libharfbuzz-dev libfribidi-dev libxcb1-dev

6. 安装wkhtmltopdf(PDF报表)

wget https://github.com/wkhtmltopdf/packaging/releases/download/0.12.6.1-3/wkhtmltox_0.12.6.1-3.jammy_amd64.deb
sudo apt install -y xfonts-75dpi xfonts-base
sudo apt install -y ./wkhtmltox_0.12.6.1-3.jammy_amd64.deb

注意:Ubuntu官方源的wkhtmltopdf已过时,会导致PDF生成失败,必须使用GitHub的0.12.6+

7. 克隆Odoo 19源码

sudo git clone https://www.github.com/odoo/odoo --depth 1 --branch 19.0 /opt/odoo19/odoo

8. 创建Python虚拟环境

sudo su - odoo19 -s /bin/bash
python3 -m venv /opt/odoo19/odoo-venv
source /opt/odoo19/odoo-venv/bin/activate
pip install --upgrade pip wheel
pip install -r /opt/odoo19/odoo/requirements.txt
deactivate
exit
sudo mkdir /opt/odoo19/odoo-custom-addons
sudo chown odoo19:odoo19 /opt/odoo19/odoo-custom-addons

9. 配置文件 /etc/odoo19.conf

[options]
admin_passwd = YOUR_STRONG_MASTER_PASSWORD
db_host = False
db_port = False
db_user = odoo19
db_password = False
addons_path = /opt/odoo19/odoo/addons,/opt/odoo19/odoo-custom-addons
http_port = 8069
logfile = /var/log/odoo/odoo19.log
proxy_mode = True
sudo mkdir -p /var/log/odoo
sudo chown -R odoo19:odoo19 /var/log/odoo /etc/odoo19.conf
sudo chmod 640 /etc/odoo19.conf

10. 创建Systemd服务

[Unit]
Description=Odoo 19
Requires=postgresql.service
After=network.target postgresql.service
[Service]
Type=simple
SyslogIdentifier=odoo19
User=odoo19
Group=odoo19
ExecStart=/opt/odoo19/odoo-venv/bin/python3 /opt/odoo19/odoo/odoo-bin -c /etc/odoo19.conf
StandardOutput=journal+console
[Install]
WantedBy=multi-user.target
sudo systemctl daemon-reload
sudo systemctl enable --now odoo19
sudo systemctl status odoo19

11. Nginx反向代理 + SSL

sudo apt install -y nginx certbot python3-certbot-nginx

配置 Nginx(/etc/nginx/sites-available/odoo19):

upstream odoo { server 127.0.0.1:8069; }
upstream odoochat { server 127.0.0.1:8072; }
server {
    listen 80;
    server_name your-domain.com;
    proxy_read_timeout 720s;
    proxy_set_header X-Forwarded-Host $host;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    location /websocket {
        proxy_pass http://odoochat;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
    location / { proxy_pass http://odoo; }
    location ~* /web/static/ {
        proxy_cache_valid 200 90m;
        expires 864000;
        proxy_pass http://odoo;
    }
}
sudo ln -s /etc/nginx/sites-available/odoo19 /etc/nginx/sites-enabled/
sudo nginx -t && sudo systemctl restart nginx
sudo certbot --nginx -d your-domain.com

方案二:Docker Compose 一键部署

Odoo 19官方镜像 odoo:19.0,推荐搭配PostgreSQL 16和Redis。

docker-compose.yml

services:
  db:
    image: postgres:16
    environment:
      POSTGRES_DB: postgres
      POSTGRES_USER: odoo
      POSTGRES_PASSWORD: your_secure_password
    volumes:
      - postgres_data:/var/lib/postgresql/data
    restart: unless-stopped
  redis:
    image: redis:7
    restart: unless-stopped
  odoo:
    image: odoo:19.0
    depends_on:
      - db
      - redis
    ports:
      - "8069:8069"
      - "8072:8072"
    environment:
      - HOST=db
      - USER=odoo
      - PASSWORD=your_secure_password
    volumes:
      - odoo_web_data:/var/lib/odoo
      - ./addons:/mnt/extra-addons
      - ./config:/etc/odoo
    restart: unless-stopped
volumes:
  postgres_data:
  odoo_web_data:
docker compose pull    # 拉取最新镜像
docker compose up -d   # 启动
docker compose up -d --scale odoo=3   # 生产环境扩展至3实例

注意:Odoo容器以UID 101运行,宿主机绑定目录需 chown -R 101:101 ./addons 多实例部署时Redis用于session共享,必不可少。

常用维护命令

docker compose exec db pg_dump -U odoo -d db_name > backup.sql   # 备份
docker compose exec -T db psql -U odoo -d db_name < backup.sql   # 恢复
docker compose logs -f odoo                                        # 查看日志

生产环境最佳实践

Worker数量计算

公式:workers = (CPU核数 x 2) + 1。每个worker约消耗150MB内存。

workers = 9            # 4核服务器
limit_memory_soft = 2147483648   # 2GB
limit_memory_hard = 2684354560   # 2.5GB
limit_request = 8192
limit_time_cpu = 600
limit_time_real = 1200
max_cron_threads = 1

PostgreSQL 16性能调优

在 /etc/postgresql/16/main/postgresql.conf:

shared_buffers = 512MB          # ~25%系统内存
effective_cache_size = 1536MB    # ~75%系统内存
maintenance_work_mem = 128MB
work_mem = 16MB

安全加固

  • UFW防火墙:仅开放 80/443/SSH,禁止8069端口公网访问
  • proxy_mode = True(反向代理后必须开启)
  • list_db = False(生产环境隐藏数据库列表)
  • 使用强密码作为 admin_passwd
  • SSH密钥认证,禁用密码登录
  • 启用 unattended-upgrades 自动安全补丁

自动备份(每日凌晨2点cron)

#!/bin/bash
BACKUP_DIR=/opt/odoo19/backups
DATE=$(date +%Y%m%d_%H%M%S)
mkdir -p $BACKUP_DIR
sudo -u postgres pg_dump odoo_prod | gzip > "$BACKUP_DIR/db_${DATE}.sql.gz"
tar -czf "$BACKUP_DIR/filestore_${DATE}.tar.gz" /opt/odoo19/.local/share/Odoo/filestore
find $BACKUP_DIR -type f -mtime +7 -delete

部署检查清单

检查项状态
Ubuntu 24.04 LTS 更新至最新☐
PostgreSQL 16 安装并调优☐
专用 odoo19 系统用户创建☐
Node.js 22.x + rtlcss 安装☐
Python 3.12 venv + 依赖安装☐
odoo19.conf + workers/内存/代理模式☐
Systemd 服务已启用☐
Nginx + WebSocket + 静态缓存☐
Let\'s Encrypt SSL 证书☐
UFW 仅开 80/443/SSH☐
自动备份 cron 任务☐
生产数据库禁用 Demo 数据☐

常见故障排查

问题检查方法
Odoo 无法启动sudo journalctl -u odoo19 -n 100
PostgreSQL 连接失败sudo -u postgres psql -c "\du" 确认 odoo19 用户存在
PDF 报表损坏wkhtmltopdf --version 确认 >=0.12.6
空白页面sudo tail -f /var/log/nginx/odoo19.error.log
WebSocket/聊天异常确认 proxy_mode=True 且 8072 端口监听