Docker Compose 部署 Dify 应用实战指南

出现版本号即安装成功。

2.3 安装 Docker Compose V2（核心避坑）

直接安装官方插件版，无需手动配置，彻底解决旧版本兼容问题：

yum install -y docker-compose-plugin

验证 Compose 版本：

docker compose version

需显示 v2.20.0 及以上版本，低于此版本会出现'Additional property required is not allowed'报错。

2.4 配置 Docker 国内镜像加速（解决拉取镜像慢）

默认 Docker Hub 拉取镜像速度慢，配置国内镜像源，提升部署效率：

cat > /etc/docker/daemon.json <<EOF
{
 "registry-mirrors": [
  "https://docker.mirrors.ustc.edu.cn",
  "https://hub-mirror.c.163.com",
  "https://mirror.baidubce.com"
 ]
}
EOF

重启 Docker 生效：

systemctl daemon-reload
systemctl restart docker

三、Dify 项目下载与配置

3.1 下载 Dify 官方源码

建议将项目存放至/opt 目录，统一管理服务：

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

3.2 生成环境配置文件

复制官方示例配置文件，无需修改即可直接部署测试，生产环境可按需调整端口、密钥等参数：

cp .env.example .env

可选配置：若 80 端口被占用，编辑.env 文件，修改 EXPOSE_NGINX_PORT 为自定义端口（如 8080），同时防火墙放行该端口即可。

3.3 预清理 Docker 异常网络（避坑核心）

针对部署常见的'Container cannot be connected to network endpoints'网络报错，提前清理残留异常网络与无用资源：

# 停止残留容器
docker compose down
# 清理无用网络
docker network prune -f
# 清理无用镜像、缓存
docker system prune -f

四、Dify 启动部署与验证

4.1 一键启动 Dify 服务

进入 dify/docker 目录后，执行以下命令后台启动所有容器（命令格式核心避坑）：

# 正确命令：docker + compose + up -d，无短横，空格分隔
docker compose up -d

命令报错避坑：若提示'unknown shorthand flag: 'd' in -d'，是命令格式错误，必须严格按照 docker compose up -d 执行，compose 与 up 之间有空格，-d 紧跟 up 后，不可拆分、不可少空格。

首次启动会自动拉取所有依赖镜像，耗时 3-10 分钟（取决于服务器网络），若中途卡住，直接 Ctrl+C 中断，重新执行该命令即可，Docker Compose 具备幂等性，不会重复创建容器、不损坏数据。

4.2 验证容器运行状态

启动完成后，查看所有服务状态，确保全部为 Up 状态：

docker compose ps

正常结果：所有服务（web、api、worker、postgres、redis、weaviate 等）状态均为 Up，无退出、无异常。

4.3 查看启动日志（故障排查）

若容器启动异常，实时查看日志定位问题：

# 查看全部服务日志
docker compose logs -f
# 单独查看某服务日志（如 web 服务）
docker compose logs -f web

日志无报错、出现'服务启动成功'字样，即部署完成。

五、Dify 访问与初始配置

5.1 访问 Dify 后台

浏览器输入服务器 IP 地址，直接访问（默认 80 端口，自定义端口则加端口号）。

5.2 初始管理员账号

开始运行会跳出管理员注册页面，直接添加自己的邮箱密码就行。

5.3 基础配置

• 修改管理员密码与个人信息
• 创建知识库、配置对话应用

整理日常运维必备命令，方便后续管理、重启、升级服务。

六、常见故障与解决方案

6.1 报错：使用了旧版 Docker Compose V1

原因：使用了旧版 Docker Compose V1（docker-compose 带短横），不支持高版本配置语法

6.2 报错：Container cannot be connected to network endpoints

解决：执行 docker compose down && docker network prune -f，重新启动服务

原因：命令格式错误，空格缺失或参数位置错误

6.3 启动卡住、镜像拉取失败

解决：配置 Docker 国内镜像加速，中断后重新执行启动命令

原因：防火墙未放行 80 端口、容器未正常启动

七、部署总结

核心避坑要点：必须使用 Docker Compose V2、提前清理异常网络、严格遵循命令格式，遇到启动卡住可直接重复执行启动命令，无需担心数据损坏。部署完成后即可快速搭建各类 AI 应用，实现私有化大模型应用落地。