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

相关推荐
小虎AI生活19 小时前
CodeBuddy实战:小虎个人博客网站,AI编程就是升级打boss的过程
人工智能·ai编程·codebuddy
马腾化云东19 小时前
FastJsMcp:几行代码开发一个mcp工具
人工智能·ai编程·mcp
拖拖76519 小时前
从 Claude Code 学到的那些事:简单、启发与自我管理的 AI 架构哲学
ai编程
yaocheng的ai分身1 天前
转载:Claude Code 初次编写智能体完整手册
ai编程
子昕1 天前
Claude Code的VS Code插件真香!配合GLM 4.6直接平替 Claude Sonnet 4
ai编程
用户4099322502122 天前
PostgreSQL选Join策略有啥小九九?Nested Loop/Merge/Hash谁是它的菜?
后端·ai编程·trae
程序员辉哥2 天前
我为什么最终还是回归了Cursor
ai编程·claude·cursor
飞哥数智坊2 天前
“成章”开源首更:3大体验优化,合集管理补齐!
人工智能·开源·ai编程
Damon小智2 天前
玩转CodeX:CodeX安装教程(Windows+Linux+MacOS)
linux·windows·macos·ai·ai编程·codex·gpt-5
37手游后端团队3 天前
Claude Code Review:让AI审核更懂你的代码
人工智能·后端·ai编程