在 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构建属于自己的智能体吧!

相关推荐
Arman37682 小时前
rusty-cat × 阿里云 OSS 直传直下实战
rust·ai编程
kyriewen3 小时前
我用 AI 写代码快了 3 倍——然后同事的 Code Review 全变成了我的
前端·程序员·ai编程
wangruofeng4 小时前
一个 5KB 的 skill 文件,三个月砍下 9 万 star,省掉 65% 的 AI 输出 token
aigc·agent·ai编程
aqi004 小时前
15天学会AI应用开发(十三)上下文与RAG的阶段性总结
人工智能·python·大模型·ai编程·ai应用
刀法如飞4 小时前
Spring Boot 4.1 + JDK 25 DDD开源脚手架,面向 AI 编程
设计模式·架构·ai编程
Tyler_15 小时前
iOS PlayWright mcp server
前端·ios·ai编程
TrisighT6 小时前
Agent 的 JSON 解析崩了三次——拆完 SDK 源码我才搞懂 arguments 为什么是字符串
aigc·agent·ai编程
liuliuqiqirr6 小时前
2026最新6款AI编程工具基础版免费实测合集
ai编程
humors2217 小时前
【转帖】关于防范AI编程工具Claude Code安全后门隐患的风险提示
网络·安全·ai编程