如果你想快速搭建 AI 应用、RAG 知识库、智能体，Dify 一定是绕不开的开源神器。但很多人卡在第一步：环境部署—— 端口冲突、容器起不来、镜像缺失、模型接不上……
这篇把完整、可复现、无玄学的部署流程整理好了，全程命令可复制，专业准确不缩水，新手也能一次跑通。
一、本次部署目标（一句话看懂）
在 Linux 服务器 / 虚拟机 上完成：
- 清理旧容器环境，避免冲突
- 加载 Dify 全套 Docker 镜像
- 部署 Dify 源码并配置环境变量
- 启动服务并正常访问网页
- 接入第三方大模型（如通义千问）
- 最终可直接用于 AI 应用开发
二、第一阶段：环境准备与镜像加载
1. 清理旧环境（必做！90% 失败源于此）
旧容器（Milvus、Redis 等）会占用端口，必须先停掉：
bash
运行
cd /root/ai/dev/milvus_redis
docker compose down
2. 创建工作目录
bash
运行
mkdir -p /root/dify_dev
cd /root/dify_dev
3. 上传并加载 Dify 镜像
将完整镜像包（.tar）上传到 /root/dify_dev，执行加载：
bash
运行
docker load -i dify-api.tar | docker load -i dify-plugin-daemon.tar | docker load -i dify-sandbox.tar | docker load -i dify-web.tar | docker load -i nginx.tar | docker load -i postgres.tar | docker load -i redis6-alpine.tar | docker load -i squid.tar | docker load -i weaviate.tar
会加载以下核心组件：
- api、plugin-daemon、sandbox、web
- nginx、postgres、redis、squid、weaviate
三、第二阶段：安装 Dify 环境
1. 获取并解压源码
上传 dify-main.zip 到服务器，然后：
bash
运行
yum install -y unzip
unzip dify-main.zip
cd dify-main/docker
2. 配置环境变量（关键）
bash
运行
mv .env.example .env
注意：
.env是隐藏文件，前面的.不能丢- 不配置这一步，服务无法正常启动
3. 一键启动服务
bash
运行
docker compose up -d
启动需要等待 1～3 分钟，让所有容器完成初始化。
四、第三阶段：访问 Dify 并初始化
浏览器打开（替换成你的服务器 IP）：
plaintext
http://部署虚拟机的ip地址/install
首次访问步骤：
- 创建管理员账号
- 完成系统初始化
- 进入 Dify 主界面
五、第四阶段：接入第三方大模型（以通义千问为例）
1. 进入模型配置
右上角用户名 → 设置 → 模型供应商
2. 添加模型服务商
- 搜索并选择：通义千问 / Ollama / 其他模型
- 点击 安装（失败可重试 1～2 次）
3. 配置 API Key
- 在「待配置」区域点击 设置
- 填写凭据名称
- 填入从官方平台（如阿里百炼）获取的 API Key
- 保存并启用
出现绿色可用状态 = 接入成功。
六、避坑指南（全文最值钱）
-
容器启动失败
- 旧容器未清理，端口冲突
- 镜像不完整
- 未将
.env.example改为.env
-
网页无法访问
- IP 不是服务器真实 IP
- 防火墙未放行 80 端口
- 容器还在初始化，未启动完成
-
模型接入失败
- API Key 错误或过期
- 模型未开通权限
- 插件安装异常 → 重试即可
-
解压失败
- 未安装
unzip：yum install unzip
- 未安装
七、极简速查（收藏这一段就够）
bash
运行
# 1. 清理旧环境
cd /root/ai/dev/milvus_redis
docker compose down
# 2. 新建目录
mkdir -p /root/dify_dev && cd /root/dify_dev
# 3. 加载镜像
docker load -i 镜像包.tar
# 4. 解压源码
unzip dify-main.zip
cd dify-main/docker
# 5. 配置环境
mv .env.example .env
# 6. 启动
docker compose up -d
# 7. 访问
http://你的IP/install
# 8. 模型配置：设置 → 模型供应商 → 填入API Key
🔥 互动话题
你在部署 Dify 时遇到过最头疼的问题是什么？
- 容器起不来
- 端口冲突
- 网页打不开
- 模型接不上
- 环境变量报错
评论区留下你的问题，我来帮你定位解决方案
