如何在 Ubuntu 24 上完整自架 Dify.ai:詳細教學指南
想自己架設 Dify.ai 嗎?這款開源的 LLM 應用開發平台能讓你快速打造 AI 應用,無論是技術人員還是非技術人員都能輕鬆上手。以下是一步步的完整教學,從環境準備到實際部署,讓你順利在 Ubuntu 24 上運行 Dify。
環境準備
-
系統需求
- Ubuntu 24.04 LTS(或更新版本)
- 最低配置:2 核 CPU / 4GB RAM / 20GB 硬碟
- 推薦配置:4 核 CPU / 8GB RAM / 40GB 硬碟(若需運行更複雜的模型)
-
更新系統
先確保系統是最新的,避免後續安裝問題:sudo apt update && sudo apt upgrade -y sudo apt autoremove sudo apt autoclean
完成後重啟:
sudo reboot
-
安裝 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!
表示安裝成功。 -
設定非 root 用戶權限(可選)
避免每次都要用sudo
執行 Docker:sudo groupadd docker sudo usermod -aG docker $USER newgrp docker
重新登入後測試:
docker run hello-world
安裝 Dify
-
下載 Dify 原始碼
git clone https://github.com/langgenius/dify.git cd dify/docker
-
設定環境變數
複製範本並修改.env
檔案:cp .env.example .env nano .env
關鍵設定(依需求調整):
OPENAI_API_KEY=sk-your-api-key-here # 若使用 OpenAI 模型 DB_PASSWORD=your_db_password # 自訂資料庫密碼
-
啟動 Dify
使用 Docker Compose 啟動服務:docker-compose up -d
這會啟動以下容器:
dify-api
(後端服務)dify-web
(前端介面)PostgreSQL
(資料庫)Redis
(快取)
-
驗證服務
檢查容器狀態:docker ps
若一切正常,瀏覽器開啟
http://localhost
即可看到 Dify 登入頁面。
常見問題與解決方案
-
登入問題(401 錯誤)
若遇到跨域問題,檢查.env
中的CONSOLE_CORS_ALLOW_ORIGINS
和WEB_API_CORS_ALLOW_ORIGINS
是否設為*
或正確的網域。 -
密碼重置
若忘記密碼,可透過以下指令重置:docker exec -it dify-api-1 flask reset-password
-
儲存空間不足
若 Docker 鏡像下載失敗,清理舊鏡像:docker system prune -a
進階設定
-
使用自訂模型(如 Llama 或 Qwen)
在.env
中指定本地模型端點:LOCAL_MODEL_ENDPOINT=http://your-model-server:port
-
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 應用吧!