AI Workflow整合的第二選項 : Dify

在n8n之外,你還有其他選擇,Dify。他也是眾多開源開發者熱愛的選項。先不用急著被n8n綁架,因為Dify也能在本地端安裝使用。

讓我們快速看一下整合流程:

根據 Dify 官方文檔,在 Windows 環境下從**原始碼(Source Code)**開始安裝 Dify,主要分為準備環境、啟動中間件、配置後端以及配置前端四個大步驟。

以下是為你整理的中文詳細流程:


一、 環境準備(Prerequisites)

在開始之前,請確保你的 Windows 電腦滿足以下要求:

  1. 系統硬體:CPU >= 2 Core, RAM >= 4 GiB。

  2. Docker Desktop:必須安裝並啟用 WSL 2 模式

  3. Python 環境:建議安裝 Python 3.10+。

  4. Node.js:版本 v22 (LTS) 或更高。

  5. Git:用於複製程式碼。

  6. 工具軟體

    • uv:用於管理 Python 依賴(官方推薦)。

    • PNPM:用於管理前端依賴(npm i -g pnpm)。


二、 複製原始碼與啟動中間件

Dify 的核心數據存儲(PostgreSQL, Redis 等)是透過 Docker 運行的。

  1. 複製倉庫: 打開終端機(PowerShell 或 Git Bash),執行:

    Bash
    git clone https://github.com/langgenius/dify.git
    cd dify
    
  2. 啟動中間件: 進入 docker 目錄並啟動必要的基礎服務:

    Bash
    cd docker
    cp middleware.env.example middleware.env
    # 使用 Docker 啟動資料庫與向量資料庫
    docker compose -f docker-compose.middleware.yaml --profile postgresql --profile weaviate -p dify up -d
    

三、 後端服務配置(API 與 Worker)

  1. 進入 API 目錄

    Bash
    cd ../api
    
  2. 配置環境變數

    • 複製並重新命名配置檔:cp .env.example .env

    • 生成 SECRET_KEY:在 .env 中找到 SECRET_KEY,隨機填入一串長字串。

  3. 安裝 Python 依賴(使用 uv):

    Bash
    uv sync --dev
    
  4. 執行資料庫遷移(Migration)

    Bash
    uv run flask db upgrade
    
  5. 啟動 API 服務

    Bash
    uv run flask run --host 0.0.0.0 --port=5001 --debug
    
  6. 啟動 Worker 服務Windows 專用指令): 打開另一個新的終端機視窗,進入 api 目錄執行:

    Bash
    uv run celery -A app.celery worker -P solo --without-gossip --without-mingle --loglevel INFO -Q dataset,dataset_summary,priority_dataset,priority_pipeline,pipeline,mail,ops_trace,app_deletion,plugin,workflow_storage,conversation,workflow,schedule_poller,schedule_executor,triggered_workflow_dispatcher,trigger_refresh_executor,retention,workflow_based_app_execution
    

    注意:Windows 必須使用 -P solo 參數。


四、 前端網頁配置(Web Service)

  1. 進入 Web 目錄

    Bash
    cd ../web
    
  2. 安裝前端依賴

    Bash
    pnpm install --frozen-lockfile
    
  3. 配置環境變數: 創建一個名為 .env.local 的文件,並從 .env.example 複製內容。確認以下設定(預設通常正確):

    • NEXT_PUBLIC_API_PREFIX=http://localhost:5001/console/api

    • NEXT_PUBLIC_PUBLIC_API_PREFIX=http://localhost:5001/api

  4. 編譯並啟動前端

    Bash
    pnpm build
    pnpm start
    # 或者開發模式下直接使用:
    pnpm dev
    

五、 存取 Dify

當一切啟動成功後,打開瀏覽器存取: 👉 http://localhost:3000

你將會看到 Dify 的設置介面,設定管理員帳號後即可開始使用。

💡 小提示:

  • WSL 2 效能:官方強烈建議將 Dify 原始碼存放在 WSL 2 的 Linux 文件系統內(例如 \\wsl$\Ubuntu\home\...),而不是 Windows 的磁碟機(如 C:\),這能大幅提升運行速度。

  • FFmpeg:如果你需要使用 OpenAI TTS(語音轉文字),請確保你的 Windows 系統中已安裝並配置好 FFmpeg 路徑。

留言

這個網誌中的熱門文章

[Security] wpa_supplicant setup

[我的MAC Air] 2012年中,MAC Air SSD升級

[拆機] Nexus5 更換背蓋、電池