Dify本地部署实战：Windows + Docker Desktop（含镜像加速+常见坑）

小民AI实战笔记
0 阅读3分钟

大家好，欢迎来到 #小民AI实战笔记

我是小民，只写我跑通过的AI实操

最近不少朋友说dify.cloud.ai云服务不大稳定，用VMWare部署又太折腾。

Docker Desktop方案看着简单，但好多人反馈卡在第一步——Docker根本起不来。

今天这篇，就是Windows + Docker Desktop 部署Dify的完整流程，照着做就能跑通。

一、硬件要求

  • CPU：4核及以上
  • 内存：8GB以上
  • 磁盘：50GB SSD
  • 操作系统：Win10/11专业版

虽然家庭版也能用，但专业版对 WSL 2 支持更好，能少踩很多坑。

二、环境配置

1、启用 WSL 2

WSL 是 Docker Desktop 在 Windows 上能跑起来的关键。

打开「控制面板」→「程序和功能」。

点「启用或关闭Windows功能」。

勾选下面三项，确定后重启

2、验证WSL

重启后，管理员身份打开PowerShell，执行：

wsl --install
wsl --set-default-version 2

如果失败，管理员权限执行：

wsl --update --web-download

成功后再次重启。

三、安装Docker Desktop

1、下载安装

下载地址见文末「参考资料」

安装时一定要勾选Use WSL 2 instead of Hyper-V，装完务必重启👇

2、验证安装

打开 CMD 或 PowerShell，执行：

docker --version

看到版本信息，说明成了

3、配置国内镜像源

Docker 默认连海外服务器，很慢。

所以我们改一下镜像源：打开 Docker Desktop → 右上角齿轮（Settings）→ Docker Engine

在registry-mirrors里添加内容（整个复制过去就行）：

{
  "builder": {
    "gc": {
      "defaultKeepStorage": "20GB",
      "enabled": true
    }
  },
  "experimental": false,
  "max-concurrent-downloads": 3,
  "max-concurrent-uploads": 3,
  "registry-mirrors": [
    "https://docker.1ms.run",
    "https://docker.1panel.live",
    "https://docker.nju.edu.cn"
  ]
}

点击 Apply & Restart。

四、部署Dify

1、下载源码

打开CMD，执行：

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

如果拉不下来，可能是代理问题。

比如我本地的魔法端口是10809，实际端口看下自己的代理软件（如Clash、V2Ray等）。

git config --global http.proxy http://127.0.0.1:10809
git config --global https.proxy http://127.0.0.1:10809

实在搞不定，就直接去GitHub下载ZIP包

文末有地址

2、配置环境变量

CMD进入解压后的dify/docker目录

cd dify/docker

复制示例配置文件：

copy .env.example .env

.env里可以改端口，默认是80，这里我把端口改成了8060，避免与我本地端口冲突

修改完成后，需要重启一下

docker compose down
docker compose up -d

3、启动Dify

还是在dify/docker目录下，执行：

docker compose up -d

⚠️注意： 新版Docker使用docker compose（中间无横杠），旧版用docker-compose

4、验证容器状态

启动后执行命令，确认所有容器都在运行：

docker ps

5、访问Dify

浏览器打开：http://localhost:8060/install

按提示初始化管理员账号

然后访问：http://localhost:8060 就可以用了

常见问题

1. Docker Desktop 显示 "Docker Engine stopped"

WSL 2 没装好，回去检查三个 Windows 功能是否都开了，重启再试。

2. 镜像拉取失败或特别慢

镜像源没配好，按前面的步骤配置国内加速源。

3. 端口 80 被占用

改docker/.env里的EXPOSE_NGINX_PORT，比如改成 8060，然后重启。

总结一下

Docker Desktop 部署 Dify 的核心就几点：

  1. WSL 2是基础，Docker需要依赖它跑
  2. 镜像加速器要配置，不然会慢到怀疑人生
  3. copy .env.example .env别忘了这步
  4. docker compose up -d一键起飞

按着上面的步骤走，一般跑起来没啥问题。

但如果真遇到奇怪的问题，欢迎一起交流学习。

参考资料

📢 关于我

以上是本次分享的全部内容。

如果你对我的实操笔记感兴趣，或想交流AI工具的使用经验：

👉 「个人主页」有我的联系方式，欢迎来聊

感谢阅读，下期见~

avatar
文章
阅读
粉丝