Odoo 是世界上最流行的多功能商业软件。它提供了一系列商业应用程序,包括 CRM,网站,电子商务,账单,账户,工业制造,仓库,项目管理,库存管理,等等,所有的东西都无缝集成。
这个指南讲解了如何在 CentOS 8 上一个 Python 虚拟机环境中从源码安装 Odoo 13。我们将会从 Github 上编译 Odoo 源码并且配置 Nginx 作为反向代理服务器。
一、前提条件
你需要以 root 或者其他有 sudo 权限的用户身份登录,以便完成整个安装过程。
二、安装依赖
安装 Python 3,Git,以及其他从源码编译 Odoo 所需的库和工具:
代码语言:javascript复制sudo dnf install python3 python3-devel git gcc redhat-rpm-config libxslt-devel bzip2-devel openldap-devel libjpeg-devel freetype-devel
三、创建一个系统用户
创建一个系统用户和用户组,以/opt/odoo
为主目录,用来运行 Odoo 服务:
sudo useradd -m -U -r -d /opt/odoo13 -s /bin/bash odoo13
你可以使用其他你想要的名字作为用户名称,只要能够保证使用这个名字可以创建一个 PostgreSQL 用户。
四、安装和配置 PostgreSQL
我们将会从标准的 CentOS 8 源仓库中安装 PostgreSQL 10。
代码语言:javascript复制sudo dnf install @postgresql:10
一旦安装完成,创建一个 PostgreSQL 数据库:
代码语言:javascript复制sudo postgresql-setup initdb
启用并且启动 PostGreSQL 服务:
代码语言:javascript复制sudo systemctl enable --now postgresql
创建一个 ProtgreSQL 用户,使用和前面创建的系统用户名字一样的名字作为数据库用户名。在我们的例子中,这个名字是odoo13
:
sudo su - postgres -c "createuser -s odoo13"
五、安装 Wkhtmltopdf
Wkhtmltopdf
软件包提供了一系列开源命令行工具,可以将 HTML 渲染成 PDF,以及各种图片格式。想要打印 PDF 报告,你将需要Wkhtmltopdf
工具。Odoo 推荐的版本是0.12.5
,这个版本不在 CentOS 8 官方软件源仓库中。
从 github 安装它的rpm
软件包:
sudo dnf install https://github.com/wkhtmltopdf/wkhtmltopdf/releases/download/0.12.5/wkhtmltox-0.12.5-1.centos8.x86_64.rpm
六、安装和配置 Odoo 13
在开始安装之前,切换用户至odoo13
:
sudo su - odoo13
开始从 Odoo 的 Github 源仓库中克隆 Odoo 13 源代码:
代码语言:javascript复制git clone https://www.github.com/odoo/odoo --depth 1 --branch 13.0 /opt/odoo13/odoo
切换到/opt/odoo13
目录,并且为安装 Odoo 创建一个新的 Python 虚拟环境:
cd /opt/odoo13
python3 -m venv venv
使用source
命令去激活这个环境:
source venv/bin/activate
安装必要的 Python 模块:
代码语言:javascript复制pip3 install -r odoo/requirements.txt
代码语言:javascript复制如果你在安装过程中遇见任何编译错误,请确保你安装了所有的依赖软件包。具体依赖包参考`Installing Dependencies`
一旦安装完成,解除这个环境:
代码语言:javascript复制deactivate
为自定义组件创建一个新的目录:
代码语言:javascript复制mkdir /opt/odoo13/odoo-custom-addons
切换回 sudo 用户
代码语言:javascript复制exit
下一步,使用文本编辑器打开并且创建下面的配置文件:
代码语言:javascript复制sudo nano /etc/odoo13.conf
代码语言:javascript复制[options]
; This is the password that allows database operations:
admin_passwd = superadmin_passwd
db_host = False
db_port = False
db_user = odoo13
db_password = False
addons_path = /opt/odoo13/odoo/addons, /opt/odoo13/odoo-custom-addons
保存并且关闭文件。
代码语言:javascript复制 不要忘记将`superadmin_passwd`改成更安全的密码。
七、创建一个 Systemd Unit 文件
打开你的文本编辑器,并且在/etc/systemd/system/
目录下创建一个名为odoo13.service
的文件:
sudo nano /etc/systemd/system/odoo13.service
将下面的内容粘贴到文件中:
代码语言:javascript复制[Unit]
Description=Odoo13
Requires=postgresql.service
After=network.target postgresql.service
[Service]
Type=simple
SyslogIdentifier=odoo13
PermissionsStartOnly=true
User=odoo13
Group=odoo13
ExecStart=/opt/odoo13/venv/bin/python3 /opt/odoo13/odoo/odoo-bin -c /etc/odoo13.conf
StandardOutput=journal console
[Install]
WantedBy=multi-user.target
保存文件并且关闭编辑器。
通知 Systemd 有一个新的 unit 文件:
代码语言:javascript复制sudo systemctl daemon-reload
通过执行下面命令启用并且启动 Odoo 服务:
代码语言:javascript复制sudo systemctl enable --now odoo13
你可以通过下面的命令检查服务状态:
代码语言:javascript复制sudo systemctl status odoo13
代码语言:javascript复制● odoo13.service - Odoo13
Loaded: loaded (/etc/systemd/system/odoo13.service; enabled; vendor preset: disabled)
Active: active (running) since Wed 2019-12-11 20:04:52 UTC; 5s ago
Main PID: 28539 (python3)
Tasks: 4 (limit: 11524)
Memory: 94.6M
CGroup: /system.slice/odoo13.service
└─28539 /opt/odoo13/venv/bin/python3 /opt/odoo13/odoo/odoo-bin -c /etc/odoo13.conf
想要查看 Odoo 服务日志,使用下面的命令:
代码语言:javascript复制sudo journalctl -u odoo13
八、测试安装
打开你的浏览器,输入:http://<your_domain_or_IP_address>:8069
假设所有安装完成,你将会看到下面这样的屏幕:
如果你无法访问这个页面,那很可能是你的防火墙阻止了端口8069
。
使用下面的命令打开必要的端口:
代码语言:javascript复制sudo firewall-cmd --permanent --zone=public --add-port=8069/tcp
sudo firewall-cmd --reload
九、将 Nginx 配置成 SSL 代理服务器
默认的 Odoo 网站服务器通过 HTTP 服务。想要使 Odoo 部署更安全,我们将会配置 Nginx 作为 SSL 代理服务器,使网站服务器通过 HTTPS 进行服务。
SSL 代理服务器是一个用来处理 SSL 加密解密的代理服务器。这意味着,Nginx 将会处理并且解密进来的 TLS 连接(HTTPS),并且传递未被加密的请求到内部服务(Odoo)。在 Nginx 和 Odoo 之间的流量将不会被加密。
使用一个反向代理服务器有很多好处,比如负载均衡,SSL,缓存,压缩,静态内容服务,等等。
确保你满足下面的前提条件,再继续下一步的安装配置:
- 一个指向你的服务器的公网 IP 的域名,我们使用
example.com
。 - 安装 Nginx
- 域名的 SSL 证书。你可以安装一个免费的 Encrypt SSL 证书。
打开你的文本编辑器,创建或者编辑域名服务器配置块:
代码语言:javascript复制sudo nano /etc/nginx/conf.d/example.com
下面的配置将会建立 SSL,HTTP 转向 HTTPS,WWW 转向 non-www,缓存静态文件,并且开启 GZip 压缩。
代码语言:javascript复制# Odoo servers
upstream odoo {
server 127.0.0.1:8069;
}
upstream odoochat {
server 127.0.0.1:8072;
}
# HTTP -> HTTPS
server {
listen 80;
server_name www.example.com example.com;
include snippets/letsencrypt.conf;
return 301 https://example.com$request_uri;
}
# WWW -> NON WWW
server {
listen 443 ssl http2;
server_name www.example.com;
ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
ssl_trusted_certificate /etc/letsencrypt/live/example.com/chain.pem;
include snippets/ssl.conf;
return 301 https://example.com$request_uri;
}
server {
listen 443 ssl http2;
server_name example.com;
proxy_read_timeout 720s;
proxy_connect_timeout 720s;
proxy_send_timeout 720s;
# Proxy headers
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/example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
ssl_trusted_certificate /etc/letsencrypt/live/example.com/chain.pem;
include snippets/ssl.conf;
# log files
access_log /var/log/nginx/odoo.access.log;
error_log /var/log/nginx/odoo.error.log;
# Handle longpoll requests
location /longpolling {
proxy_pass http://odoochat;
}
# Handle / requests
location / {
proxy_redirect off;
proxy_pass http://odoo;
}
# Cache static files
location ~* /web/static/ {
proxy_cache_valid 200 90m;
proxy_buffering on;
expires 864000;
proxy_pass http://odoo;
}
# Gzip
gzip_types text/css text/less text/plain text/xml application/xml application/json application/javascript;
gzip on;
}
代码语言:javascript复制 不要忘记使用你自己的 Odoo 域名替换 example.com并且设置正确的 SSL 证书地址。证书中的配置段,请参考:https://linuxize.com/post/secure-nginx-with-let-s-encrypt-on-centos-7/
一旦你完成了,重启 Nginx 服务:
代码语言:javascript复制sudo systemctl restart nginx
下一步,我们需要告诉 Odoo 使用代理服务器。想要这么做,打开配置文件,并且添加下面的内容: /etc/odoo13.conf
重启 Odoo 服务并且使修改生效:
代码语言:javascript复制sudo systemctl restart odoo13
此时,反向代理服务器配置好了,你可以通过https://example.com
来访问 Odoo 了。
十、改变监听端口
这一步是可选的,但是它是一个很好的实践操作。
默认情况下,Odoo 服务监听所有网络接口的8069
端口。想要禁止对 Odoo 的直接访问,你可以封锁8069
端口,并且强制 Odoo 只监听本地监控。
我们将会配置 Odoo 仅仅监听 127.0.0.1
。打开配置文件,添加下面的内容到文件最后面: /etc/odoo13.conf
xmlrpc_interface = 127.0.0.1
netrpc_interface = 127.0.0.1
保存配置文件,并且重启 Odoo 服务器,使修改生效:
代码语言:javascript复制sudo systemctl restart odoo13
十一、启用多进程
默认情况下,Odoo 工作在多线程模式。对于产品级别的部署,我们推荐修改成多进程服务器,提升稳定性,并且充分利用系统资源。
想要启用多进程,你需要编辑 Odoo 配置文件,并且设置一个非 0 的工作进程数字。工作进程数字,基于 系统中的 CPU 核心数字和可用的 RAM 内存来计算。
通过 Odoo 官方文档计算工作进程的数量以及需要的 RAM 内存大小,你可以使用下面的公式:
工作进程数量计算:
- 工作进程最大数量理论值 = (system_cpus * 2) 1
- 1 个工作进程可以服务 约等于 6 个并行客户。
- Cron 进程也需要 CPU
RAM 内存大小计算
- 我们考虑 20%的请求是重请求,并且 80%的请求是轻量级请求。重量级请求使用将近 1GB RAM,而轻量级请求使用将近 150MB RAM。
- 需要的 RAM =
number_of_workers * ( (light_worker_ratio * light_worker_ram_estimation) (heavy_worker_ratio * heavy_worker_ram_estimation) )
如果你不知道你的系统有多少 CPU,你可以使用下面的grep
命令:
grep -c ^processor /proc/cpuinfo
比方说,你有一个系统,拥有 4 核心 CPU,8GB RAM 内存,和 30 个并行 Odoo 用户。
30 users / 6 = **5**
(5 是所需要的理论工作进程数量)(4 * 2) 1 = **9**
(9 是理论的最大工作进程数量)
基于上面的计算,你可以使用 5 个进程 1 个进程(Cron 进程)总共 6 个进程。
基于工作进程,计算 RAM 内存:
RAM = 6 * ((0.8*150) (0.2*1024)) ~= 2 GB of RAM
计算结果显示,Odoo 安装将会需要大概 2GB 内存。
想要切换到多进程模式,打开配置文件,并且添加计算值: /etc/odoo13.conf
limit_memory_hard = 2684354560
limit_memory_soft = 2147483648
limit_request = 8192
limit_time_cpu = 600
limit_time_real = 1200
max_cron_threads = 1
workers = 5
重启 Odoo 服务,使修改生效:
代码语言:javascript复制sudo systemctl restart odoo13
余下的系统资源将会被分配给系统其他服务使用。在这篇指南中,我们将 Odoo,PostgreSQL 和 Nginx 安装在同一个服务器上。依赖于你的设置,你的服务器上还有其他的服务。
十二、总结
这篇指南带你浏览了如何在 CentOS 8 上的 Python 虚拟环境中 安装 Odoo 13,并使用 Nginx 作为反向代理服务器。我们展示了如何在生产环境中如何启用多进程以及优化 Odoo。