玩转Dify教程 | 手把手教你本地部署Dify，0门槛技术小白也可轻松部署

从零开始之Dify部署篇

写给技术小白的先修知识

基础概念速览

1. ‌GitHub是什么 ‌
   可以理解为「代码的网盘」，开发者们在这里存放和共享代码（比如微信的源代码）。我们通过GitHub下载Dify的代码，就像从网盘下载文件一样简单。

   用到的下载工具git：可以理解为「网盘软件」，开发者通常使用这个软件下载代码到本地

2. ‌Docker是什么‌
   想象成「软件集装箱」，把应用程序和它需要的环境打包成一个标准箱子（容器），这样无论用Windows/Mac都能正常运行，避免出现"我电脑上好好的啊"这类问题。

---

一、工具列表（小白友好版）

你需要准备的"工具包"

1. ‌Docker Desktop‌
   一个管理"软件集装箱"的调度中心，负责下载、运行Dify的容器（类似安卓手机的应用商店）

2. ‌Git客户端‌
   代码下载工具，相当于专门从GitHub下载代码的

小提示：跟着教程操作就像组装宜家家具，按步骤来就能完成！

---

二、搭建流程（含小白注解）

1. 安装Docker Desktop

访问 Docker官网 点击Download Docker Desktop

# 这串命令就像魔法咒语，在黑色窗口（命令提示符）里输入就能检查安装是否成功
docker --version

2. 配置镜像加速（给下载加速）

国内访问Docker官方仓库就像看YouTube需要梯子，配置镜像源相当于使用"国内镜像网站"：
右键点击桌面的🐳小鲸鱼图标
选择「Settings」→ 「Docker Engine」
在编辑框里粘贴这段代码：

{
  "registry-mirrors": ["https://mirror.ccs.tencentyun.com"]
}

3. 获取Dify代码

在你想要加载代码的文件夹（比如H:\dify）鼠标右击“在终端中打开”，如图所示（图中已加载完）

git clone https://github.com/langgenius/dify.git
# 这就像告诉电脑："去GitHub把最新版Dify代码下载到本地文件夹"

如图是加载的过程

输入命令进入到项目文件夹中

cd dify/docker

4. 启动系统

# 生成配置文件（就像拆包装的说明书）
cp .env.example .env
docker compose up -d
# 相当于按下「开机键」，启动Dify需要的所有服务（数据库、后台程序等）

---

小白常见困惑解答

Q1：为什么要用命令行？
答：就像开车需要方向盘，命令行是与计算机深度交互的工具。不过别担心，跟着教程复制命令即可。

Q2：docker compose 是什么？
答：可以理解为「批量启动器」，一次性启动Dify需要的所有组件（类似手机快捷指令）

Q3：遇到报错怎么办？
答：90%的错误可通过以下三步解决：

• 检查是否复制了完整命令
• 重启Docker Desktop
• 重新执行上一步操作

记住：部署过程就像拼乐高，只要严格按照步骤操作，最终一定能看到成果！遇到问题随时回看这个指南~

三、配置大模型

配置流程

1.1. 获取API密钥

登录deepseek官方 → 右上角【API开放平台】 → API keys → 创建API key → 复制 （没有额度需要先充值）

1.2. 记录模型ID

找到图中框出来的内容里model=“xxx” 引号里的即为model ID，（图中的deepseek-chat和deepseek-reasoner）

2.1. 有个平台可以白嫖deepseek

有2000万 tokens的额度，用不完，根本用不用。
获取API密钥
登录布尔算力 → 鼠标悬停头像 → 点击API密钥 → 新建API密钥 → 然后点击密钥复制

2.2. 记录模型ID

进入模型广场 → 点击任意一个模型，在弹出详情框复制「Model ID」

3. Dify配置步骤

记事本打开之前创建的配置文件 .env，进行修改

VOLC_ACCESS_KEY=你的API密钥
VOLC_MODEL_ID=你的模型ID