源安装¶
源代码 ‘installation’ 并不是安装 Odoo,而是直接从源代码运行。
对于模块开发人员来说,使用 Odoo 源程序可能更方便,因为它比使用打包安装程序更容易访问。
与打包安装程序设置的服务相比,它使 Odoo 的启动和停止更加灵活和明确。此外,它还允许使用 :ref:` 命令行参数 <reference/cmdline>`覆盖设置,而无需编辑配置文件。
最后,它提供对系统设置的更大控制,并且可以更轻松地同时保留(和运行)多个版本的 Odoo。
获取源¶
获取 Odoo 源代码有两种方式:ZIP 压缩包 或通过**Git**。
存档¶
社区版:
企业版
Git¶
注解
需要安装 Git,建议具备 Git 命令的基本知识才能继续。
要克隆一个 Git 存储库,请选择使用 HTTPS 或 SSH 进行克隆。在大多数情况下,最好的选择是HTTPS。然而,如果要为 Odoo 源代码做贡献或者遵循:doc:入门开发者教程</developer/tutorials/getting_started>
,请选择 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 requires Python 3.7 or later to run.
使用软件包管理器下载并安装Python 3(如需要)。
下载最新版本 Python 3 <https://www.python.org/downloads/windows/>
并安装。
在安装过程中,选中“ ** Python 3 添加到 PATH**”,然后单击“ 定义安 ”并确保选中“pip”。
注解
如果已经安装了Python 3,请确保版本为3.7或更高版本,因为以前的版本与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 <https://www.postgresql.org/download/windows>`_(支持版本:12.0或更高版本)并安装。</text_to_translate>
使用 `Postgres.app <https://postgresapp.com>`_下载并安装 PostgreSQL(支持版本:12.0或更高版本)。
小技巧
请按照`Postgres.app CLI工具说明<https://postgresapp.com/documentation/cli-tools.html>`_设置`$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。
双击服务器以创建连接。
选择:menuselection:
对象 --> 创建 --> 登录名/组角色
。在**角色名称**字段中输入用户名(例如,
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
The setup/debinstall.sh
script will parse the debian/control file and install the found packages.
警告
使用 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
在安装依赖项之前,请下载并安装 “Build Tools for Visual Studio <https://visualstudio.microsoft.com/downloads/>`_”。在 Workloads 选项卡中选择 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社区目录的根目录。
要配置服务器,可指定 :ref:` 命令行参数 <reference/cmdline/server>` 或 :ref:` 配置文件 <reference/cmdline/config>`。
小技巧
对于企业版,请在 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
作为密码。
小技巧
从那里,创建并管理新的 用户。
用于登录 Odoo 网页界面的用户账户与
--db_user
CLI 参数不同。