本文较长，建议点赞收藏。更多AI大模型应用开发学习视频及资料，在智泊AI。
目标：在 Windows 系统上通过 Docker 快速部署 Dify，支持中文环境，提升访问速度并合理管理磁盘空间。
一、准备工作
1. 安装 Docker Desktop
Dify 使用 Docker 进行容器化部署，因此需要先安装 Docker。
●下载地址：www.docker.com/products/do…
●双击安装包，按照提示完成安装。
●安装完成后启动 Docker Desktop，确保其正常运行（右下角系统托盘出现鲸鱼图标 ✅）。
⚠️ 注意：首次启动可能需要几分钟，等待“Docker Desktop is running”提示。
✅ 可选优化设置
🔧 1. 更改 Docker 镜像源（推荐国内用户）
由于默认镜像源在国外，拉取镜像速度慢，建议配置国内镜像加速器。
操作步骤：
1.右键点击 Docker Desktop 图标 → Settings → Docker Engine
2.修改或添加 registry-mirrors，例如使用中科大镜像加速：
{
"registry-mirrors": [
"https://docker.mirrors.ustc.edu.cn",
"https://registry.docker-cn.com"
]
}
3.点击 Apply & Restart 生效。
🗂️ 2. 更改 Docker 数据存储目录（避免 C 盘爆满）
默认情况下，Docker 所有镜像和容器数据都保存在 C 盘，长期使用容易占满。
操作步骤：
1.Settings → Resources → Advanced
2.修改 Disk image location 到其他盘（如 D:\Docker）
3.点击 Apply & Restart
⚠️ 此操作会迁移现有数据，可能耗时较长，请耐心等待。
2. 安装 Git
用于克隆 Dify 项目源码。
●下载地址：git-scm.com/downloads/w…
●安装过程一路默认即可。
●安装完成后打开命令行（CMD 或 PowerShell），验证是否成功：
git --version
输出示例：
git version 2.xx.x.windows.1
表示安装成功 ✅
二、部署 Dify 项目
1. 克隆 Dify 仓库
打开命令行工具（推荐 PowerShell 或 Git Bash），执行：
git clone https://github.com/langgenius/dify.git
📁 默认会在当前目录创建
dify文件夹。
进入 Docker 配置目录：
cd dify/docker
2. 配置环境变量文件
复制示例环境变量文件为正式配置：
cp .env.example .env
💡 此文件包含数据库、API 密钥等关键配置，
.env.example是模板，.env是实际运行使用的文件。
3. （可选）修改端口配置
打开 .env 文件（可用记事本或 VS Code 编辑），找到以下行：
env
# HTTP port
NGINX_PORT=80
# SSL settings are only applied when HTTPS_ENABLED is true
NGINX_SSL_PORT=443
EXPOSE_NGINX_PORT=80
EXPOSE_NGINX_SSL_PORT=443
如果你的 80 或 443 端口被占用（如 IIS、Apache、Nginx 等服务），建议修改对外暴露端口：
env
EXPOSE_NGINX_PORT=8080
EXPOSE_NGINX_SSL_PORT=8443
✅ 例如改为
8080，则后续通过http://localhost:8080访问 Dify。
三、启动 Dify 服务
确保你在 dify/docker 目录下，运行：
docker compose up -d
首次运行会自动：
●拉取所需镜像（如 PostgreSQL、Redis、Web、API 等）
●创建容器
●初始化数据库
启动成功后，终端输出类似：
docker运行状态
四、验证部署是否成功
1. 查看容器运行状态
docker ps
确保所有容器状态为 Up。
2. 访问 Dify 网页界面
打开浏览器，输入：
http://localhost
或你修改过的端口，如：
http://localhost:8080
✅ 正常情况下第一次等待一会儿将看到 Dify 登录/注册页面，表示部署成功！
部署成功页面
五、常用命令
| 功能 | 命令 |
|---|---|
| 停止服务 | docker compose down |
| 重启服务 | docker compose restart |
| 查看日志 | docker compose logs 或 docker compose logs api |
| 删除容器和数据（重置） | docker compose down -v |
⚠️
-v会删除数据卷（包括数据库），慎用！
六、常见问题排查
❌ 端口被占用？
错误提示如：
(HTTP code 500) server error - Ports are not available: exposing port TCP 0.0.0.0:80 -> 127.0.0.1:0: listen tcp 0.0.0.0:80: bind: An attempt was made to access a socket in a way forbidden by its access permissions.
解决方法：
●使用 netstat -ano | findstr :80 查看占用进程
●结束占用进程，或修改 .env 中的 EXPOSE_NGINX_PORT
🐢 镜像拉取缓慢？
请确认已配置国内镜像源（见上文）。
🧱 构建失败或启动异常？
尝试清理后重新拉取：
docker compose down -v
docker system prune -a --volumes
然后重新执行 docker compose up -d
✅ 总结
通过以上步骤，你已经成功在本地 Windows 系统部署了 Dify，可用于开发、测试或学习 AI 应用构建。
🎉 恭喜！现在你可以开始使用 Dify 创建属于你自己的 AI 应用了！
学习资源推荐
如果你想更深入地学习大模型，以下是一些非常有价值的学习资源，这些资源将帮助你从不同角度学习大模型，提升你的实践能力。
本文较长，建议点赞收藏。更多AI大模型应用开发学习视频及资料，在智泊AI。
