十三、DIFY 使用指南
1.下载地址
DIFY的运行需要一些必备组件
Docker的下载
网站：https://www.docker.com/
1大部分Windows系统选择这个下载就好
2安装完以后，如果出现这个界面，就说明我们安装成功了。第一次启动时，可以直接点击Continue without signing in跳过不用登录。
3接下来就是比较关键的步骤，在安装Dify之前，我们要先进行Docker中镜像网站的设置，因为默认的镜像是国外的网址，访问不到。所以我们要改成国内的，修改方式如下：
4把配置改为如下内容，点保存后会自动重启。
Plain TextCopyxxxxxxxxxx16 1{2 "builder": {3 "gc": {4 "defaultKeepStorage": "20GB",5 "enabled": true6 }7 },8 "experimental": false,9 "registry-mirrors":这时我们的国内镜像就设置好了，Docker的安装也完成了。
修改下载镜像的存储位置（因为Docker默认只能安装在C盘，所以尽量更换避免占满 C 盘）：
5Settings「设置」 → Resources「资源」 → Advanced「高级」 → Browse「磁盘镜像位置」 选择其他磁盘
2.安装和运行 Dify
1获取 Dify 项目
克隆项目：如果你熟悉 Git 命令行工具，推荐使用git clone命令来克隆项目。打开终端，切换到你希望存放 Dify 项目的目录，然后执行命令，这个命令会将 Dify 项目的所有文件和历史记录下载到你指定的目录下。直接下载：下载压缩包：如果你不熟悉 Git，也可以直接在 GitHub 页面上点击 “Code” 按钮，选择 “Download ZIP” 来下载项目的压缩包。下载完成后，将压缩包解压到你希望的目录。下载后解压文件
2复制到浏览 https://ghfast.top/https://github.com/langgenius/dify/archive/refs/heads/main.zip
3.配置环境变量
创建.env 文件：进入 Dify 项目的根目录，你会看到一个.env.example文件，这是环境变量的示例文件。复制这个文件并命名为.env，可以使用命令：（在 Linux 或 macOS 系统中），在 Windows 系统中，你可以通过文件管理器进行复制操作。
💡 此文件包含数据库、API 密钥等关键配置，.env.example 是模板，.env 是实际运行使用的文件。
4.启动Dify 现在我们已经有了Dify的代码，接下来要启动它：
（1）先找到docker-compose.yaml文件所在的文件夹（通常在 dify 目录下的 docker 文件夹中）
（2）进入docker-compose.yaml所在文件夹的终端中，（这里有个小技巧，就是可以在源码目录地址上直接CMD就会弹出命令行操作目录）运行命令：
这个命令会启动在 docker-compose.yml 中定义的所有服务。
等待Docker下载并启动所有必要的组件
安装成功后，在 Docker Desktop 中应该能看到以 docker 命名的文件夹，即为安装成功。（3）然后在浏览器 中输入 http://localhost/
就会出现如下的界面：
创建管理员账户：设置用户名、邮箱和密码（请务必牢记这些信息），完成之后，正式进入Dify的世界。
登录后，点击账号头像 → 设置（进入设置），如下图：
5配置模型
Dify 是一个运行在本地的 Web UI，它允许我们便捷地访问和使用各种大语言模型，这时需要在AI平台拿到相应的 API Key，在设置页面中，点击「模型供应商」，选择您想使用的供应商（本教程以OpenAI-API-compatible为例），选择「OpenAI-API-compatible」，并点击安装。
模型供应商安装完成之后，点击添加模型，在AI平台选择我们想用的模型，复制自己的API Key、API URL，填写完保存
6创建第一个应用
点击创建空白应用，比如我们想要创建一个智能翻译的助手
输入对应的提示语，并且选择模型，右侧可以实时预览，切换模型或者增加多个模型调试
此时就已经实现了一个简单的模型的WebUI服务了。
常见问题处理
端口被占用？
错误提示如：
1.浏览器访问localhost:80无响应 原因：系统端口被占用或防火墙限制
2.如下报错
解决方法：
●使用 netstat -ano | findstr :80 查看占用进程
●结束占用进程，或修改 .env 中的 EXPOSE_NGINX_PORT
镜像拉取缓慢
请确认已配置国内镜像源（见上文）。
构建失败或启动异常？
尝试清理后重新拉取：
然后重新执行