Dify 本地部署安装教程（Windows + Docker）

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 编辑），找到以下行：

# 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 服务

确保你在 dify/docker 目录下，运行：

docker compose up -d

首次运行会自动：

• 拉取所需镜像（如 PostgreSQL、Redis、Web、API 等）
• 创建容器
• 初始化数据库

启动成功后，终端输出类似 docker 运行状态信息。

四、验证部署是否成功

1. 查看容器运行状态

docker ps

确保所有容器状态为 Up。

2. 访问 Dify 网页界面

打开浏览器，输入：

http://localhost

或你修改过的端口，如：

http://localhost:8080

✅ 正常情况下第一次等待一会儿将看到 Dify 登录/注册页面，表示部署成功！

五、常用命令

⚠️ -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 应用构建。