本教程适用于以下操作系统版本

  • Ubuntu 24.04(Noble Numbat)
  • Ubuntu 22.04(Jammy Jellyfish)
  • Ubuntu 20.04(Focal Fossa)
  • Ubuntu 15.04(Vivid Vervet)
  • Ubuntu 15.04(Vivid Vervet)

本页内容

  • 前置条件
  • 安装依赖项
  • 安装 Node.js
  • 安装 Wkhtmltopdf 程序
  • 安装 PostgreSQL 数据库服务器
  • 下载 Odoo 16
  • 安装 Odoo 的 Python 依赖项
  • 创建 Odoo 配置
  • 将 Odoo 作为 Systemd 服务运行
  • 使用 Nginx 反向代理运行 Odoo
  • 配置 UFW 防火墙
  • 迁移数据库并安装 Odoo 16
  • 总结

Odoo(前身为 OpenERP)是一套可自托管、包含超过 10,000 个开源 Odoo 是一个免费且开源的 ERP 解决方案,适用于多种类型的企业。它提供客户关系管理(CRM)、销售管道、项目管理、制造、开票、会计、电子商务等众多功能。

Odoo 是适用于企业的最完善的 ERP 解决方案之一。它默认附带 30 个核心模块,并提供超过 4500 个社区模块,可助力你的多种业务。

在本教程中,我们将在 Ubuntu 22.04 服务器上安装 Odoo 开源 ERP。我们将安装并配置最新稳定版的 Odoo 16,为 Odoo 设置 PostgreSQL 数据库,最后将 Nginx 配置为 Odoo 应用的反向代理。

前置条件

在开始本教程之前,你需要满足以下一些要求:

  • 一台 Ubuntu 22.04 服务器——本示例使用主机名为 ' odoo-server ' 的 Ubuntu 服务器。
  • 一个具有 sudo 管理员权限的非 root 用户——或者你也可以使用 root 用户。
  • 一个指向服务器 IP 地址的域名——用于生产环境时,Odoo 安装需要准备一个域名。

安装依赖项

要安装 Odoo,你首先需要为 Ubuntu 系统安装一些软件包依赖项。Odoo ERP 主要使用 Python 编写,是一个 Web 应用,因此你还需要安装一些 Python 软件包。

在开始安装软件包之前,运行以下 apt 命令更新并刷新你的软件包索引。

sudo apt update

接下来,通过以下 apt 命令安装 Odoo 的软件包依赖项。此次安装将包含最新版本的 Python 3.10、用于编译 Python 软件包的 build-essentials,以及 Odoo 所需的一些库。

sudo apt install git wget python3 build-essential libzip-dev python3-dev libxslt1-dev python3-pip libldap2-dev python3-wheel libsasl2-dev python3-venv python3-setuptools node-less libjpeg-dev xfonts-75dpi xfonts-base libxrender1 libpq-dev libffi-dev fontconfig

出现提示时,输入 y 确认并按 ENTER 继续。安装将开始进行。

如何在 Ubuntu 22.04 上安装 Odoo 16 开源 ERP 企业管理系统

一旦 Python 及其他依赖项安装完成,下一步是安装 Node.js(用于生成静态文件),并安装用于生成 PDF 报表的 wkhtmltopdf 软件包。

安装 Node.js

要安装 Odoo,你必须确保系统已安装 Node.js。Node.js 用于为 Odoo Web 应用生成静态文件。在本步骤中,你将通过第三方 Nodesource 仓库安装 Node.js 16。

运行以下命令下载并设置 Node.js 16 的 Nodesource 仓库。

sudo curl -sL https://deb.nodesource.com/setup_16.x | sudo -E bash -

该命令会下载并运行安装脚本,随后安装脚本会自动设置 Node.js 仓库、添加 GPG 密钥,并自动更新和刷新你系统上的软件包索引。

如何在 Ubuntu 22.04 上安装 Odoo 16 开源 ERP 企业管理系统

接下来,运行以下 apt 命令安装 Node.js 软件包。出现提示时,输入 y 确认并按 ENTER 继续。

sudo apt install nodejs

如何在 Ubuntu 22.04 上安装 Odoo 16 开源 ERP 企业管理系统

Node.js 安装完成后,运行以下 npm 命令安装 'rtlcss' 软件包。Odoo 需要 ' rtlcss ' 软件包,尤其是当你使用阿拉伯语、希伯来语等特定语言的从右到左(RTL)用户界面时。

