保姆级教程Dify 本地一键部署Windows/Mac 通用一、前言在 AI 应用开发领域Dify是一款开源的 LLM 应用开发平台支持可视化编排 Prompt、对接各类大模型、搭建知识库、生成 API 服务无需复杂代码就能快速开发企业级 AI 应用。很多小伙伴想本地部署 Dify 用于学习、测试但官方文档对新手不够友好。本文用最简单、最稳定的方式带你 10 分钟完成 Dify 本地部署全程无坑二、部署前准备必看1. 环境要求操作系统Windows 10/MacOS/Linux必须安装Docker Desktop核心依赖一键容器化部署内存建议≥ 4GB避免启动卡顿2. 安装 Docker DesktopDocker 是 Dify 部署的核心工具无需手动配置环境一键运行所有服务。下载地址Docker 官方下载Windows 直接安装勾选 “Use WSL2”推荐Mac 直接拖拽安装即可安装完成后启动 Docker Desktop保持后台运行三、开始部署 Dify核心步骤1. 下载 Dify 部署包打开终端Windows 用 PowerShellMac 用终端执行命令克隆代码gitclone https://github.com/langgenius/dify.git如果没装 Git直接去 Dify GitHub 下载 ZIP 压缩包解压即可。2. 进入部署目录cddify3. 复制环境配置文件cp.env.example .envWindows PowerShell 命令copy.env.example.env这个文件是 Dify 的配置文件默认配置即可直接运行无需修改。4. 一键启动 Dify核心命令直接复制运行dockercompose up-d-d表示后台运行关闭终端不影响服务首次启动会自动下载镜像等待 3-5 分钟取决于网速5. 验证启动成功执行命令查看服务状态dockercomposeps看到所有服务状态为running就说明启动成功四、访问 Dify 后台打开浏览器输入地址http://localhost:8080首次访问需要注册账号邮箱随便填密码自定义注册后直接登录使用。五、基础配置快速上手1. 配置大模型必配Dify 本身不带模型必须对接第三方 LLM进入后台 → 右上角「设置」→ 「模型供应商」选择你要用的模型通义千问、文心一言、GPT、DeepSeek 等填写 API Key 即可启用2. 上传知识库左侧「知识库」→ 「创建知识库」支持上传 TXT/Markdown/PDF/Word 等文件自动分词、向量化无需配置 Elasticsearch默认用 Qdrant3. 创建 AI 应用左侧「应用」→ 「创建应用」选择对话型/知识库型/函数型应用可视化配置 Prompt、温度、上下文等参数直接发布为 API 或 Web 应用六、常用运维命令1. 停止 Difydockercompose stop2. 重启 Difydockercompose restart3. 查看日志排查问题用dockercompose logs-f4. 彻底删除服务保留数据dockercompose down七、常见问题解决1. 启动报错端口 8080 被占用修改.env文件中的端口WEB_PORT8081 # 改成 8081 或其他未占用端口然后重启服务docker compose up -d2. Windows 启动慢/卡顿打开 Docker Desktop → 设置 → 资源分配内存 ≥ 4GBCPU ≥ 2 核重启 Docker 再启动 Dify3. 无法访问 localhost:8080检查 Docker 所有服务是否为running关闭电脑防火墙/杀毒软件浏览器清空缓存重试八、总结Dify 本地部署核心就是 Docker 一条命令无需复杂环境配置新手也能轻松搞定。本地部署适合学习 AI 应用开发测试私有知识库开发企业内部 AI 工具二次开发定制功能总结Dify 本地部署仅需 Docker无需额外环境核心命令docker compose up -d一键启动访问地址http://localhost:8080必配大模型 API Key 才能正常使用。