跳轉至

建立 2026-09-14 更新 2026-09-14

安裝與環境

把 Odoo 跑起來有好幾條路。本頁先講清差異，再給本機最快的 Docker 起步方式。正式上線、備份與反向代理見 Docker 部署。

官方 Docker 映像通常已內建 wkhtmltopdf；若你用原始碼或精簡套件安裝，請另外安裝 wkhtmltopdf，否則部分 QWeb PDF 報表會無法產生。

三種使用方式

方式 適合誰 優點 限制
Odoo Online 只要用、不要自己管主機 官方代管、自動更新 難放自訂模組；功能偏企業版
Odoo.sh 要客製、但不要自己顧伺服器 Git 部署、測試／正式環境 付費平台
自己安裝（本站重點） 學習、社群版、完全掌控 可 Docker、可放 extra-addons 要自己備份與更新

自己安裝又分成：套件安裝（deb/rpm）、原始碼安裝（Python venv）、以及 Docker。學習與交付客戶時，優先用 Docker，版本固定、換電腦也容易重現。

社群版與企業版

  • 社群版（Community）：開源，本站範例使用官方映像 odoo:18.0。含銷售、庫存、製造、開立發票等核心功能。
  • 企業版（Enterprise）：完整會計、Studio、更多產業 App。不可與社群版模組混裝在未授權環境。
  • 完整會計（銀行對帳、資產、進階財報）多半是企業版；社群版仍可開立發票與登錄收付款。缺口可用 OCA 模組補強。

版本要對齊

資料庫、自訂模組與 Odoo 主程式必須同一大版（例如都是 18.0）。用 17 的模組裝進 18 通常會失敗。

本機快速啟動（Docker）

先安裝 Docker Desktop。在空資料夾建立 docker-compose.yml：

services:
  odoo:
    image: odoo:18.0
    container_name: odoo18
    depends_on:
      - db
    ports:
      - "8069:8069"
    environment:
      HOST: db
      USER: odoo
      PASSWORD: odoo
    volumes:
      - odoo-web-data:/var/lib/odoo
      - ./addons:/mnt/extra-addons
    restart: unless-stopped

  db:
    image: postgres:16
    container_name: odoo18-db
    environment:
      POSTGRES_DB: postgres
      POSTGRES_USER: odoo
      POSTGRES_PASSWORD: odoo
    volumes:
      - odoo-db-data:/var/lib/postgresql/data
    restart: unless-stopped

volumes:
  odoo-web-data:
  odoo-db-data:

mkdir addons
docker compose up -d

瀏覽器開啟 http://localhost:8069。

Compose 檔不再需要 version

舊範例常寫 version: '3.8'。新版 Docker Compose 已忽略此欄，可省略。

第一次建立資料庫

  1. 設定主密碼（Master Password），之後用來建立或刪除資料庫，請用強密碼並記下來。
  2. 資料庫名稱用英文（例如 odoodb）。
  3. 電子郵件與密碼是管理員帳號，與主密碼不同。
  4. 語言選「Chinese (Traditional) / 繁體中文」；國家選 Taiwan，稅務與地址格式會較接近本地。
  5. 示範資料（Demo data）適合練習，正式環境不要勾。

進入後台後：設定 → 啟動開發人員模式（或網址加 ?debug=1）。開發人員模式才能看到技術名稱、匯入匯出與技術選單。

常用啟動參數

若你用原始碼或進入容器執行 odoo：

參數 作用
-d 資料庫名 指定資料庫
-i 模組名 安裝模組
-u 模組名 升級模組（改 Python／XML 後必做）
--dev=reload,qweb,xml 開發時自動重載（勿用於正式環境）

自訂模組放在掛載的 ./addons，並在 odoo.conf 把該路徑加入 addons_path。完整設定見 Docker 部署。

本機開發還是正式上線？

  • 只想先點給看：用本頁的最小 Compose。
  • 要測信件、每日備份、devcontainer：用 Docker 部署 的開發堆疊。
  • 要 HTTPS 與網域：用同一頁的正式環境，或 完整堆疊。
  • 正式環境要寄信到外面：設定 郵件。

進一步學習