资讯详情

深入了解 · 专业解读

Dify 插件安装问题解决指南

发布时间：2026/7/9 14:26:01
Dify 插件安装问题解决指南 Dify 插件安装问题解决指南问题描述在 Dify 中安装插件如 DeepSeek 插件时遇到以下错误failed to launch plugin: failed to install dependencies: failed to install dependencies: exit status 1常见的具体错误包括init process exited due to no activity for 120 seconds- 初始化超时operation timed out- 网络下载超时Failed to download distribution due to network timeout- uv 包管理器超时下载大文件如 tiktoken, pydantic-core时卡住根本原因1. 初始化超时时间太短Dify 默认的 Python 环境初始化超时只有 120 秒在网络较慢或安装依赖较多时很容易超时。2. 国外 PyPI 源访问慢在中国网络环境下访问官方 PyPI 源files.pythonhosted.org速度很慢经常超时。3. Dify v1.14 使用 uv 包管理器从 Dify v1.14 开始插件系统使用uv替代pip作为包管理器而uv有自己独立的配置不读取PIP_MIRROR_URL。4. uv 默认 HTTP 超时太短uv 默认的 HTTP 超时只有 30 秒下载大文件如 tiktoken时很容易超时。完整解决方案步骤 1: 修改 .env 配置文件在 Dify 的docker/.env文件中添加或修改以下配置# ------------------------------------------------------------------ # 插件安装优化配置中国大陆网络环境专用 # ------------------------------------------------------------------ # 1. Python 环境初始化超时从默认 120 秒改为 1200 秒 20 分钟 PLUGIN_PYTHON_ENV_INIT_TIMEOUT1200 # 2. pip 镜像源配置兼容旧版本 PIP_MIRROR_URLhttps://pypi.tuna.tsinghua.edu.cn/simple # 3. uv 包管理器镜像源关键Dify v1.14 使用 uv UV_INDEX_URLhttps://pypi.tuna.tsinghua.edu.cn/simple # 4. uv HTTP 请求超时从默认 30 秒改为 300 秒 5 分钟 UV_HTTP_TIMEOUT300步骤 2: 重新创建 plugin_daemon 容器注意仅仅 restart 是不够的必须重新创建容器才能使环境变量生效。cddockerdocker-composeup-d--force-recreate plugin_daemon步骤 3: 验证配置是否生效# 进入容器检查环境变量dockerexecdocker-plugin_daemon-1bash-c echo 配置检查 echo PLUGIN_PYTHON_ENV_INIT_TIMEOUT\$PLUGIN_PYTHON_ENV_INIT_TIMEOUTecho PIP_MIRROR_URL\$PIP_MIRROR_URLecho UV_INDEX_URL\$UV_INDEX_URLecho UV_HTTP_TIMEOUT\$UV_HTTP_TIMEOUT应该输出 配置检查 PLUGIN_PYTHON_ENV_INIT_TIMEOUT1200 PIP_MIRROR_URLhttps://pypi.tuna.tsinghua.edu.cn/simple UV_INDEX_URLhttps://pypi.tuna.tsinghua.edu.cn/simple UV_HTTP_TIMEOUT300步骤 4: 清理失败的安装缓存可选如果之前有失败的安装建议清理缓存后重试dockerexecdocker-plugin_daemon-1bash-c rm -rf /app/storage/cwd/langgenius/deepseek-* echo 已清理 DeepSeek 缓存目录 步骤 5: 重新安装插件在 Dify 界面中再次尝试安装插件。配置对照表环境变量默认值推荐值说明PLUGIN_PYTHON_ENV_INIT_TIMEOUT1201200Python 环境初始化超时秒PIP_MIRROR_URL空https://pypi.tuna.tsinghua.edu.cn/simplepip 镜像源UV_INDEX_URL空https://pypi.tuna.tsinghua.edu.cn/simpleuv 镜像源(关键!)UV_HTTP_TIMEOUT30300uv HTTP 下载超时秒常用排查命令查看 plugin_daemon 日志dockerlogs-fdocker-plugin_daemon-1查看容器内的环境变量dockerexecdocker-plugin_daemon-1env|grep-E(PIP|UV|PLUGIN)测试网络连接# 测试清华源是否可访问dockerexecdocker-plugin_daemon-1curl-Ihttps://pypi.tuna.tsinghua.edu.cn/simple/手动测试 uv 安装dockerexecdocker-plugin_daemon-1bash-c cd /tmp uv pip install tiktoken --dry-run 其他可选的镜像源如果清华源速度不理想可以尝试以下镜像源镜像源URL阿里云https://mirrors.aliyun.com/pypi/simple/中科大https://pypi.mirrors.ustc.edu.cn/simple/豆瓣https://pypi.douban.com/simple/华为云https://repo.huaweicloud.com/repository/pypi/simple修改方法将.env中的UV_INDEX_URL和PIP_MIRROR_URL替换为对应 URL然后重新创建容器。Docker 资源不足的情况如果仍然遇到signal: killed错误可能是 Docker 内存不足打开 Docker Desktop 设置进入 Resources资源增加配置Memory: 至少 4GB推荐 8GBCPU: 至少 4 核Swap: 2GB 以上总结快速操作清单下次部署时直接按以下步骤操作✅ 编辑docker/.env添加 4 个环境变量见上方完整配置✅ 执行docker-compose up -d --force-recreate plugin_daemon重新创建容器✅ 验证配置生效✅ 在 Dify 界面安装插件记住修改 .env 后必须用--force-recreate重新创建容器单纯 restart 环境变量不会生效版本信息适用 Dify 版本: v1.14.0

相关新闻