Dify 1.6 安装与踩坑记录(Docker 方式)
研究 Dify 智能体平台。Dify 在 1.6 版本中改进了不少智能体工作流的能力,因此我选择了直接部署最新版来做本地测试。但安装过程中还是遇到了一些坑,简单记录一下,方便大家避坑。
🛠️ 安装步骤(基础流程)
首先准备一个干净的文件夹,开始部署:
mkdir dify1.6
cd dify1.6
下载官方提供的 docker-compose.yml 和 .env.example:
curl -O https://raw.githubusercontent.com/langgenius/dify/main/docker/docker-compose.yml
curl -O https://raw.githubusercontent.com/langgenius/dify/main/docker/.env.example
mv .env.example .env
拉取镜像:
docker compose pull
⚠️ 遇到的坑:Nginx 和 SSRF Proxy 报错
启动容器后,我发现 nginx 和 ssrf_proxy 这两个服务出现了问题,无法启动。
主要问题有两个:
1. nginx 和 ssrf_proxy 的启动脚本无法执行
解决方式是重新下载脚本文件并赋予执行权限:
file docker-entrypoint.sh # 检查文件类型
ls -l docker-entrypoint.sh # 确认权限
chmod +x docker-entrypoint.sh
这个问题很可能是因为下载脚本过程存储文件出现问题或 GitHub 的 Raw 下载方式未保持可执行属性。
2. sandbox 服务的配置缺失
Dify 中的 sandbox 服务也是配置文件有问题,直接重新下载
volumes/sandbox/conf/config.yaml
注意路径需要精确,否则启动时会找不到 config 文件。
github下载链接
✅ 启动 Dify 服务
一切准备好后,就可以启动服务了:
docker compose up -d
接下来可以通过浏览器访问:
http://localhost
📌 总结
本次部署过程中有以下几个关键点需要注意:
问题点 | 原因 | 解决方案 |
---|---|---|
nginx 和 ssrf_proxy 启动失败 | 启动脚本未设置可执行权限或格式错误 | 重新下载并 chmod +x |
sandbox 启动失败 | 缺少 config.yaml | 手动创建配置文件目录和内容 |
镜像拉取速度慢 | 国内网络问题 | 可考虑配置镜像加速器或预拉镜像 |
Dify 的架构相对清晰,一旦环境准备妥当,使用体验还是非常顺畅的。如果你也在尝试构建属于自己的智能体平台,不妨亲自部署一遍,收获会很多!