Dify本地部署

前言，本人环境为 Ubuntu24.04，使用 Docker 和 Docker Compose 部署开源 LLMOps 平台 Dify（2025.12.15 实测）

1. 安装 Docker

1.1 更新&&安装Docker

1
# 更新
2
sudo apt update
3
sudo apt upgrade
4

5
# 安装 Docker 和 Docker Compose
6
sudo apt install docker.io

1.2 验证安装

1
docker --version
2
docker compose version  # 如 docker-compose version 1.29.2

1.3 报错处理

docker-compose version 1.29.2 的版本不支持此时 dify 中 depends_on 的映射形式，如

1
depends_on:
2
        required: true/false

Compose v2.1+ 才部分支持的扩展语法这里有两种方法解决

修改 docker-compose.yaml 以兼容 Compose v1
更新 docker compose

这里笔者选择 2

1
# 从官方 Github 安装最新的docker compose
2
mkdir -p ~/.docker/cli-plugins
3
curl -SL https://github.com/docker/compose/releases/latest/download/docker-compose-linux-x86_64 -o ~/.docker/cli-plugins/docker-compose
4
chmod +x ~/.docker/cli-plugins/docker-compose

1
# 查看 docker compose版本
2
jiy@JiYI:~$ docker compose version
3
Docker Compose version v5.0.0
4

5
# 将当前用户加入 docker 用户组（执行命令不用sudo）
6
sudo usermod -aG docker $USER

Tip
此时笔者的环境：
Ubuntu 24.04
Docker 28.2.2
Docker Compose 5.0.0
接下来开始愉快部署了！！

2. 克隆 Dify 源代码

1
git clone https://github.com/langgenius/dify.git
2
cd dify/docker

3. 配置环境变量

1
cp .env.example .env

如需修改端口（例如 80 被占用），编辑 .env 文件，调整 EXPOSE_NGINX_PORT 等变量
默认 .env ，初学走默认即可

4. 启动 Dify 服务

1
# 首次启动自动拉取所需镜像
2
docker compose up -d

6. 检查容器状态

1
# 应看到所有服务状态均为 `Up`
2
docker compose ps

7. 访问 Dify

打开浏览器，访问 http://<本机IP>即可（若为本地则 http://localhost）
首次进入会创建管理员账户和设置初始密码

部署完成，Enjoy！

J i y ' s 数 字 花 园

1. 安装 Docker

1.1 更新&&安装Docker

1.2 验证安装

1.3 报错处理

2. 克隆 Dify 源代码

3. 配置环境变量

4. 启动 Dify 服务

6. 检查容器状态

7. 访问 Dify