准备做一个系列，一直到能做出一个实战项目。
# Dify 本地部署与 DeepSeek 模型接入指南

## 🛠️ 阶段一：环境准备

在安装 Dify 之前，需要先在 Windows 上准备好运行环境。

### 1. 开启必要的 Windows 功能

打开【控制面板】→【程序】→【启用或关闭 Windows 功能】，勾选以下两项并点击确定，然后重启电脑：

- ✓ 适用于 Linux 的 Windows 子系统
- ✓ 虚拟机平台

### 2. 安装 Docker Desktop

从 Docker 官网下载 Docker Desktop for Windows 安装包。

- 运行安装程序，建议不要安装在 C 盘
- 安装完成后，需要重启电脑

### 3. 启动 Docker Desktop

启动 Docker Desktop。如果遇到启动失败或卡顿，通常是因为 WSL2 未正确安装。

可以在 PowerShell（管理员模式）下运行以下命令来更新 WSL 内核组件：

```
powershell
wsl --update
```
### 4. 配置 Docker 国内镜像源（关键步骤）

> ⚠️ **很必要**：不配置的话速度慢到让你怀疑人生！

为了加速后续镜像下载，必须配置国内镜像源。

**操作步骤：**

1. 在 Docker Desktop 右上角点击齿轮图标（设置）→ **Docker Engine**
2. 在 `registry-mirrors` 列表中填入国内镜像源地址

**配置文件示例：**

```
json
{
  "registry-mirrors": [
    "https://docker.m.daocloud.io",
    "https://docker.1panel.live",
    "https://hub.rat.dev/"
  ]
}
```
3. 点击 **Apply & Restart** 使配置生效

---

## 🚀 阶段二：安装 Dify

环境准备好后，就可以开始安装 Dify 了。

### 1. 下载 Dify 代码

访问 Dify 的 GitHub 官方仓库 [langgenius/dify](https://github.com/langgenius/dify)。

- 下载项目代码的 ZIP 压缩包
- 解压到你希望安装的目录（例如 `E:\dify`）

> 💡 **建议**：选择国内镜像源，下载速度会更快。

### 2. 启动 Dify 服务

进入解压后的文件夹，找到 `docker` 文件夹并进入。

在文件夹路径栏输入 `cmd` 并回车，打开命令行窗口。

依次执行以下两条命令：

```
bash
# 1. 复制环境变量模板文件
copy .env.example .env

# 2. 启动所有 Dify 服务（这个过程可能需要几分钟，请耐心等待）
docker compose up -d
```
当命令行显示 `done` 或状态为 `running` 时，表示启动成功。

可以打开 Docker Desktop 界面，在 **Containers** 标签页看到所有正在运行的容器。

### 3. 初始化 Dify

打开浏览器，访问：

```

http://localhost/install
```
按照页面提示，设置你的管理员邮箱和密码，然后登录。

---

## 🤖 阶段三：配置 DeepSeek 模型

这是最关键的一步，将 DeepSeek 的能力接入 Dify。

> 💡 **推荐方式**：通过云端 API（最简单、无需强大显卡）

### 方式 A：通过云端 API（最简单）

这是官方推荐的、最简单的接入方式。

#### 步骤 1：获取 API Key

访问 DeepSeek 官网开发者平台，注册账号并申请 API Key。

#### 步骤 2：在 Dify 中配置

1. 登录 Dify 后，点击右上角头像 → **设置** → **模型供应商**
2. 找到 **DeepSeek**，点击"添加模型"
3. 在弹出的窗口中：
   - **API Key**：填入你申请的 API Key
   - **模型名称**：通常为 `deepseek-chat` 或 `deepseek-coder`
4. 点击保存

---

## ✨ 阶段四：创建你的第一个 AI 应用

模型配置成功后，就可以在 Dify 中创建应用了。

### 步骤 1：创建空白应用

在 Dify 顶部导航栏进入 **工作室**，点击 **"创建空白应用"**。

### 步骤 2：选择应用类型

建议选择 **"聊天助手"** 开始体验。

给你的应用起个名字，如："我的 DeepSeek 助手"。

### 步骤 3：关联模型

在应用编排页面右侧，找到 **"模型"** 下拉框，选择你刚刚配置好的 DeepSeek 模型。

### 步骤 4：开始对话

在右侧调试区域，输入你的第一个问题，比如：

```

请介绍一下你自己
```
如果收到了回复，恭喜你，**本地 Dify + DeepSeek 已经成功运行！** 🎉

下一章介绍合适的云端服务器用来配置云端dify
```