Dify 是一个“AI应用工厂”，能帮你快速搭建各类智能工具（如客服机器人、文档助手），就像用乐高积木拼装一样简单。
它的三大核心能力：
1. 低代码开发：通过拖拽界面配置AI功能，无需写复杂代码，普通人也能做AI应用
2. 智能中枢：支持对接50+工具（如谷歌搜索/画图AI）和各类文档（PDF/PPT），让AI能联网、查资料、画图
3. 持续优化：自动记录用户与AI的对话数据，帮你发现哪里需要改进，像给AI装了个“行车记录仪”
适用场景：
- 企业：快速做智能客服/数据分析工具
- 创业者：低成本验证AI产品创意
- 个人：把ChatGPT、DeepSeek改造成专属助手（如论文润色机器人）
用Dify就像请了个AI工程师帮你打工，你只需提需求，它负责技术实现。
以下就是安装指南（含避坑指南+性能优化技巧）：
一、环境准备
必备组件
- 操作系统：Windows 10+/macOS 10.15+/主流Linux发行版
- 内存要求：最低8GB（推荐16GB+）
- 安装工具：
# Windows需额外安装
- WSL 2（微软商店搜索安装） 或者 Oracle VirtualBox（虚拟机）安装 Linux
- Docker Desktop（官网下载）
# Mac/Linux通用
- Git：https://git-scm.com
- Docker Compose v2.20+ 这里很多人WSL2无法安装成功,看文章结尾，有详细帮助
二、极简安装步骤57
步骤1：获取代码
git clone https://github.com/langgenius/dify
cd dify/docker 步骤2：启动Docker容器
# 一键启动9个服务（含数据库/Redis/前端等）
docker-compose up -d
# 查看运行状态（出现9个healthy即成功）
docker-compose ps 步骤3：首次访问配置
- 浏览器打开 http://localhost:8088
- 创建管理员账号
- 进入「设置-模型供应商」配置API密钥（支持OpenAI/讯飞/智谱等主流厂商）
三、性能优化技巧
提升运行效率
- 镜像加速：修改docker-compose.yml 中的镜像源
image: registry.cn-beijing.aliyuncs.com/langgenius/dify-api:latest - 端口自定义：编辑.env文件修改NGINX_HTTP_PORT
- 数据持久化：挂载/data目录避免容器重启丢失配置
四、常见问题解答
高频问题
Q1：启动时提示端口冲突？
A：执行 sudo lsof -i :80 查找占用进程，修改.env中的端口号
Q2：如何更新版本？
cd dify/docker
docker-compose down
git pull origin main
docker-compose up -d Q3：支持哪些国产大模型？
A：已适配DeepSeek-R1、讯飞星火、智谱ChatGLM、通义千问/文心一言等主流大模型。
五、进阶功能扩展63
企业级应用场景
- 私有知识库：上传PDF/Word文档实现智能问答
- API集成：通过http://localhost/api/v1对接现有系统
- 多租户管理：在「团队设置」中添加子账号并配置权限
文档说明
- 官方文档：https://docs.dify.ai
该教程已通过Windows11/Ubuntu22.04/CentOS7环境验证，如有特殊需求可参考引用源的深度配置指南
附录：以下是针对WSL2安装失败的常见问题及解决方案
一、核心错误排查
- 错误代码 0x80370102
原因：虚拟化未启用或与其他虚拟化软件（VMware/Docker）冲突
解决方案：
进入BIOS开启虚拟化（Intel VT-x/AMD-V）
关闭Hyper-V以外的虚拟化软件
执行命令：
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart- 错误代码 0x800701bc
原因：未安装WSL2内核更新包
解决方案：下载内核包：https://aka.ms/wsl2kernel以管理员身份运行安装程序设置默认版本：
wsl --set-default-version 2二、系统环境要求
- Windows版本验证最低要求：Windows 10 1903（内部版本18362+）或Windows 1113检查命令：
winver # 查看系统版本
systeminfo | find "系统类型" # 确认架构（x64/ARM64） - 家庭版特殊处理需手动启用Hyper-V：
pushd "%~dp0"
dir /b %SystemRoot%\servicing\Packages\*Hyper-V*.mum >hyper-v.txt
for /f %%i in ('findstr /i . hyper-v.txt 2^>nul') do dism /online /norestart /add-package:"%SystemRoot%\servicing\Packages\%%i"
del hyper-v.txt
Dism /online /enable-feature /featurename:Microsoft-Hyper-V-All /LimitAccess /ALL 三、典型问题修复流程
- 完全重装方案
# 卸载现有组件
wsl --unregister Ubuntu
dism.exe /online /disable-feature /featurename:Microsoft-Windows-Subsystem-Linux
dism.exe /online /disable-feature /featurename:VirtualMachinePlatform
# 重新安装
wsl --install -d Ubuntu - 镜像安装失败处理手动下载.appx安装包（如Ubuntu_2204.1.7.0_x64.appx ）解压后执行ubuntu.exe 安装5
四、进阶调试技巧
- 日志分析
- Powershell
# 生成详细日志
wsl --verbose
Get-EventLog -LogName Application -Source "*WSL*" -After (Get-Date).AddHours(-1)- 网络问题处理
- 代理设置同步：
- Bash
export https_proxy=http://host:port
export http_proxy=http://host:port 五、兼容性优化建议
- 内存限制调整
在%USERPROFILE%\.wslconfig中添加：
[wsl2]
memory=6GB
processors=4 - 文件系统性能优化
- Powershell
# 避免跨系统文件操作
wsl --shutdown
netsh interface portproxy delete v4tov4 listenport=8080 - 官方安装指南：https://learn.microsoft.com/windows/wsl/install
提示：若问题仍未解决，建议在PowerShell执行 wsl --update 后提交完整错误日志至WSL GitHub仓库 。