原始碼安裝¶
原始碼「安裝」並非安裝 Odoo,而是直接從原始碼執行它。
使用 Odoo 原始碼對模組開發者來說可能更方便,因為它比使用套件安裝程式更容易存取。
這使得啟動和停止 Odoo 比套件安裝程式設定的服務更靈活和明確。此外,它允許使用 指令列參數 覆寫設定,而無需編輯配置檔案。
最後,它提供對系統設定的更大控制,並允許更輕鬆地保留(和執行)多個並行的 Odoo 版本。
獲取程式原始碼¶
你有兩種方式可獲取 Odoo 的原始碼:以 ZIP 壓縮檔 形式,或透過 Git 取得。
壓縮檔¶
社群版:
企業版:
Git¶
備註
需要安裝 Git,並建議具備 Git 指令的基本知識才能繼續。
要複製 Git 版本庫,請選擇使用 HTTPS 或 SSH 進行複製。在大多數情況下,最佳選項是 HTTPS。但是,若要為 Odoo 原始碼做出貢獻或在遵循 入門開發者教學 時,請選擇 SSH。
$ git clone --branch 18.0 --single-branch https://github.com/odoo/odoo.git
$ git clone --branch 18.0 --single-branch https://github.com/odoo/enterprise.git
$ git clone --branch 18.0 --single-branch git@github.com:odoo/odoo.git
$ git clone --branch 18.0 --single-branch git@github.com:odoo/enterprise.git
C:\> git clone --branch 18.0 --single-branch https://github.com/odoo/odoo.git
C:\> git clone --branch 18.0 --single-branch https://github.com/odoo/enterprise.git
C:\> git clone --branch 18.0 --single-branch git@github.com:odoo/odoo.git
C:\> git clone --branch 18.0 --single-branch git@github.com:odoo/enterprise.git
$ git clone --branch 18.0 --single-branch https://github.com/odoo/odoo.git
$ git clone --branch 18.0 --single-branch https://github.com/odoo/enterprise.git
$ git clone --branch 18.0 --single-branch git@github.com:odoo/odoo.git
$ git clone --branch 18.0 --single-branch git@github.com:odoo/enterprise.git
備註
企業版 git 版本庫不包含完整的 Odoo 原始碼。它只是額外附加元件的集合。主要伺服器程式碼在社群版中。執行企業版意味著從社群版執行伺服器,並將 addons-path 選項設定為企業版資料夾。需要同時複製社群版和企業版版本庫才能擁有可運作的 Odoo 企業版安裝。
準備¶
Python¶
Odoo 需要 Python 3.10 或更高版本才能執行。
在 17 版本變更: 最低要求從 Python 3.7 更新為 Python 3.10。
如有需要,可使用套件管理工具,下載並安裝 Python 3。
下載最新版本的 Python 3 並安裝。
安裝期間,勾選 Add Python 3 to PATH,然後按一下 Customize Installation 並確保 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 隨附的命令列工具可用,請務必按照 Postgres.app CLI tools instructions 設定 $PATH 變數。
預設情況下,唯一的使用者是 postgres。由於 Odoo 禁止以 postgres 連線,請建立新的 PostgreSQL 使用者。
$ sudo -u postgres createuser -d -R -S $USER
$ createdb $USER
備註
由於 PostgreSQL 使用者與 Unix 登入名稱相同,因此可以在不使用密碼的情況下連線到資料庫。
將 PostgreSQL 的
bin目錄(預設位置在C:\Program Files\PostgreSQL\<版本編號>\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<https://github.com/odoo/odoo/blob/18.0/debian/control>`_檔案並安裝找到的套件。
警告
使用 pip 可能會導致安全性問題和相依性損壞;只有在您知道自己在做什麼時才這樣做。
由於部分 Python 套件需要編譯步驟,因此需要安裝系統程式庫。
在 Debian/Ubuntu 上,以下命令應該可以安裝這些所需的程式庫:
$ sudo apt install python3-pip libldap2-dev libpq-dev libsasl2-dev
Odoo 相依性套件列在 Odoo Community 目錄根目錄的 requirements.txt 檔案中。
備註
requirements.txt 中的 Python 套件基於 Odoo 發布時穩定/LTS Debian/Ubuntu 對應版本。例如,對於 Odoo 15.0,Debian Bullseye 中的 python3-babel 套件版本為 2.8.0,Ubuntu Focal 中為 2.6.0。然後在 requirements.txt 中選擇最低版本。
小訣竅
最好不要在 Odoo 的不同執行個體之間或與系統混合使用 Python 模組套件。但是,可以使用 virtualenv 建立隔離的 Python 環境。
導覽至 Odoo Community 安裝路徑 (CommunityPath) 並在 requirements 檔案上執行 pip,為目前使用者安裝所需套件。
$ cd /CommunityPath
$ pip install -r requirements.txt
在安裝相依套件之前,請下載並安裝 Build Tools for Visual Studio。在 Workloads 分頁中選擇 C++ build tools,並在提示時進行安裝。
Odoo 相依套件列在 Odoo Community 目錄根目錄的 requirements.txt 檔案中。
小訣竅
最好不要在 Odoo 的不同執行個體之間或與系統混合使用 Python 模組套件。但是,可以使用 virtualenv 建立隔離的 Python 環境。
導航至 Odoo Community 安裝路徑 (CommunityPath),並在**具有管理員權限**的終端機中對 requirements 檔案執行 pip:
C:\> cd \CommunityPath
C:\> pip install setuptools wheel
C:\> pip install -r requirements.txt
Odoo 相依套件列在 Odoo Community 目錄根目錄的 requirements.txt 檔案中。
小訣竅
最好不要在 Odoo 的不同執行個體之間或與系統混合使用 Python 模組套件。但是,可以使用 virtualenv 建立隔離的 Python 環境。
導航至 Odoo Community 安裝路徑 (CommunityPath),並對 requirements 檔案執行 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 Community 目錄的根目錄。
若要配置伺服器,可以指定:ref:命令列引數 <reference/cmdline/server>`或:ref:`配置檔案 <reference/cmdline/config>。
小訣竅
對於 Enterprise 版本,請將 enterprise 附加元件的路徑加入至 addons-path 引數。請注意,它必須位於 addons-path 中其他路徑之前,附加元件才能正確載入。
通常必須提供的配置包括:
PostgreSQL 使用者名稱及密碼。
除了預設路徑外,用於載入自訂模組的自訂附加元件路徑。
執行伺服器的典型方式為:
$ cd /CommunityPath
$ python3 odoo-bin --addons-path=addons -d mydb
其中 CommunityPath 是 Odoo Community 安裝路徑,mydb 是 PostgreSQL 資料庫名稱。
C:\> cd CommunityPath/
C:\> python odoo-bin -r dbuser -w dbpassword --addons-path=addons -d mydb
其中 CommunityPath 是 Odoo Community 安裝路徑,dbuser 是 PostgreSQL 登入名稱,dbpassword 是 PostgreSQL 密碼,mydb 是 PostgreSQL 資料庫名稱。
$ cd /CommunityPath
$ python3 odoo-bin --addons-path=addons -d mydb
其中 CommunityPath 是 Odoo Community 安裝路徑,mydb 是 PostgreSQL 資料庫名稱。
伺服器啟動後(印出 INFO 日誌 odoo.modules.loading: Modules loaded.),在網頁瀏覽器中開啟 http://localhost:8069,並使用基本管理員帳戶登入 Odoo 資料庫:使用 admin 作為電子郵件,再次使用 admin 作為密碼。
小訣竅
接著,建立和管理新的:doc:
使用者 <../../applications/general/users>。用於登入 Odoo 網頁介面的使用者帳戶與
--db_userCLI 引數不同。