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

, ,
1

如何在 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_ORIGINS 和 WEB_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: