问题背景

随着大模型的普及很多开始学习智能体开发，dify作为开源智能体平台可以私有部署、二次开发，商用协议友好，但在实际安装时经历很多问题，主要是因为在国内无法访问docker镜像导致安装失败，但按网上教程更换镜像源、设置dns等方法后也无效，最后经过冷静思考找到解决方案。

问题分析

按照官方教程首先应该下载dify源码，然后进入源码的docker目录中执行：

docker-compose up -d

命令，该命令会根据dify的docker-compose.yaml docker配置文件进行下载、安装、启动docker镜像和容器。

主要出现的错误是：访问 https://registry-1.docker.io/v2/ 超时，网上各种方法都尝试后无法解决。特别是更换为国内镜像源，重启docker后仍然无效，还是报这个错误。

无法解决的主要原因是国内镜像源都只提供给自己的用户免费使用，对游客不开放，例如：阿里云镜像只允许在阿里云的服务器中访问镜像源地址，而且时间也有限制。

解决方案

寻找靠谱的镜像源

寻找靠谱的镜像源，在浏览器中确定实时能访问到。
推荐一个：https://docker.aityp.com/

直接修改docker-compose.yaml

直接修改docker-compose.yaml中镜像源地址，默认配置文件是通过系统配置的镜像源去下载，而我通过把镜像修改为国内镜像源。

经过上述配置后100%安装成功。

下载配置好的docker-compose.yaml

可以直接使用已经配置好的，点击下载