sudo npm install -g rtlcss

安装 Wkhtmltopdf 程序

Odoo 开源 ERP 需要安装 wkhtmltopdf 软件包。该软件包用于通过 Qt Webkit 将 HTML 页面渲染为 PDF 及各种图像格式。wkhtmltopdf 软件包将通过 .deb 软件包手动安装到 Ubuntu 系统。

运行以下命令下载 Wkhtmltopdf 软件包的 .deb 文件。

cd /tmp
wget https://github.com/wkhtmltopdf/packaging/releases/download/0.12.6.1-2/wkhtmltox_0.12.6.1-2.jammy_amd64.deb

通过以下 dpkg 命令安装 Wkhtmltopdf 软件包。

sudo dpkg -i wkhtmltox_0.12.6.1-2.jammy_amd64.deb

如何在 Ubuntu 22.04 上安装 Odoo 16 开源 ERP 企业管理系统

如果你遇到缺少软件包之类的错误,可通过以下 apt 命令修复。

sudo apt install -f

Wkhtmltopdf 安装完成后,你可以验证默认位于 '/usr/local/bin ' 目录下的 Wkhtmltopdf 程序二进制文件。你应该会看到两个程序:' wkhtmltopdf ' 和 ' wkhtmltoimage '。

ls /usr/local/bin

现在运行以下命令验证 $PATH 环境变量,确保 '/usr/local/bin' 目录已包含在二进制文件 $PATH 中。否则,Wkhtmltopdf 软件包将无法正常使用。

echo $PATH

最后,运行以下命令确保 Wkhtmltopdf 软件包的二进制路径可用。如果 Wkhtmltopdf 软件包可用,你应该会收到 Wkhtmltopdf 软件包完整路径的输出。

which wkhtmltopdf
which wkhtmltoimage

如何在 Ubuntu 22.04 上安装 Odoo 16 开源 ERP 企业管理系统

安装 PostgreSQL 数据库服务器

Odoo 开源 ERP 支持 MySQL、SQLite 和 PostgreSQL 等数据库。在本步骤中,你将安装并使用 PostgreSQL 作为 Odoo 安装的默认数据库。你还将创建 PostgreSQL 角色并修改 PostgreSQL 配置。

运行以下 apt 命令安装 PostgreSQL 数据库服务器。出现确认提示时,输入 y 并按 ENTER 。

sudo apt install postgresql

如何在 Ubuntu 22.04 上安装 Odoo 16 开源 ERP 企业管理系统

PostgreSQL 安装完成后,运行以下命令验证 PostgreSQL,确保服务已启用并正在运行。

sudo systemctl is-enabled postgresql
sudo systemctl status postgresql

在以下输出中,你可以看到 PostgreSQL 服务已启用,并将在系统启动时自动运行。且 PostgreSQL 的状态为正在运行。

如何在 Ubuntu 22.04 上安装 Odoo 16 开源 ERP 企业管理系统

接下来,你将创建 Odoo 的新角色。运行以下命令登录 ' postgres ' 用户,并创建一个名为 'odoo' 的新角色。

su - postgres
createuser -sdP odoo

输入新角色 ' odoo ' 的密码并重复确认。

现在,通过以下 psql 命令登录 PostgreSQL shell。

psql

运行以下查询验证 PostgreSQL 上的角色列表,确保角色 ' odoo ' 已存在。

\du

现在输入 ' \q ' 退出 PostgreSQL shell。然后输入 ' exit ' 注销 postgres 用户。

如何在 Ubuntu 22.04 上安装 Odoo 16 开源 ERP 企业管理系统

现在你已为 Odoo 创建了角色,接下来将为 ' odoo ' 角色设置身份验证。

使用以下 nano 编辑器修改 PostgreSQL 配置文件 ' /etc/postgresql/14/main/pg_hba.conf '。

sudo nano /etc/postgresql/14/main/pg_hba.conf

将以下配置添加到文件中。这样,你将允许角色 ' odoo ' 通过 ' scram-sha-256 ' 密码验证方式访问 PostgreSQL。

host    all   odoo    127.0.0.1/32    scram-sha-256

完成后保存文件并退出编辑器。

现在运行以下命令重启 PostgreSQL 服务并应用新更改。

sudo systemctl restart postgresql

最后,以 'postgres' 用户身份登录,并通过以下 psql 命令登录 PostgreSQL shell 来验证 ' odoo ' 角色。

