Dify入門系列（2）| 5 分鐘部署 Dify：云服務 vs 本地 Docker

無需算法團隊，無需 GPU 服務器，只需一臺普通電腦或云賬號，5 分鐘即可搭建企業(yè)級 AI 開發(fā)平臺。本文手把手對比 云服務直裝 和 本地 Docker 部署 兩種方案，附避坑指南與性能實測！

一、云服務部署：3 分鐘極速開箱

適合人群：快速驗證原型 · 中小企業(yè)輕量化使用 核心優(yōu)勢：零運維、免費用量額度、自動升級

操作步驟：

1. 注冊登錄 ?? 訪問 Dify 官網(wǎng) → 點擊「免費開始」→ 用郵箱/GitHub 賬號注冊

   國內(nèi)用戶推薦選擇 亞太節(jié)點（新加坡/東京），延遲更低

2. 創(chuàng)建應用

   e4af6a2d-5a45-4ff0-88fc-d34e90c24cf5.png

3. 配置模型

   免費額度：新用戶贈送 $1 的 GPT-3.5 調(diào)用額度

• 進入「模型供應商」→ 選擇 OpenAI/Claude/通義千問
• 填入 API Key（云服務自動代理請求，無需暴露 Key 給客戶端）

5. 立即體驗

   <pre style="-webkit-tap-highlight-color: transparent; margin: 10px 0px; padding: 0px; outline: 0px; max-width: 100%; box-sizing: border-box !important; overflow-wrap: break-word !important; border-radius: 5px; box-shadow: rgba(0, 0, 0, 0.55) 0px 2px 10px; text-align: left;"># 通過 API 測試 curl -X POST "https://api.dify.ai/v1/chat-messages" \ -H "Authorization: Bearer YOUR_API_KEY" \ -d '{"inputs": {}, "query": "你好"}' </pre>

• 進入應用 → 點擊「發(fā)布」→ 通過 Web/API 接入

?? 云服務優(yōu)缺點：

二、本地 Docker 部署：5 分鐘構(gòu)建私有環(huán)境

適合人群：金融/醫(yī)療等強合規(guī)場景 · 需要連接內(nèi)網(wǎng)系統(tǒng) 核心優(yōu)勢：數(shù)據(jù) 100% 私有化 · 自定義 GPU 加速

操作步驟：

1. 環(huán)境準備

• 最低配置：Linux/MacOS/Windows WSL2 · 4核 CPU · 8GB 內(nèi)存 · 20GB 磁盤
• 安裝 Docker 及 Docker Compose

3. 一鍵啟動

   <pre style="-webkit-tap-highlight-color: transparent; margin: 10px 0px; padding: 0px; outline: 0px; max-width: 100%; box-sizing: border-box !important; overflow-wrap: break-word !important; border-radius: 5px; box-shadow: rgba(0, 0, 0, 0.55) 0px 2px 10px; text-align: left;"># 下載官方 compose 文件 curl -O https://raw.githubusercontent.com/langgenius/dify/main/docker/docker-compose.yaml # 啟動服務（首次啟動自動拉鏡像） docker-compose up -d # 查看日志（出現(xiàn) Listening at http://0.0.0.0:80 即成功） docker-compose logs -f </pre>

4. 訪問控制臺

• 瀏覽器打開 http://localhost（默認賬號：admin@dify.ai，密碼：difyai.com）
• 立即修改密碼！ → 進入「系統(tǒng)設置」重置

6. 配置本地模型（關(guān)鍵步驟）

   <pre style="-webkit-tap-highlight-color: transparent; margin: 10px 0px; padding: 0px; outline: 0px; max-width: 100%; box-sizing: border-box !important; overflow-wrap: break-word !important; border-radius: 5px; box-shadow: rgba(0, 0, 0, 0.55) 0px 2px 10px; text-align: left;"># 編輯 docker-compose.yaml，添加 Ollama 本地模型服務 services: ollama: image:ollama/ollama ports: -"11434:11434" volumes: -ollama:/root/.ollama </pre>

   <pre style="-webkit-tap-highlight-color: transparent; margin: 10px 0px; padding: 0px; outline: 0px; max-width: 100%; box-sizing: border-box !important; overflow-wrap: break-word !important; border-radius: 5px; box-shadow: rgba(0, 0, 0, 0.55) 0px 2px 10px; text-align: left;"># 啟動 Llama3 中文優(yōu)化版 docker exec -it dify-ollama ollama run qwen:4b-chat # Dify 控制臺添加模型 模型類型：OpenAI 兼容 端點：http://ollama:11434/v1 模型名稱：qwen:4b-chat </pre>

?? 私有化部署調(diào)優(yōu)技巧

三、方案對比：按需選擇最優(yōu)解

實測數(shù)據(jù)：本地部署運行 Qwen-4B 模型，單條查詢響應 <2s（RTX 3060 GPU）

四、避坑指南：高頻問題解決方案

1. 鏡像拉取失敗

   <pre style="-webkit-tap-highlight-color: transparent; margin: 10px 0px; padding: 0px; outline: 0px; max-width: 100%; box-sizing: border-box !important; overflow-wrap: break-word !important; border-radius: 5px; box-shadow: rgba(0, 0, 0, 0.55) 0px 2px 10px; text-align: left;"># 替換國內(nèi)鏡像源 sed -i 's/ghcr.io/mirror.ghcr.io/g' docker-compose.yaml </pre>

2. 端口沖突（本地 80 端口被占）

   <pre style="-webkit-tap-highlight-color: transparent; margin: 10px 0px; padding: 0px; outline: 0px; max-width: 100%; box-sizing: border-box !important; overflow-wrap: break-word !important; border-radius: 5px; box-shadow: rgba(0, 0, 0, 0.55) 0px 2px 10px; text-align: left;"># 修改 compose 文件端口映射 services: dify-web: ports: - "8080:80" # 改為 8080 端口 </pre>

3. 知識庫上傳失敗

• 檢查文件：僅支持 PDF/TXT/Markdown/Word
• 內(nèi)存不足：增加 Docker 內(nèi)存限制 docker-compose.yml → mem_limit: 4096m

五、總結(jié)：兩條路徑，同一目標

• 云服務是快速驗證的“輕騎兵”，適合敏捷迭代；
• 本地 Docker 是數(shù)據(jù)自主的“堡壘機”，滿足合規(guī)剛需。

無論選擇哪種方式，Dify 都大幅降低了 AI 應用的門檻。

推薦學習

行業(yè)首個「知識圖譜+測試開發(fā)」深度整合課程【人工智能測試開發(fā)訓練營】，贈送智能體工具。提供企業(yè)級解決方案，人工智能的管理平臺部署，實現(xiàn)智能化測試，落地大模型，實現(xiàn)從傳統(tǒng)手工轉(zhuǎn)向用AI和自動化來實現(xiàn)測試，提升效率和質(zhì)量。

image.png