从零开始之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

12.png

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

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

{
  "builder": {
    "gc": {
      "defaultKeepStorage": "20GB",
      "enabled": true
    }
  },
  "experimental": false,
  "registry-mirrors": [
    "https://docker.hpcloud.cloud",
    "https://docker.m.daocloud.io",
    "https://docker.unsee.tech",
    "https://docker.1panel.live",
    "http://mirrors.ustc.edu.cn",
    "https://docker.chenby.cn",
    "http://mirror.azure.cn",
    "https://dockerpull.org",
    "https://dockerhub.icu",
    "https://hub.rat.dev",
    "https://proxy.1panel.live",
    "https://docker.1panel.top",
    "https://docker.m.daocloud.io",
    "https://docker.1ms.run",
    "https://docker.ketches.cn"
  ]
}

3. 获取Dify代码

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

image.png

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

如图是加载的过程

image.png

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

cd dify/docker

4. 启动系统

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

需要等待几分钟，等到如下图所示之后，证明已经开启完毕

13.png

15.png

小白常见困惑解答

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

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

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

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

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

三、配置大模型

配置流程

1.1. 获取API密钥

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

image.png

1.2. 记录模型ID

找到图中框出来的内容里model="xxx" 引号里的即为model ID

image.png

2.1. 有平台可以白嫖deepseek

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

image.png

2.2. 记录模型ID

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

image.png

3. Dify配置步骤

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

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

将上面的加入到文件的头两行（注意把自己的API密钥复制过去），如图所示

10.png