su - postgres
psql -h 127.0.0.1 -U odoo -d postgres

登录后,使用以下查询进行验证。

\conninfo

你现在应该能看到你正使用角色 ' odoo ' 连接到 PostgreSQL。

如何在 Ubuntu 22.04 上安装 Odoo 16 开源 ERP 企业管理系统

至此,Odoo 的 PostgreSQL 数据库准备工作已完成。接下来,你将通过下载源代码并安装 Python 依赖项来开始 Odoo 的安装。

下载 Odoo 16

在本演示中,你将使用 ' odoo ' 用户来设置并运行 Odoo v16。因此现在你将创建一个名为 'odoo' 的新 Unix 用户,并下载最新版本的 Odoo 16 源代码。

运行以下命令创建新用户 ' odoo '。在本示例中,用户 ' odoo ' 的默认主目录为 ' /opt/odoo',默认 shell 为 bash。

sudo adduser --system --group --home=/opt/odoo --shell=/bin/bash odoo

现在将工作目录切换到 '/opt/odoo ',并通过以下 git 命令下载 Odoo 源代码。在本示例中,你将安装 Odoo 16。

cd /opt/odoo
git clone https://github.com/odoo/odoo.git --depth 1 --branch 16.0 --single-branch odoo-server

现在你应该会在 ' /opt/odoo ' 目录下得到新目录 'odoo-server'。

最后,运行以下命令将 Odoo 源代码的所有权更改为用户和组 ' odoo '。

sudo chown -R odoo:odoo /opt/odoo/odoo-server

如何在 Ubuntu 22.04 上安装 Odoo 16 开源 ERP 企业管理系统

下载完 Odoo 源代码后,接下来将开始安装 Odoo 的 Python 软件包依赖项。

安装 Odoo 的 Python 依赖项

在本步骤中,你将设置 Odoo 的 Python 虚拟环境,并通过 pip3 命令安装 Python 依赖项。

将工作目录切换到 ' /opt/odoo/odoo-server ',并通过以下命令创建新的 Python 虚拟环境 ' venv '。

cd /opt/odoo/odoo-server
python3 -m venv venv

接下来,通过以下命令激活 ' venv ' Python 虚拟环境。

source venv/bin/activate

激活 Python 虚拟环境后,你会看到当前 shell 提示符变为类似 ' (venv) root@hostname...' 的样式。

如何在 Ubuntu 22.04 上安装 Odoo 16 开源 ERP 企业管理系统

现在运行以下 pip3 命令安装 Python 软件包 wheel,并通过 requirements.txt 文件安装 Odoo 的 Python 依赖项。

pip3 install wheel
pip3 install -r requirements.txt

如何在 Ubuntu 22.04 上安装 Odoo 16 开源 ERP 企业管理系统

Python 依赖项安装完成后,运行以下命令退出 Python ' venv ' 虚拟环境。

deactivate

现在你已下载 Odoo 源代码并安装了 Python 依赖项。接下来,你将为 Odoo 安装创建新的配置文件和目录。

创建 Odoo 配置

安装完 Odoo 的软件包依赖项后,接下来将开始创建 Odoo 配置,并将 Odoo 设置为 systemd 服务。

使用以下 nano 编辑器创建新的配置文件 ' /etc/odoo.conf '。

sudo nano /etc/odoo.conf

将以下配置添加到文件中。并务必将 ' admin_passwd ' 以及数据库用户和密码的详细信息修改为你的实际信息。

[options]
; This is the password that allows database operations:
admin_passwd = adminpassodoo
db_host = 127.0.0.1
db_port = 5432
db_user = odoo
db_password = odoopass
addons_path = /opt/odoo/odoo-server/addons
xmlrpc_port = 8069
logfile = /var/log/odoo/odoo-server.log
log_level  = debug

保存文件并退出编辑器。

现在,将 Odoo 配置文件 ' /etc/odoo.conf' 的所有权更改为系统用户 ' odoo '。

sudo chown odoo:odoo /etc/odoo.conf

接下来,运行以下命令创建一个用于存储 Odoo 日志的新目录。

sudo mkdir /var/log/odoo

然后,将 Odoo 日志目录 ' /var/log/odoo ' 的所有权更改为用户 ' odoo ',并将权限改为 755 。

sudo chown odoo:odoo /var/log/odoo 
sudo chmod 755 /var/log/odoo

如何在 Ubuntu 22.04 上安装 Odoo 16 开源 ERP 企业管理系统

