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一键部署、生产环境最佳实践。
系统要求
| 组件 | 最低配置 | 推荐配置(生产) |
|---|---|---|
| CPU | 2核 | 4核+ |
| 内存 | 2 GB | 4-8 GB |
| 磁盘 | 20 GB SSD | 50 GB+ SSD |
| 操作系统 | Ubuntu 22.04/24.04 LTS | Ubuntu 24.04 LTS |
| Python | 3.10+ | 3.12(24.04默认) |
| PostgreSQL | 13+ | 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 端口监听 |