Dify 本地部署安装教程(Windows + Docker)
在 Windows 系统上通过 Docker 部署 Dify 的完整流程。包括安装 Docker Desktop 与 Git,配置国内镜像源及存储目录,克隆项目源码并设置环境变量。支持端口自定义修改,使用 docker compose 启动服务。提供容器状态查看、网页访问验证及常用运维命令。涵盖端口占用、镜像拉取慢、构建失败等常见问题的排查方案,适用于本地 AI 应用开发与测试环境的搭建。

在 Windows 系统上通过 Docker 部署 Dify 的完整流程。包括安装 Docker Desktop 与 Git,配置国内镜像源及存储目录,克隆项目源码并设置环境变量。支持端口自定义修改,使用 docker compose 启动服务。提供容器状态查看、网页访问验证及常用运维命令。涵盖端口占用、镜像拉取慢、构建失败等常见问题的排查方案,适用于本地 AI 应用开发与测试环境的搭建。

目标:在 Windows 系统上通过 Docker 快速部署 Dify,支持中文环境,提升访问速度并合理管理磁盘空间。
Dify 使用 Docker 进行容器化部署,因此需要先安装 Docker。
⚠️ 注意:首次启动可能需要几分钟,等待'Docker Desktop is running'提示。
由于默认镜像源在国外,拉取镜像速度慢,建议配置国内镜像加速器。
操作步骤:
Settings → Docker Engineregistry-mirrors,例如使用中科大镜像加速:{
"registry-mirrors": [
"https://docker.mirrors.ustc.edu.cn",
"https://registry.docker-cn.com"
]
}
Apply & Restart 生效。默认情况下,Docker 所有镜像和容器数据都保存在 C 盘,长期使用容易占满。
操作步骤:
Settings → Resources → AdvancedDisk image location 到其他盘(如 D:\Docker)Apply & Restart⚠️ 此操作会迁移现有数据,可能耗时较长,请耐心等待。
用于克隆 Dify 项目源码。
git --version
输出示例:
git version 2.xx.x.windows.1
表示安装成功 ✅
打开命令行工具(推荐 PowerShell 或 Git Bash),执行:
git clone https://github.com/langgenius/dify.git
📁 默认会在当前目录创建
dify文件夹。
进入 Docker 配置目录:
cd dify/docker
复制示例环境变量文件为正式配置:
cp .env.example .env
💡 此文件包含数据库、API 密钥等关键配置,
.env.example是模板,.env是实际运行使用的文件。
打开 .env 文件(可用记事本或 VS Code 编辑),找到以下行:
# 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 等服务),建议修改对外暴露端口:
EXPOSE_NGINX_PORT=8080
EXPOSE_NGINX_SSL_PORT=8443
✅ 例如改为
8080,则后续通过http://localhost:8080访问 Dify。
确保你在 dify/docker 目录下,运行:
docker compose up -d
首次运行会自动:
启动成功后,终端输出类似:

docker 运行状态
docker ps
确保所有容器状态为 Up。
打开浏览器,输入:
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 应用了!

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
使用加密算法(如AES、TripleDES、Rabbit或RC4)加密和解密文本明文。 在线工具,加密/解密文本在线工具,online
生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具,curl 转代码在线工具,online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online