如何在 Ubuntu 24 上完整自架 Dify.ai:詳細教學指南

, ,

如何在 Ubuntu 24 上完整自架 Dify.ai:詳細教學指南

想自己架設 Dify.ai 嗎?這款開源的 LLM 應用開發平台能讓你快速打造 AI 應用,無論是技術人員還是非技術人員都能輕鬆上手。以下是一步步的完整教學,從環境準備到實際部署,讓你順利在 Ubuntu 24 上運行 Dify。


環境準備

  1. 系統需求

    • Ubuntu 24.04 LTS(或更新版本)
    • 最低配置:2 核 CPU / 4GB RAM / 20GB 硬碟
    • 推薦配置:4 核 CPU / 8GB RAM / 40GB 硬碟(若需運行更複雜的模型)
  2. 更新系統
    先確保系統是最新的,避免後續安裝問題:

    sudo apt update && sudo apt upgrade -y
    sudo apt autoremove
    sudo apt autoclean
    

    完成後重啟:

    sudo reboot
    
  3. 安裝 Docker
    Dify 依賴 Docker 運行,以下是官方推薦的安裝方式:

    # 移除舊版 Docker(若有的話)
    for pkg in docker.io docker-doc docker-compose podman-docker containerd runc; do sudo apt remove $pkg; done
    
    # 加入 Docker 官方 GPG 金鑰
    sudo apt install -y ca-certificates curl
    sudo install -m 0755 -d /etc/apt/keyrings
    sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
    sudo chmod a+r /etc/apt/keyrings/docker.asc
    
    # 加入 Docker 的 apt 來源
    echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
    sudo apt update
    
    # 安裝 Docker
    sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
    

    驗證安裝是否成功:

    sudo docker run hello-world
    

    若看到 Hello from Docker! 表示安裝成功。

  4. 設定非 root 用戶權限(可選)
    避免每次都要用 sudo 執行 Docker:

    sudo groupadd docker
    sudo usermod -aG docker $USER
    newgrp docker
    

    重新登入後測試:

    docker run hello-world
    

安裝 Dify

  1. 下載 Dify 原始碼

    git clone https://github.com/langgenius/dify.git
    cd dify/docker
    
  2. 設定環境變數
    複製範本並修改 .env 檔案:

    cp .env.example .env
    nano .env
    

    關鍵設定(依需求調整):

    OPENAI_API_KEY=sk-your-api-key-here  # 若使用 OpenAI 模型
    DB_PASSWORD=your_db_password         # 自訂資料庫密碼
    
  3. 啟動 Dify
    使用 Docker Compose 啟動服務:

    docker-compose up -d
    

    這會啟動以下容器:

    • dify-api(後端服務)
    • dify-web(前端介面)
    • PostgreSQL(資料庫)
    • Redis(快取)
  4. 驗證服務
    檢查容器狀態:

    docker ps
    

    若一切正常,瀏覽器開啟 http://localhost 即可看到 Dify 登入頁面。


常見問題與解決方案

  1. 登入問題(401 錯誤)
    若遇到跨域問題,檢查 .env 中的 CONSOLE_CORS_ALLOW_ORIGINSWEB_API_CORS_ALLOW_ORIGINS 是否設為 * 或正確的網域。

  2. 密碼重置
    若忘記密碼,可透過以下指令重置:

    docker exec -it dify-api-1 flask reset-password
    
  3. 儲存空間不足
    若 Docker 鏡像下載失敗,清理舊鏡像:

    docker system prune -a
    

進階設定

  1. 使用自訂模型(如 Llama 或 Qwen)
    .env 中指定本地模型端點:

    LOCAL_MODEL_ENDPOINT=http://your-model-server:port
    
  2. SSL 加密(Nginx + Let’s Encrypt)
    若需對外公開服務,建議設定 HTTPS:

    sudo apt install -y nginx certbot python3-certbot-nginx
    sudo certbot --nginx -d your-domain.com
    

結論

透過上述步驟,你已成功在 Ubuntu 24 上自架 Dify.ai!無論是個人專案或企業應用,Dify 的彈性架構都能滿足需求。若有更多疑問,可參考 官方文件 或社群討論。

現在就動手打造你的 AI 應用吧! :rocket: