源安装¶
源代码 installation
并不是安装 Odoo,而是直接从源代码运行。
对于模块开发人员来说,使用 Odoo 源程序可能更方便,因为它比使用打包安装程序更容易访问。
与打包安装程序设置的服务相比,它使 Odoo 的启动和停止更加灵活和明确。此外,它还允许使用 命令行参数 覆盖设置,而无需编辑配置文件。
最后,它提供对系统设置的更大控制,并且可以更轻松地同时保留(和运行)多个版本的 Odoo。
获取源¶
获取 Odoo 源代码有两种方式:ZIP 压缩包 或通过 Git 。
存档¶
社区版:
企业版
Git¶
注解
需要安装 Git ,建议具备 Git 命令的基本知识才能继续。
要克隆 Git 存储库,可选择使用 HTTPS 或 SSH 进行克隆。大多数情况下,最佳选择是 HTTPS。不过,要为 Odoo 源代码做贡献,或遵循 开发者入门教程 时,请选择 SSH。
$ git clone https://github.com/odoo/odoo.git
$ git clone https://github.com/odoo/enterprise.git
$ git clone git@github.com:odoo/odoo.git
$ git clone git@github.com:odoo/enterprise.git
C:\> git clone https://github.com/odoo/odoo.git
C:\> git clone https://github.com/odoo/enterprise.git
C:\> git clone git@github.com:odoo/odoo.git
C:\> git clone git@github.com:odoo/enterprise.git
$ git clone https://github.com/odoo/odoo.git
$ git clone https://github.com/odoo/enterprise.git
$ git clone git@github.com:odoo/odoo.git
$ git clone git@github.com:odoo/enterprise.git
注解
企业 Git 存储库不包含完整的 Odoo 源代码 。它只是额外附加组件的集合。主服务器代码位于社区版中。运行企业版意味着从社区版运行服务器,并将组件路径选项设置为具有企业版的文件夹。要进行Odoo 企业版安装,您需要克隆社区版和企业版储存库。
准备¶
Python¶
Odoo 需要 Python 3.10 或更高版本才能运行。
在 17 版更改: 最低要求从 Python 3.7 更新到 Python 3.10。
使用软件包管理器下载并安装Python 3(如需要)。
下载最新版本 Python 3 <https://www.python.org/downloads/windows/>
并安装。
在安装过程中,选中 Python 3 添加到 PATH ,然后单击 定义安 并确保选中 pip 。
注解
如果已安装 Python 3,请确保版本为 3.10 或更高,因为以前的版本与 Odoo 不兼容。
$ python3 --version
C:\> python --version
$ python3 --version
确保此版本还安装了 pip 。
$ pip3 --version
C:\> pip --version
$ pip3 --version
PostgreSQL¶
Odoo 使用 PostgreSQL 作为其数据库管理系统。
通过使用软件包管理器下载和安装 PostgreSQL(支持版本为 12.0 或更高版本)。可以通过执行以下命令来实现:
$ sudo apt install postgresql postgresql-client
下载 PostgreSQL (支持版本:12.0或更高版本)并安装。
使用 Postgres.app 下载并安装 PostgreSQL(支持版本:12.0或更高版本)。
小技巧
请按照 Postgres.app CLI工具说明 设置`$PATH`变量,以确保与 Postgres.app 捆绑的命令行工具可用。
默认情况下,唯一的用户是 postgres
。由于Odoo禁止以 postgres
的身份连接,因此需要创建一个新的PostgreSQL用户。
$ sudo -u postgres createuser -d -R -S $USER
$ createdb $USER
注解
由于 PostgreSQL 用户与 Unix 登录名相同,所以可以在没有密码的情况下连接到数据库。
将 PostgreSQL 的`bin`目录(默认情况下为:
C:\Program Files\PostgreSQL\<version>\bin
)添加到`PATH`中。使用 pg admin gui 创建一个具有密码的 postgres 用户:
打开 pgAdmin 。
双击服务器以创建连接。
选择
。在 角色名称 字段中输入用户名(例如,
odoo
)。打开 定义 选项卡,输入密码(例如,
odoo
),然后点击 保存 。打开 权限 选项卡,将 可以登录? 切换为 是 ,将 创建数据库? 切换为 是 。
$ sudo -u postgres createuser -d -R -S $USER
$ createdb $USER
注解
由于 PostgreSQL 用户与 Unix 登录名相同,所以可以在没有密码的情况下连接到数据库。
依赖¶
使用 发行版软件包 是安装依赖包的首选方式。或者,使用 pip 安装 Python 依赖项。
在 Debian/Ubuntu 上,使用以下命令即可安装所需的软件包:
$ cd odoo #CommunityPath
$ sudo ./setup/debinstall.sh
setup/debinstall.sh
脚本将解析 debian/control 文件并安装找到的软件包。
警告
使用 pip 可能会导致安全问题和依赖关系中断;只有在你知道自己在做什么的情况下才会这样做。
由于某些 Python 软件包需要编译步骤,因此需要安装系统库。
在 Debian/Ubuntu 上,使用以下命令即可安装这些所需的库:
$ sudo apt install python3-pip libldap2-dev libpq-dev libsasl2-dev
Odoo 依赖项列在位于 Odoo 社区版目录根目录下的 requirements.txt
文件中。
注解
requirements.txt
中的 Python 包基于 Odoo 发布时其对应的稳定版/LTS 版 Debian/Ubuntu 的版本。例如,对于 Odoo 15.0,python3-babel
包的版本在 Debian Bullseye 中为 2.8.0,在 Ubuntu Focal 中为 2.6.0。然后在 requirements.txt
中选择最低版本。
小技巧
最好不要在 Odoo 的不同实例之间或与系统混合使用 Python 模块包。不过,可以使用 virtualenv 来创建隔离的 Python 环境。
导航至 Odoo 社区版安装路径( CommunityPath
),并在需求文件上运行 pip 为当前用户安装需求。
$ cd /CommunityPath
$ pip install -r requirements.txt
在安装依赖项之前,下载并安装 Visual Studio 的生成工具 。在 工作负载 标签页中选择 C++ 生成工具 ,并在提示时安装它们。
Odoo 依赖项列在位于 Odoo 社区版目录根目录下的 requirements.txt
文件中。
小技巧
最好不要在 Odoo 的不同实例之间或与系统混合使用 Python 模块包。不过,可以使用 virtualenv 来创建隔离的 Python 环境。
导航至 Odoo 社区版安装路径( CommunityPath
),并在 具有管理员权限 的终端上对需求文件运行 pip :
C:\> cd \CommunityPath
C:\> pip install setuptools wheel
C:\> pip install -r requirements.txt
Odoo 依赖项列在位于 Odoo 社区版目录根目录下的 requirements.txt
文件中。
小技巧
最好不要在 Odoo 的不同实例之间或与系统混合使用 Python 模块包。不过,可以使用 virtualenv 来创建隔离的 Python 环境。
导航至 Odoo 社区版安装路径( CommunityPath
),并在需求文件上运行 pip :
$ cd /CommunityPath
$ pip3 install setuptools wheel
$ pip3 install -r requirements.txt
注解
对于使用 从右到左界面 的语言(如阿拉伯语或希伯来语),需要使用 rtlcss
软件包。
警告
wkhtmltopdf
无法通过 pip 安装,必须手动安装到 version 0.12.6 才能支持页眉和页脚。请查看 wkhtmltopdf wiki 了解有关不同版本的更多详情。
运行 Odoo¶
一旦设置了所有依赖项,就可以通过运行服务器的命令行界面 odoo-bin
来启动Odoo。它位于Odoo社区目录的根目录。
小技巧
对于企业版,请在 addons-path
参数中添加 enterprise
附加组件的路径。请注意,该路径必须位于 addons-path
中其他路径之前,这样才能正确加载附加组件。
常见的必要配置有:
PostgreSQL 用户和密码。
可以在默认路径之外设置自定义插件路径以加载自定义模块。
运行服务器的典型方法是:
$ cd /CommunityPath
$ python3 odoo-bin --addons-path=addons -d mydb
其中, CommunityPath
是 Odoo 社区版的安装路径, mydb
是 PostgreSQL 数据库的名称。
C:\> cd CommunityPath/
C:\> python odoo-bin -r dbuser -w dbpassword --addons-path=addons -d mydb
其中, CommunityPath
是 Odoo 社区版的安装路径, dbuser
是 PostgreSQL 登录名, dbpassword
是 PostgreSQL 密码, mydb
是 PostgreSQL 数据库名称。
$ cd /CommunityPath
$ python3 odoo-bin --addons-path=addons -d mydb
其中, CommunityPath
是 Odoo 社区版的安装路径, mydb
是 PostgreSQL 数据库的名称。
服务器启动后(打印 INFO 日志 odoo.modules.loading: Modules loaded.
),在网络浏览器中打开 http://localhost:8069,使用基本管理员账户登录 Odoo 数据库:使用 admin
作为电子邮件,同样使用 admin
作为密码。