在 Windows 实现 Dify 本地部署


第一步:安装 WSL(Windows Subsystem for Linux)

参考learn.microsoft.com/zh-cn/windo...

  1. 启用 WSL

    打开具有管理员权限的 PowerShell,运行以下命令以安装 WSL:

    css 复制代码
    wsl --install

    安装完成后,重启电脑以完成配置。

  2. 选择 Linux 发行版

    如果直接运行 wsl.exe --install -d ubuntu 报错,可以通过 Microsoft Store 搜索 "Linux" 并选择合适的 Ubuntu 版本进行安装。安装完成后,系统会提示你设置用户名和密码。


第二步:安装 Docker Desktop

  1. 下载 Docker Desktop
    前往 Docker 官方文档 下载适用于 Windows 的 Docker Desktop。
  2. 安装并配置 Docker
    根据安装向导完成 Docker 的安装,并确保启用了 WSL 2 后端支持。这将允许 Docker 在 WSL 环境中无缝运行。

第三步:克隆 Dify 源代码

  1. 获取 Dify 源码

    我这里使用了ssh方式去拉了代码,不管通过什么方法,只要把dify的代码下载到自己电脑上就行

    bash 复制代码
    git clone git@github.com:langgenius/dify.git

    如果无法访问 GitHub,也可以通过其他方式(如 ZIP 包下载)获取代码。

  2. 进入 Docker 目录

    进入 Dify 项目的 docker 目录:

    bash 复制代码
    cd dify/docker
  3. 复制环境配置文件

    复制 .env.example 文件为 .env,这是容器运行所需的配置文件:

    bash 复制代码
    cp .env.example .env

第四步:启动 Dify

  1. 检查 Docker Compose 版本

    通过以下命令检查你的 Docker Compose 版本:

    复制代码
    docker compose version
    • 如果版本是 V2,使用以下命令启动容器:

      复制代码
      docker compose up -d
    • 如果版本是 V1,使用以下命令:

      复制代码
      docker-compose up -d
  2. 解决拉取镜像超时问题

    如果在拉取镜像时遇到类似以下错误:

    vbscript 复制代码
    Error response from daemon: Get "https://registry-1.docker.io/v2/": net/http: request canceled while waiting for connection (Client.Timeout exceeded while awaiting headers)

    可以通过修改 Docker 的配置文件来解决。编辑或创建 /etc/docker/daemon.json 文件,添加以下内容:

    json 复制代码
    {
        "runtimes": {
            "nvidia": {
                "args": [],
                "path": "nvidia-container-runtime"
            }
        },
        "registry-mirrors": [
            "https://docker.registry.cyou",
            "https://docker-cf.registry.cyou",
            "https://dockercf.jsdelivr.fyi",
            "https://docker.jsdelivr.fyi",
            "https://dockertest.jsdelivr.fyi",
            "https://mirror.aliyuncs.com",
            "https://dockerproxy.com",
            "https://mirror.baidubce.com",
            "https://docker.m.daocloud.io",
            "https://docker.nju.edu.cn",
            "https://docker.mirrors.sjtug.sjtu.edu.cn",
            "https://docker.mirrors.ustc.edu.cn",
            "https://mirror.iscas.ac.cn",
            "https://docker.rainbond.cc"
        ]
    }
  1. 验证容器运行状态

    使用以下命令检查容器是否正常运行:

    复制代码
    docker compose ps

    正常情况下,你应该可以看到包括以下服务:

    • 3 个业务服务:api / worker / web
    • 6 个基础组件:weaviate / db / redis / nginx / ssrf_proxy / sandbox

第五步:访问 Dify

在浏览器中输入 http://localhost,即可访问 Dify。


总结

通过以上步骤,就已经成功在 Windows 系统上通过Docker Compose部署了本地Dify 。接下来就通过Dify构建属于自己的智能体吧!

相关推荐
小兵张健5 小时前
武汉拿下 23k offer 经历
java·面试·ai编程
堆栈future5 小时前
上下文工程(Context-Engineering): AI应用核心技术剖析
llm·ai编程·mcp
保持学习ing10 小时前
AI--提升效率、驱动创新的核心引擎
低代码·自动化·ai编程
用户35218024547510 小时前
MCP极简入门:@modelcontextprotocol/inspector 如何使用
ai编程·mcp
FairyDiana13 小时前
从 "等一下" 到 "马上说":React 牵手 DeepSeek 玩转文本大模型
react.js·ai编程
qiyue7715 小时前
AI编程专栏(二)- Cursor 深度使用指南
ai编程·cursor
qiyue7715 小时前
AI编程专栏(三)- 实战无手写代码,Monorepo结构框架开发
前端·ai编程
程序员陆通15 小时前
独立开发A/B测试实用教程
人工智能·ai编程
用户3521802454751 天前
MCP极简入门:node+idea运行简单的MCP服务和MCP客户端
node.js·ai编程
每天开心1 天前
一文教你掌握事件机制
前端·javascript·ai编程