在自建服务器上安装Jenkins服务后，下载插件失败是一个常见问题。以下是详细的排查步骤和解决方案：

1. 确认网络连接

首先检查服务器是否能正常访问互联网：
`bash
ping mirrors.jenkins.io
curl -I https://updates.jenkins.io
`
如果网络不通，需检查防火墙设置或网络配置。

2. 修改更新中心地址

Jenkins默认使用国外镜像，国内访问可能较慢或不稳定。进入【Manage Jenkins】→【Manage Plugins】→【Advanced】：

• 将【Update Site】URL替换为国内镜像：
• 清华大学镜像：https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json

• 华为云镜像：https://mirrors.huaweicloud.com/jenkins/updates/update-center.json

3. 配置代理（如需）

如果服务器需要通过代理访问外网，需配置代理设置：
`bash
# 在Jenkins启动前设置环境变量

export httpproxy=http://proxyip:port
export httpsproxy=http://proxyip:port
# 或在Jenkins管理页面配置

【Manage Jenkins】→【Manage Plugins】→【Advanced】→【HTTP Proxy Configuration】

`

4. 手动安装插件

如果在线安装仍失败，可手动下载插件：

1. 访问 https://plugins.jenkins.io/ 搜索所需插件
2. 下载.hpi文件
3. 进入【Manage Jenkins】→【Manage Plugins】→【Advanced】
4. 在【Upload Plugin】区域上传.hpi文件

5. 检查Java环境

确保已安装Java 8或Java 11：
`bash
java -version
`
如果版本不兼容，需重新安装合适版本的JDK。

6. 清除缓存并重试

`bash # 停止Jenkins服务

sudo systemctl stop jenkins

清除插件缓存

sudo rm -rf /var/lib/jenkins/updates/*

重启Jenkins

sudo systemctl start jenkins
`

7. 检查磁盘空间和权限

`bash # 检查磁盘空间

df -h /var/lib/jenkins

确保Jenkins用户有写入权限

sudo chown -R jenkins:jenkins /var/lib/jenkins
`

8. 查看详细错误日志

在Jenkins管理页面查看日志：
【Manage Jenkins】→【System Log】→【Jenkins Log】
或直接查看服务器日志文件：
`bash
sudo tail -f /var/log/jenkins/jenkins.log
`

9. 离线安装方案（极端情况）

如果服务器完全无法连接外网：

1. 在能上网的机器下载所有依赖插件及其依赖项
2. 将插件文件复制到服务器
3. 将插件放入/var/lib/jenkins/plugins目录
4. 重启Jenkins服务

预防建议

1. 首次安装时选择【安装推荐插件】，避免单独下载
2. 定期备份/var/lib/jenkins/plugins目录
3. 考虑使用Docker方式部署Jenkins，便于迁移和恢复

通过以上步骤，大多数插件下载问题都能得到解决。如果问题持续存在，建议查看官方文档或社区论坛获取特定错误代码的解决方案。