Windows環境下Docker部署Dify完整指南

📋 目錄

• 系統要求
• Docker安裝
• 驗證Docker安裝
• Dify部署
• 訪問Dify
• 常見問題
• 管理命令

---

🖥? 系統要求

在開始安裝之前，請確保你的Windows系統滿足以下要求：

硬件要求

• CPU: >= 2核心
• 內存: >= 4GB RAM
• 硬盤: >= 10GB 可用空間

系統要求

• 操作系統: Windows 10/11 (64位)
• WSL2: Windows Subsystem for Linux 2 (Docker Desktop會自動安裝)
• 虛擬化: 需要開啟Hyper-V或WSL2

---

🐳 Docker安裝

步驟1：下載Docker Desktop

1. 訪問Docker官方網站：https://www.docker.com/products/docker-desktop/
2. 點擊 “Download for Windows” 按鈕
3. 下載 Docker Desktop Installer.exe 安裝程序

步驟2：安裝Docker Desktop

1. 運行安裝程序：雙擊下載的 Docker Desktop Installer.exe
2. 選擇配置：
   • ? 勾選 “Use WSL 2 instead of Hyper-V”（推薦）
   • ? 勾選 “Add shortcut to desktop”
3. 等待安裝完成：安裝過程需要幾分鐘
4. 重啟計算機：安裝完成后重啟系統

步驟3：啟動Docker Desktop

1. 從桌面或開始菜單啟動 Docker Desktop
2. 等待Docker引擎啟動（狀態顯示為綠色"Running"）
3. 首次啟動可能需要幾分鐘時間

---

? 驗證Docker安裝

打開 PowerShell 或 命令提示符，執行以下命令驗證安裝：

檢查Docker版本

docker --version

預期輸出示例：

Docker version 24.0.7, build afdd53b

檢查Docker Compose版本

docker compose version

預期輸出示例：

Docker Compose version v2.21.0

運行測試容器

docker run hello-world

預期輸出示例：

Hello from Docker!
This message shows that your installation appears to be working correctly.

? 如果以上命令都正常執行，說明Docker安裝成功！

---

🚀 Dify部署

步驟1：獲取Dify源碼

方法一：從GitHub下載

1. 訪問：https://github.com/langgenius/dify
2. 點擊綠色的 “Code” 按鈕
3. 選擇 “Download ZIP”
4. 解壓到本地目錄（如：D:\dify-main）

方法二：使用Git克隆（推薦）

git clone https://github.com/langgenius/dify.git
cd dify

步驟2：進入Docker目錄

cd docker

步驟3：配置環境變量

根據你使用的終端選擇對應命令：

# Windows命令提示符(CMD)
copy .env.example .env# PowerShell
Copy-Item .env.example .env# Git Bash 或 WSL
cp .env.example .env

💡 提示：.env文件包含了Dify的所有配置參數，默認配置適合大多數用戶。如需自定義，可以編輯此文件。

步驟4：啟動Dify服務

docker compose up -d

首次啟動會下載所需鏡像，可能需要10-15分鐘時間，請耐心等待。

步驟5：驗證部署狀態

docker compose ps

預期輸出示例：

NAME                     IMAGE                                       STATUS
docker-api-1             langgenius/dify-api:1.4.2                   Up 2 minutes
docker-db-1              postgres:15-alpine                          Up 2 minutes (healthy)
docker-nginx-1           nginx:latest                                Up 2 minutes
docker-redis-1           redis:6-alpine                              Up 2 minutes (healthy)
docker-web-1             langgenius/dify-web:1.4.2                   Up 2 minutes
docker-weaviate-1        semitechnologies/weaviate:1.19.0            Up 2 minutes
...

? 看到所有服務狀態為"Up"表示部署成功！

---

🌐 訪問Dify

打開Dify界面

1. 打開瀏覽器訪問：http://localhost
2. 首次訪問會自動跳轉到安裝頁面：http://localhost/install

初始化設置

1. 設置管理員賬戶

   • 輸入郵箱地址
   • 設置密碼（至少8位）
   • 輸入管理員姓名

2. 完成初始化

   • 點擊"下一步"
   • 等待系統初始化完成

3. 開始使用

   • 登錄成功后即可開始使用Dify
   • 探索AI應用構建功能

---

? 常見問題

Q1: Docker啟動失敗？

解決方案：

• 確保Windows已開啟虛擬化功能
• 檢查是否正確安裝WSL2
• 重啟Docker Desktop服務

Q2: 端口80被占用？

解決方案：

# 查看占用端口80的進程
netstat -ano | findstr :80# 修改docker-compose.yaml中的端口映射
# 將 "80:80" 改為 "8080:80"

Q3: 容器啟動失敗？

解決方案：

# 查看詳細日志
docker compose logs# 重新啟動服務
docker compose restart

Q4: 訪問頁面顯示502錯誤？

解決方案：

# 檢查API服務狀態
docker compose logs api# 重啟API服務
docker compose restart api

---

🛠? 管理命令

服務管理

# 啟動所有服務
docker compose up -d# 停止所有服務
docker compose down# 重啟所有服務
docker compose restart# 查看服務狀態
docker compose ps

日志查看

# 查看所有服務日志
docker compose logs# 查看特定服務日志
docker compose logs api
docker compose logs web
docker compose logs nginx# 實時查看日志
docker compose logs -f

數據管理

# 停止服務并刪除數據
docker compose down -v# 更新鏡像
docker compose pull
docker compose up -d

系統清理

# 清理未使用的鏡像
docker image prune# 清理未使用的容器
docker container prune# 清理未使用的網絡
docker network prune

---

🎯 下一步

恭喜！你已經成功在Windows環境下部署了Dify。現在你可以：

1. 探索Dify功能

   • 創建AI應用
   • 設計工作流
   • 配置知識庫

2. 學習更多

   • 訪問Dify官方文檔
   • 查看GitHub倉庫
   • 加入Discord社區

3. 進階配置

   • 自定義環境變量
   • 配置外部數據庫
   • 設置域名訪問

---

📞 獲取幫助

如果遇到問題，可以通過以下方式獲取幫助：

• 官方文檔: https://docs.dify.ai
• GitHub Issues: https://github.com/langgenius/dify/issues
• Discord社區: https://discord.gg/FngNHpbcY7
• Reddit社區: https://reddit.com/r/difyai

---

🎉 祝你使用Dify愉快！開始構建你的AI應用吧！