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 的架构相对清晰，一旦环境准备妥当，使用体验还是非常顺畅的。如果你也在尝试构建属于自己的智能体平台，不妨亲自部署一遍，收获会很多！