将 Odoo 作为 Systemd 服务运行

至此,你可以通过命令行手动运行 Odoo。为方便管理,你可以将 Odoo 作为 systemd 服务运行。这样你便可以通过 systemctl 命令管理 Odoo。

现在你将创建一个新的 systemd 服务文件,并将 Odoo 作为 systemd 服务运行。

首先,使用以下 nano 编辑器创建新的 systemd 服务文件 '/lib/systemd/system/odoo-server.service'。

sudo nano /lib/systemd/system/odoo-server.service

将以下配置添加到文件中。

[Unit]
Description=Odoo 16.0 Service
Requires=postgresql.service
After=network.target postgresql.service
 
[Service]
Type=simple
SyslogIdentifier=odoo
PermissionsStartOnly=true
User=odoo
Group=odoo
ExecStart=/opt/odoo/odoo-server/venv/bin/python3 /opt/odoo/odoo-server/odoo-bin -c /etc/odoo.conf
StandardOutput=journal+console
 
[Install]
WantedBy=multi-user.target

完成后保存文件并退出编辑器。

接下来,通过以下 systemctl 命令重新加载 systemd 管理器以应用新的服务文件。

sudo systemctl daemon-reload

使用以下命令启动并启用服务 ' odoo-server'。

sudo systemctl start odoo-server
sudo systemctl enable odoo-server

如何在 Ubuntu 22.04 上安装 Odoo 16 开源 ERP 企业管理系统

最后,验证 Odoo 服务以确保服务正在运行。

sudo systemctl status odoo-server

你应该会收到服务 ' odoo-server ' 正在运行的输出。

如何在 Ubuntu 22.04 上安装 Odoo 16 开源 ERP 企业管理系统

使用 Nginx 反向代理运行 Odoo

在生产环境中部署 Odoo 的推荐方式是使用反向代理。这样你只需在本地主机(localhost)上运行 Odoo,所有客户端访问都由反向代理来处理。

在本步骤中,你将安装并配置 Nginx Web 服务器作为 Odoo Web 应用的反向代理。你还将通过 SSL 来保护 Odoo 安装。因此,在开始配置 Nginx 之前,请确保已将域名指向服务器 IP 地址,并已生成 Letsencrypt 的 SSL 证书。

首先,使用以下 nano 编辑器修改 Odoo 配置文件 ' /etc/odoo.conf '。

sudo nano /etc/odoo.conf

将以下配置添加到文件中。该配置将使 Odoo 作为后端应用运行在 127.0.0.1 上。

xmlrpc_interface = 127.0.0.1
proxy_mode = True

完成后保存文件并退出编辑器。

现在运行以下命令重启 ' odoo-server ' 服务并应用新更改。

sudo systemctl restart odoo-server

现在验证 ' odoo-server ' 服务以确保服务正在运行。

sudo systemctl status odoo-server

如何在 Ubuntu 22.04 上安装 Odoo 16 开源 ERP 企业管理系统

接下来,你将安装并配置 Nginx。

运行以下 apt 命令安装 Nginx Web 服务器软件包。出现提示时输入 y 并按 ENTER 继续并确认安装。

sudo apt install nginx

如何在 Ubuntu 22.04 上安装 Odoo 16 开源 ERP 企业管理系统

Nginx 安装完成后,使用以下 nano 编辑器创建新的 Nginx 虚拟主机配置文件 '/etc/nginx/sites-available/odoo.conf'。

sudo nano /etc/nginx/sites-available/odoo.conf

将以下配置添加到文件中,并务必将域名和 SSL 证书路径替换为你自己的设置。

#odoo server
upstream odoo {
 server 127.0.0.1:8069;
}
upstream odoochat {
 server 127.0.0.1:8072;
}
# http -> https
server {
   listen 80;
   server_name odoo.example.local;
   rewrite ^(.*) https://$host$1 permanent;
}
server {
 listen 443 ssl http2;
 server_name odoo.example.local;
 proxy_read_timeout 720s;
 proxy_connect_timeout 720s;
 proxy_send_timeout 720s;
 # Add Headers for odoo proxy mode
 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;
 proxy_set_header X-Real-IP $remote_addr;
 # SSL parameters
 ssl_certificate /etc/letsencrypt/live/odoo.example.local/fullchain.pem;
 ssl_certificate_key /etc/letsencrypt/live/odoo.example.local/privkey.pem;
 ssl_session_timeout 1d;
 ssl_session_cache shared:MozSSL:10m;  # about 40000 sessions
 ssl_session_tickets off;
 ssl_protocols TLSv1.2 TLSv1.3;
 ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384;
 ssl_prefer_server_ciphers off;
 # log
 access_log /var/log/nginx/odoo.access.log;
 error_log /var/log/nginx/odoo.error.log;
 # Redirect longpoll requests to odoo longpolling port
 location /longpolling {
 proxy_pass http://odoochat;
 }
 # Redirect requests to odoo backend server
 location / {
   proxy_redirect off;
   proxy_pass http://odoo;
 }
 # common gzip
 gzip_types text/css text/scss text/plain text/xml application/xml application/json application/javascript;
 gzip on;
}

