Dify部署踩坑指南（Windows+Mac）

最新推荐文章于 2025-04-25 22:30:12 发布

原创最新推荐文章于 2025-04-25 22:30:12 发布

· 9.2k 阅读

33 ·

版权

文章标签：

#dify

本地知识库专栏收录该内容

9 篇文章

订阅专栏

组件说明

在这里插入图片描述

Dify踩坑及解决方案

⚠️ 除了修改镜像版本，nginx端口不要直接修改docker-compose.yaml ！！！！！！！

1、更换镜像版本

这个文件是由.env自动生成的，在.env配置

拉取dify-main后，默认的镜像版本是1.0.0，我将镜像版本修改为0.14.2是可以正常用的
（开始在Mac中拉取的就是1.0.0的镜像版本，在添加模型供应商时提示组件缺失，需要再次手动下载各个模型供应商组件，0.14.2版本不存在这个问题）

修改方式：在yaml中搜索1.0.0，将所有的版本号替换为0.14.2

services:
  # API service
  api:
    image: langgenius/dify-api:0.14.2

 web:
    image: langgenius/dify-web:0.14.2
    restart: always

 # worker service
  # The Celery worker for processing the queue.
  worker:
    image: langgenius/dify-api:0.14.2
    restart: always

2、ollama接入dify报错（容器网络隔离）

在这里插入图片描述

Docker内部容器地址默认为127.0.0.1和localhost，非宿主机，需要将 Ollama 服务暴露给网络才可以正常接入

解决：使用host.docker.internal

Windows

Ollama的默认监听地址为127.0.0.1，导致其他容器无法访问，启动Ollama时指定监听所有网络接口0.0.0.0

首先，在系统环境变量中添加OLLAMA_HOST,值为0.0.0.0，并启动ollama

ollama serve

如果提示端口被占用，在任务管理器中关闭所有运行的ollama服务

然后，在宿主机上验证Ollama是否运行正常

curl http://localhost:11434

接着，配置防火墙确保允许外部设备访问Ollama所使用的端口
在这里插入图片描述

Mac

1、设置Ollama环境变量

launchctl setenv OLLAMA_HOST "0.0.0.0"

如果是手动启动 Ollama，可以使用以下命令（临时）

ollama serve --host 0.0.0.0

在 Dify 配置中使用 host.docker.internal

2、从 Dify 容器中测试连接

curl http://host.docker.internal:11434

3、将 Ollama 的地址设置为

http://host.docker.internal:11434

Linux

在[Service]下加上Environment=“OLLAMA_HOST=0.0.0.0”
具体修改方法在这里

3、启动

在dify所在地址栏输入cmd，进入终端，拉取镜像，复制环境变量，采用默认端口启动

cd dify/docker
cp .env.example .env
docker compose up -d

如果修改了配置，需要重启docker，命令如下：

docker compose down
docker compose up -d

如果在拉取镜像中报错

Error response from daemon: Get “https://registry-1.docker.io/v2/”: EOF

请docker镜像源换为国内镜像源

Mac&Windows在Docker桌面中修改

在这里插入图片描述
点击顶部齿轮，进入Docker Engine

#镜像源如下


{
  "registry-mirrors": [
    "https://docker.1panel.live",
    "https://docker.nju.edu.cn",
    "https://docker.m.daocloud.io",
    "https://dockerproxy.com",
    "https://hub-mirror.c.163.com",
    "https://docker.mirrors.ustc.edu.cn",
    "https://registry.docker-cn.com",
    "https://registry.cn-hangzhou.aliyuncs.com"
  ]
}