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

相关推荐
夜郎king8 分钟前
TRAE百度地图MCP配置实践
ai编程·百度地图mcp·trae mcp·trae 自动化地图接入
序舟归桁1 小时前
OpenClaw 与 GitLab 代码评审集成方案
ai编程
来一斤小鲜肉1 小时前
Spring AI核心:高阶API之Tool Calling
后端·ai编程
踩着两条虫1 小时前
AI驱动的Vue3应用开发平台 深入探究(十六):扩展与定制之自定义组件与设计器面板
前端·vue.js·人工智能·开源·ai编程
UXbot1 小时前
AI App 设计生成工具哪个好?
ui·kotlin·软件构建·产品经理·ai编程·swift
华仔啊1 小时前
再也不用手动画图了,这个 AI 工具太强了
ai编程
俊劫1 小时前
AI Harness - 2026 AI 工程新范式
前端·openai·ai编程
刘 大 望2 小时前
开发自定义MCP Server并部署
java·spring·ai·语言模型·aigc·信息与通信·ai编程
一直会游泳的小猫2 小时前
ClaudeCode完整学习指南
python·ai编程·claude code·claude code指南
一颗小行星2 小时前
Harness Engineering 前端开发的下一个阶段
前端·ai编程