完成后保存文件并关闭编辑器。

现在启用新的 Nginx 虚拟主机配置,并验证 Nginx 配置以确保配置正确无误。

sudo ln -s /etc/nginx/sites-available/odoo.conf /etc/nginx/sites-enabled/
sudo nginx -t

如果配置正确,你将看到类似 ' test successful - syntax OK ' 的输出信息。

最后,运行以下 systemctl 命令重启 Nginx 服务并应用新更改。

sudo systemctl restart nginx

至此,你已完成 Odoo ERP 的 Nginx 反向代理的安装与配置。现在你可以通过 Web 浏览器访问该安装了。

如何在 Ubuntu 22.04 上安装 Odoo 16 开源 ERP 企业管理系统

运行以下命令验证 Nginx 服务并确保服务正在运行。

sudo systemctl restart nginx

你应该看到 Nginx 服务正在运行。

如何在 Ubuntu 22.04 上安装 Odoo 16 开源 ERP 企业管理系统

配置 UFW 防火墙

建议在 Odoo 安装上启用防火墙。在本步骤中,你将学习如何配置 UFW 防火墙。

默认情况下,标准的 Ubuntu 服务器已安装 ufw 软件包,因此你可以直接开始配置。

运行以下命令将 OpenSSH 应用添加到 ufw 防火墙。然后运行并启用 ufw。

sudo ufw allow "OpenSSH"
sudo ufw enable

出现确认提示时,输入 y 并按 ENTER 继续。此后 ufw 防火墙服务将被启用并运行。

如何在 Ubuntu 22.04 上安装 Odoo 16 开源 ERP 企业管理系统

接下来,运行以下命令添加 ' Nginx Full ' 应用。该应用配置文件由默认安装的 Nginx 软件包提供,将为你的应用开放 HTTP 和 HTTPS 两个端口。

sudo ufw allow "Nginx Full"

最后,验证 ufw 上已启用的规则列表。你应该会看到 ' OpenSSH ' 和 'Nginx Full' 两个应用已启用。

sudo ufw status

如何在 Ubuntu 22.04 上安装 Odoo 16 开源 ERP 企业管理系统

迁移数据库并安装 Odoo 16

打开你的 Web 浏览器,访问你 Odoo 安装的域名(例如:https://odoo.example.local/)。

首先,你需要为 Odoo 迁移数据库并创建一个新的管理员用户。

这里的 Master Password(主密码)就是你在 ' /etc/odoo.conf ' 文件中刚添加的 ' admin_passwd '。

输入将自动创建的新数据库名称,并输入你的 Odoo 安装的新管理员用户和密码详细信息。此外,你还可以勾选 Demo data(演示数据)复选框,将演示数据添加到你的安装中。

点击 ' Create database '(创建数据库)以开始 Odoo 安装。

如何在 Ubuntu 22.04 上安装 Odoo 16 开源 ERP 企业管理系统

Odoo 安装完成后,你将被重定向到 Odoo 登录页面。输入你的 Odoo 管理员邮箱和密码,然后点击 ' Log In '(登录)。

如何在 Ubuntu 22.04 上安装 Odoo 16 开源 ERP 企业管理系统

现在你应该会进入 Odoo 用户仪表板。

如何在 Ubuntu 22.04 上安装 Odoo 16 开源 ERP 企业管理系统

总结

恭喜!你已在 Ubuntu 22.04 服务器上安装了 Odoo 开源 ERP。你还学习了 PostgreSQL 数据库服务器以及配置为反向代理的 Nginx Web 服务器的基本安装方法。

至此,你已在 Ubuntu 服务器上完成了 Odoo 安装的全面加固。现在你可以开始添加一些适合你业务的其他插件/扩展模块了。