一聚教程网:一个值得你收藏的教程网站

最新下载

热门教程

Dify Ollama插件安装403清华源报错:完整解决方案

时间:2026-07-23 17:59:49 编辑:袖梨 来源:一聚教程网

报错根因

日志核心:403 Forbidden 访问清华 PyPI 镜像下载 blinker 包被拒绝

Dify Ollama插件安装403清华源报错的完整解决方案

  1. Dify 内置插件安装时默认使用清华 pip 源,当前清华源对容器环境 / IP 拦截,返回 403 禁止访问;
  2. 插件容器内无法换源、网络受限,依赖下载失败直接抛出 exit status 2failed to init environment

方案 1:修改 Dify 全局 pip 源(推荐,永久生效)

1. 找到 Dify 环境配置文件

  • Docker 部署:docker-compose.yml.env
  • 容器内 Dify 后端配置:api/.env

2. 添加全局 pip 镜像变量,切换官方 / 阿里云源

.env 新增环境变量:

PIP_INDEX_URL=https://mirrors.aliyun.com/pypi/simple/
PIP_TRUSTED_HOST=mirrors.aliyun.com
# 备选官方源
# PIP_INDEX_URL=https://pypi.org/simple

3. 重启 Dify 服务

docker compose down && docker compose up -d

重启后重新安装 Ollama 插件,pip 会走阿里云源,规避清华 403 拦截。

方案 2:临时修改插件安装时 pip 源(容器内手动修复)

  1. 进入 dify-api 容器
docker exec -it dify-api bash
  1. 创建 pip 全局配置,强制换阿里云源
mkdir -p ~/.pip
cat > ~/.pip/pip.conf <
  1. 退出容器,后台重启 api 服务,重新安装插件。

方案 3:离线手动安装 Ollama 插件(网络完全隔离场景)

  1. 本地能联网机器下载插件依赖包
pip download blinker==1.9.0 -d ./wheels -i https://mirrors.aliyun.com/pypi/simple
  1. 将 whl 包拷贝到 Dify 插件工作目录: /app/storage/cwd/langgenius/ollama-xxx/
  2. 容器内手动离线安装依赖:
pip install *.whl --no-index --find-links=.

方案 4:网络侧排查(如果换源仍 403)

  1. 宿主机 / 容器开启代&理 / 防火墙拦截了清华源域名;
  2. 容器出口 IP 被清华镜像站拉黑,不要继续使用清华源,固定阿里云 / 官方源;
  3. 检查 Dify 容器是否无外网访问权限,测试容器内 ping mirrors.aliyun.com。

补充兜底方案:直接使用 Dify 官方 Ollama 模型接入(不用插件)

插件依赖安装容易出 pip 网络问题,可绕过插件:

  1. 进入 Dify → 模型供应商 → Ollama;
  2. 填写 Ollama 服务地址 http://host.docker.internal:11434(Docker 部署)或宿主机 IP;
  3. 直接拉取模型,无需安装第三方插件,彻底规避 pip 依赖报错。

验证修复是否生效

重新安装插件,日志不再出现 https://pypi.tuna.tsinghua.edu.cn 链接,全部走阿里云 mirrors 域名,无 403 报错即修复完成。

配置安装成功后,注意如果要在dify是部署在docker中的话,

ollama的地址要写为http://host.docker.internal:11434

热门栏目