Dify 快速部署与 Docker 国内镜像切换教程

本地部署

1. 拉取代码

推荐拉取 Gitee 上的 dify 仓库，也可使用 GitHub 仓库。

git clone https://gitee.com/dify_ai/dify.git

2. Docker 安装

2.1 安装 Docker 命令

先直接用 yum 或者 apt 安装 docker。

yum install -y docker # centos
apt install -y docker # ubuntu

验证安装：

docker --version
# 例如输出 Docker version 29.1.5, build 0e6fee6

2.2 安装 Docker Compose

目前 dify 1.11 版本的 docker-compose.yaml 包含了 required 语法，v1 版本的 docker-compose（带横杠的版本）无法直接 up 起容器，需要安装或升级为 v2 版本的 docker compose（不带横杠的版本）。

若自动拉取失败，建议手动下载 docker compose 二进制文件。在 release 页面下载对应版本，例如 docker-compose-linux-x86-64。

# 创建目标文件夹
mkdir -p ~/.docker/cli-plugins/
# 授权
chmod +x docker-compose-linux-x86-64
# 拷贝至目标路径，注意命名
cp ./docker-compose-linux-x86-64 ~/.docker/cli-plugins/docker-compose

验证安装：

docker compose version
# 例如输出 Docker Compose version v5.0.1

2.3 Docker 切换镜像源

可使用稳定可靠的镜像源配置脚本。

# 拉取配置脚本
curl -fsSL --connect-timeout 10 --retry 3 https://linuxmirrors.cn/docker.sh -o /tmp/docker.sh
# 执行
sudo bash /tmp/docker.sh \
  --source mirrors.tencent.com/docker-ce \
  --source-registry docker.1ms.run \
  --protocol https \
  --install-latested true \
  --close-firewall false \
  --ignore-backup-tips