Dify搭建教程

Dify 最新版一键部署（CentOS7 + Docker Compose V2）

一、前置准备：配置国内 yum 源（解决下载慢/失败问题）

1. （可选）一键优化系统镜像源

# 方案1：LinuxMirrors 官方脚本（推荐）
bash <(curl -sSL https://linuxmirrors.cn/main.sh)

# 方案2：Gitee 镜像脚本（网络更稳定）
bash <(curl -sSL https://gitee.com/SuperManito/LinuxMirrors/raw/main/ChangeMirrors.sh)

执行后按提示选择「CentOS 7」，并勾选需要优化的源即可。

二、安装 Docker + 最新版 Docker Compose V2

1. 安装前置依赖

yum install -y yum-utils device-mapper-persistent-data lvm2

2. 配置 Docker 国内 yum 仓库（阿里云）

# 添加 Docker 阿里云镜像源
yum-config-manager --add-repo https://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo

# 手动创建 Docker 源配置文件（确保兼容性）
cat > /etc/yum.repos.d/docker-ce.repo << EOF
[docker-ce-stable]
name=Docker CE Stable - x86_64
baseurl=https://mirrors.aliyun.com/docker-ce/linux/centos/7/x86_64/stable/
enabled=1
gpgcheck=1
gpgkey=https://mirrors.aliyun.com/docker-ce/linux/centos/gpg
EOF

# 更新 yum 缓存
yum makecache fast

3. 安装 Docker 引擎（稳定版）

# 安装 Docker CE 及依赖
yum install -y docker-ce docker-ce-cli containerd.io

# 启动 Docker 服务并设置开机自启
systemctl start docker
systemctl enable docker

# 验证 Docker 安装成功（显示版本号即正常）
docker --version

4. 安装最新版 Docker Compose V2（推荐方式）

Docker Compose V2 是官方当前维护的最新版本，作为 Docker CLI 插件运行：

# 创建 Docker 插件目录（若不存在）
mkdir -p ~/.docker/cli-plugins

# 下载最新稳定版 Docker Compose（Linux x86_64 架构）
# 如需 arm64 架构，将 "linux-x86_64" 替换为 "linux-arm64"
curl -SL https://github.com/docker/compose/releases/latest/download/docker-compose-linux-x86_64 -o ~/.docker/cli-plugins/docker-compose

# 添加执行权限
chmod +x ~/.docker/cli-plugins/docker-compose

# 验证安装成功（显示 V2 版本号即正常，如 v2.xx.x）
docker compose version

三、Docker Compose V2 部署 Dify（最新版）

1. 克隆 Dify 最新代码仓库

直接拉取主分支（默认获取最新稳定版，无需指定旧版本）：

# 克隆 Dify 官方最新代码
git clone https://github.com/langgenius/dify.git

# 进入 Dify 目录
cd dify

2. 配置并启动 Dify

# 进入 Docker 配置目录
cd docker

# 复制环境变量示例文件并生成配置
cp .env.example .env

# （可选）自定义配置（如端口、数据库密码等）
# 编辑 .env 文件，按需修改端口（默认 8080）、数据库信息等
# vi .env

# 启动 Dify 服务（后台运行）
docker compose up -d

# 检查所有容器运行状态（确保所有服务都是 up 状态）
docker compose ps

3. 访问 Dify

启动成功后，通过服务器 IP + 端口访问（默认端口 8080）：

http://你的服务器IP:8080