一、前提条件
1.1 硬件要求
在安装 Dify 之前,请确保您的设备符合以下最低系统要求:
- CPU >= 2 核
- RAM >= 4 GiB
1.2 安装Docker和Docker Compose

👉 Ubuntu 安装Docker和Docker Compose图文教程
👉 Windows下DockerDesktop安装配置图文教程,含软件安装包
1.3 安装 Git
👉 Windows下Git安装配置及常用操作图文教程,含软件安装包
二、克隆 Dify 代码仓库
克隆 Dify 源代码至本地环境。
bash
# --branch 1.5.0:通常用于获取某个特定版本的代码,1.5.0 实际上是一个版本标签(tag),不是传统意义上的分支
git clone https://github.com/langgenius/dify.git --branch 1.5.0

创建并切换到 dify-1.5.0
bash
# 查看本地分支命令
git branch
# 创建并切换分支
git switch -c dify-1.5.0

三、启动 Dify
3.1 进入 Dify 源代码的 Docker 目录
bash
cd dify/docker/

3.2 复制环境配置文件
bash
cp .env.example .env

3.3 启动 Docker 容器
根据你系统上的 Docker Compose 版本,选择合适的命令来启动容器。你可以通过 $ docker compose version 命令检查版本,详细说明请参考 Docker 官方文档
- 如果版本是 Docker Compose V2,使用以下命令:
bash
docker compose up -d

如果版本是 Docker Compose V1,使用以下命令:
bash
docker-compose up -d
构建完成效果

最后检查是否所有容器都正常运行:
bash
docker compose ps

docker-desktop上查看容器运行情况:

四、更新 Dify
进入 dify 源代码的 docker 目录,按顺序执行以下命令:
bash
cd dify/docker
docker compose down
git pull origin main
docker compose pull
docker compose up -d
同步环境变量配置 (重要!)
- 如果 .env.example 文件有更新,请务必同步修改你本地的 .env 文件。
- 检查 .env 文件中的所有配置项,确保它们与你的实际运行环境相匹配。你可能需要将 .env.example 中的新变量添加到 .env 文件中,并更新已更改的任何值。
五、访问 Dify
5.1 管理员初始化页面设置设置管理员账户
#本地环境
#服务器环境
http://your_server_ip/install
注册成功,进入登录页面:

登录成功:

5.2 Dify 主页面
#本地环境
#服务器环境
http://your_server_ip
跳转到登录页面:

5.3 自定义配置
编辑 .env 文件中的环境变量值。然后重新启动 Dify:
bash
docker compose down
docker compose up -d
完整的环境变量集合可以在 docker/.env.example 中找到。
