手把手教你本地部署 Dify

Dify 是一个开源项目，支持可视化编排 AI 工作流、RAG 管道，并集成了大量模型。最重要的是，自托管部署非常方便，只需几条命令。

准备工作

确保你已经具备：

• ✅ Docker Desktop 正常运行（docker version有 Server 信息）

• ✅ WSL2 后端已启用（或 Hyper-V，但推荐 WSL2）

• ✅ 至少 4GB 可用内存（建议 8GB+）

• ✅ 稳定的网络连接（首次需拉取镜像）

  第一步：获取 Dify 源代码

  进入 Dify 的 GitHub 官方仓库：
  👉 https://github.com/langgenius/dify

• 点击页面上的Code按钮，选择Download ZIP，下载最新版本的压缩包。

  下载完成后，解压缩到你喜欢的目录（比如D:\dify）。解压后你会得到一个名为dify-main（或类似名称）的文件夹，后续所有操作都在这个文件夹内进行。

  第二步：进入 Docker 目录并配置环境变量

  打开解压后的dify-main文件夹，右键点击空白处（或在地址栏），选择“在终端中打开”（Windows 11 可直接右键“在终端中打开”）。

  进入docker子目录：

  bash

  cd docker

  现在，我们需要复制示例环境变量文件，生成正式配置：

  bash

  cp .env.example .env

  用记事本、VS Code 或其他编辑器打开刚刚生成的.env文件。

  找到这一行：

  text

  EXPOSE_NGINX_PORT=80

  将其改为：

  text

  EXPOSE_NGINX_PORT=8080

  这样，后续我们就可以通过http://localhost:8080来访问 Dify 界面了。如果端口 80 未被占用，你也可以保留默认值，但 8080 更通用，避免冲突。

  保存文件并关闭。

  第三步：一键启动 Dify 服务

  依然在dify/docker目录下，执行启动命令：

  bash

  docker compose up -d

  这里-d表示后台运行（detach 模式），日志不会占满终端。

  首次运行会发生什么？

• Docker Compose 会读取docker-compose.yaml文件

• 自动拉取所需的镜像：

  • PostgreSQL（数据库）

  • Redis（缓存）

  • Dify API 服务

  • Dify Web 前端

  • Nginx（反向代理）

  • Worker（后台任务）

  • 以及其他辅助服务

• 创建容器并初始化数据库表结构，整个过程根据网速大约需要5~15 分钟。你会在终端看到类似这样的输出：

  第四步：验证部署是否成功

  1. 检查容器运行状态

  执行：

  bash

  docker ps

• 看到所有容器状态为Started或Up，就表示服务已全部启动。

• 2. 访问网页界面

  打开你的浏览器，输入地址：

  text

  http://localhost:8080

• 稍等片刻（首次加载可能会慢一些，因为前端资源需要初始化），如果看到Dify 的登录/注册页面，恭喜你 —— 部署成功！