咨询Docker部署官方LTS版Jenkins安装插件报读取超时的解决方法
问题根因
当前在多套独立网络环境下复现的Jenkins插件安装失败、updates.jenkins.io访问读超时的问题,本质是Jenkins官方更新服务器在亚太区域的路由链路存在间歇性异常,并非本地设备、Docker部署的jenkins/jenkins:lts镜像本身存在配置错误,也不属于Jenkins官方公示的计划性服务器维护范畴。
从日志的报错特征判断:请求完成TCP连接建立后等待响应阶段触发超时,未出现DNS解析失败、连接被拒绝类的本地网络拦截报错,可排除本地防火墙、代理配置不当的影响。
可落地临时解决方案
- 替换更新中心镜像源:进入Jenkins管理面板的「插件管理-高级设置」页面,将默认的官方更新站点地址
https://updates.jenkins.io/update-center.json替换为亚太区域可稳定访问的镜像地址https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/current/update-center.json;同时修改容器内挂载路径/var/jenkins_home/updates/default.json中的插件下载基础路径,将所有指向updates.jenkins.io/download的前缀替换为对应镜像的路径前缀,避免拉取插件元数据完成后,跳转回官方地址下载插件包触发超时。修改完成后先手动触发一次更新源拉取,验证连通性正常后再进行插件安装。 - 调整下载超时阈值:在插件管理的高级设置区域,将插件下载的默认超时时间从30秒调整为120秒,可有效缓解网络波动导致的瞬时读超时问题。
- 离线安装插件:如果临时需要部署关键业务插件,可获取与当前Jenkins LTS版本兼容的插件hpi/jpi安装包,通过高级设置页面的「上传插件」入口手动上传安装,安装完成后重启Jenkins实例即可生效。
注意操作过程中需确认Jenkins容器挂载的/var/jenkins_home目录具备读写权限,避免修改的配置无法持久化,重启容器后恢复原有异常状态。
内容的提问来源于stack exchange,提问作者Phương Hầu
相关产品推荐
相关产品推荐

