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

报错根因

安装 Dify 的 Ollama 插件时，卡在 pip 依赖下载这一步，报错日志里反复出现 403 Forbidden。这其实是个典型的环境问题，我们先来拆解一下。

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

1. Dify 内置插件安装时，默认走的是清华 pip 源。问题就出在这儿——清华源最近对容器环境、特定IP段做了拦截，直接返回403，禁止访问；
2. 容器内部环境受限，没法改源，也没法自由访问外网。依赖一但下载失败，插件安装就会直接抛出 exit status 2、failed 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 <
退出容器，后台重启 api 服务，重新安装插件。
方案 3：离线手动安装 Ollama 插件（网络完全隔离场景）
如果容器环境完全没法联网，或者网络策略极其严格，离线安装是最后的办法。
在本地能联网的机器上，把依赖包提前下载好
pip download blinker==1.9.0 -d ./wheels -i https://mirrors.aliyun.com/pypi/simple

把下载好的 whl 包拷贝到 Dify 插件工作目录： /app/storage/cwd/langgenius/ollama-xxx/
容器内手动离线安装依赖：
pip install *.whl --no-index --find-links=.

方案 4：网络侧排查（如果换源仍 403）
如果换了源还是报403，那问题可能不在源上，而在网络本身。
检查宿主机或容器是否开启了袋里、防火墙，拦截了清华源域名；
容器出口 IP 可能已经被清华镜像站拉黑，
不要继续使用清华源
，直接固定阿里云或官方源；
测试容器内能否访问外网，比如在容器里 ping 一下 mirrors.aliyun.com，看通不通。
补充兜底方案：直接使用 Dify 官方 Ollama 模型接入（不用插件）
最后一个方案，算是彻底绕开问题的办法。插件依赖安装容易出 pip 网络问题，那就不装插件，直接用 Dify 的 Ollama 模型接入功能。
进入 Dify → 模型供应商 → Ollama；
填写 Ollama 服务地址 http://host.docker.internal:11434（Docker 部署）或宿主机 IP；
直接拉取模型，无需安装第三方插件，pip 依赖报错的问题自然消失。
验证修复是否生效
重新安装插件，观察日志。如果日志里不再出现 https://pypi.tuna.tsinghua.edu.cn 这个链接，所有请求都走阿里云 mirrors 域名，并且没有 403 报错，说明修复成功。
配置安装成功后，注意如果 Dify 部署在 Docker 中，Ollama 的地址要写为 http://host.docker.internal:11434，这是 Docker 容器内访问宿主机服务的标准方式。