本文将讲解我们本地电脑如何安装运行 Dify，详细说明安装和运行步骤，我们来一起看下。

1.安装Docker Desktop

首先要安装Docker，以确保后续环境的一致性。对于使用macOS系统的用户，前往Docker官网下载对应的.dmg安装包。下载完成后，双击运行安装包，并将其拖拽至应用文件夹。首次启动时，需要接受服务协议，建议选择“推荐设置”，这样系统会自动完成环境配置，方便又省心。

2.克隆Dify代码并配置环境

1）克隆仓库：打开终端，输入以下命令，就能把Dify的代码克隆到本地：

git clone https://github.com/langgenius/dify.git 

这条命令的作用是从指定的GitHub仓库中获取Dify的代码，就像把一个装满工具的箱子从远处搬到自己电脑上。
2） 复制环境变量文件：克隆完成后，进入Dify的Docker目录，执行以下命令复制示例配置文件：

cd dify/docker cp.env.example.env 

进入到这个目录后，复制示例配置文件，这一步就像是复制一份模板，后续可以根据自己的需求修改其中的参数，比如调整端口或密钥等。

3.启动Dify容器

1）一键启动服务：根据你安装的Docker Compose版本，选择相应的命令启动服务。如果是Docker Compose V2，在终端输入：

docker compose up -d 

这条命令会启动多个容器，包括数据库（PostgreSQL）、缓存（Redis）、向量引擎（Weaviate）等，它们协同工作，为Dify的运行提供支持。
2） 检查容器状态：启动完成后，运行docker compose ps命令，查看所有容器的状态。只有当看到api、web、worker等核心服务都处于“Up”状态时，才表示启动成功，可以进行下一步操作。

4.初始化与访问Dify

1）完成管理员设置：在浏览器中访问http://localhost/install，设置管理员账号和密码。如果打开页面后一直没有反应，可以按F12打开开发者工具，在Network选项中找到setup请求，查看是否返回200状态码。如果请求成功，刷新页面就能看到设置账户密码的页面。这里设置的管理员账号拥有最高权限，可用于创建应用和管理大模型供应商等。

2）登录主界面：设置好管理员账号密码后，访问http://localhost，就能进入Dify的工作台，在这里可以开始创建AI应用、配置大模型等操作。

至此Dify已经部署安装完成，可以进行后续的搭建本地知识库操作了，比如接入DeepSeek等等：