玩转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

bash 复制代码
# 这串命令就像魔法咒语,在黑色窗口(命令提示符)里输入就能检查安装是否成功
docker --version

2. 配置镜像加速(给下载加速)

国内访问Docker官方仓库就像看YouTube需要梯子,配置镜像源相当于使用"国内镜像网站":

右键点击桌面的🐳小鲸鱼图标

选择「Settings」→ 「Docker Engine」

在编辑框里粘贴这段代码:

json 复制代码
{
  "registry-mirrors": ["https://mirror.ccs.tencentyun.com"]
}

3. 获取Dify代码

在你想要加载代码的文件夹(比如H:\dify)鼠标右击"在终端中打开",如图所示(图中已加载完)

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

如图是加载的过程

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

bash 复制代码
cd dify/docker

4. 启动系统

bash 复制代码
# 生成配置文件(就像拆包装的说明书)
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
ini 复制代码
VOLC_ACCESS_KEY=你的API密钥
VOLC_MODEL_ID=你的模型ID
相关推荐
2401_832298101 分钟前
AI安全治理:构建可控可信的智能时代新秩序
人工智能
本原财经5 分钟前
卖游戏、筹H股,昆仑万维临IPO磨AI含金量
人工智能·游戏
新新学长搞科研13 分钟前
【上海交通大学主办】第七届医学人工智能国际学术会议(ISAIMS 2026)
人工智能·医学
桃西西呀13 分钟前
GPT-5.6 的 ultra 模式凭什么开 4 个 Agent 并行跑?——多智能体协作,是把"一个聪明人"换成"一个团队"
人工智能·llm·agent
空堂与归16 分钟前
大模型输出总不满意?用Temperature采样控制生成质量
人工智能
陈涛谈云计算17 分钟前
陈涛谈做课(5):答案展开——模型外显三步法,让你的知识能被“带走“
人工智能
学习星球27 分钟前
2026年AI Agent全栈开发实战——从Prompt到Production
开发语言·人工智能·prompt
边吃番茄边敲代码29 分钟前
从本地工具到 MCP:给 Agent 接入独立工具服务,并补齐自动化测试
人工智能·python·功能测试·ai·单元测试·pytest
SugarAbsinthe37 分钟前
【Agent开发实习小记】从人工逐条验证到自动化验收:新 API 接入前的效率瓶颈
人工智能·python·自动化·pytest
小七的碎碎念1 小时前
生成式AI应用落地:从原型Demo到商用交付的工程化鸿沟
人工智能·生成式ai·技术创业