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

写给技术小白的先修知识

基础概念速览

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‌

2.1. 最近发现有个平台可以白嫖deepseek

不过需要填官方邀请码 computility 注册才有赠送20元额度哦，相当于4000万 tokens，用不完，根本用不用。

‌获取API密钥‌

• 登录布尔算力 → 鼠标悬停头像 → 点击API密钥 → 新建API密钥 → 然后点击密钥复制
  
  

  2.2. 记录模型ID

  • 进入模型广场 → 点击任意一个模型，在弹出详情框复制「Model ID」4. ‌Dify配置步骤 ‌
    记事本打开之前创建的配置文件 .env

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