Dify 快速部署 & Docker 切换国内镜像教程
本地部署
1. 拉取代码
拉取dify在国内gitee的仓库速度更快,也可以拉github的仓库
git clone git clone https://gitee.com/dify_ai/dify.git
2. docker 安装
2.1 安装docker命令
先直接用yum或者apt安装docker
yum install -y docker # centos
apt install -y docker # ubuntu
验证安装
docker --version # 例如输出 Docker version 29.1.5, build 0e6fee6
2.2 安装docker compose
目前dify 1.11版本的docker-compose.yaml包含了required语法,v1版本的docker-compose(带横杠的版本)无法直接up起容器,需要安装或升级为v2版本的docker compose(不带横杠的版本)
可以直接使用命令拉取安装脚本去执行,这里不赘述,命令细节可问AI
但直接拉取有时网络访问外网会超时,建议手动安装!使用魔法访问docker compose的官方仓库,在release里面手动下载对应版本的二进制文件,例如docker-compose-linux-x86-64
# 创建目标文件夹
mkdir -p ~/.docker/cli-plugins/
# 授权
chmod +x docker-compose-linux-x86-64
# 拷贝至目标路径,注意命名
cp ./docker-compose-linux-x86-64 ~/.docker/cli-plugins/docker-compose
验证安装
docker compose version # 例如输出 Docker Compose version v5.0.1
2.3 docker切换镜像源
一般在搜索引擎搜索“docker切换镜像源”就会推荐大量教程博客,这里推荐一篇,使用了很久了,非常稳定!且给了自动配置脚本
# 拉取配置脚本
curl -fsSL --connect-timeout 10 --retry 3
https://linuxmirrors.cn/docker.sh -o /tmp/docker.sh
# 执行
sudo bash /tmp/docker.sh
--source mirrors.tencent.com/docker-ce
--source-registry docker.1ms.run
--protocol https
--install-latested true
--close-firewall false
--ignore-backup-tips
按照提示一步步互动,即可完成切换!
3. 使用docker部署dify
生成.env文件,直接up
cd ./dify/docker/
cp .env.example .env
docker compose up -d
然后docker ps检查一下各个容器的情况,有问题的话docker log看看日志排查
公网部署
需要额外改一下docker-compose.yaml来解决跨域问题(跳转插件等页面时会报错)
打开你的 docker-compose.yml 文件,找到 api 服务的 environment 节点,新增两行配置
services:
api:
image: docker.langgenius.com/dify/dify-api:latest
environment:
# 新增↓↓↓ 这两行是核心,解决跨域+插件接口地址错误
PUBLIC_URL: "http://:"
ALLOW_ORIGINS: "*"
# 其他原有配置保留不变...
同时找到 web 服务的 environment,也新增这两行(一样的配置)。
重启容器即可生效
docker-compose down && docker-compose up -d
关键补充:ALLOW_ORIGINS 变量的作用
这个变量是解决「跨域问题」,值写 * 表示允许所有域名的前端请求后端接口,开发/自用场景完全没问题,生产环境如果绑定了域名,可以改成你的域名,比如 ALLOW_ORIGINS=http://dify.xxx.com。











