Linux 上配置 Jenkins 插件的完整步骤
一 准备与环境确认
- 确保已安装 Java 并启动 Jenkins 服务，默认端口为 8080。如使用系统服务，可用命令：sudo systemctl status jenkins 查看状态。
- 首次进入管理界面路径：Manage Jenkins → Manage Plugins，后续所有插件操作均在此处完成。
- 如需离线环境准备，可提前下载所需插件的 .hpi 文件，后续通过界面或命令行安装。
二 在线安装插件
- 在 Available 选项卡中搜索并勾选所需插件，点击 Install without restart 或 Install and restart 完成安装。
- 安装完成后可在 Installed 选项卡查看与管理已装插件。
三 加速插件下载
- 在 Manage Jenkins → Manage Plugins → Advanced 将 Update Site 改为国内镜像，例如：
- 清华大学：https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json
- 或 Xmission：http://mirror.xmission.com/jenkins/updates/update-center.json
- 修改更新站点后，进入 JENKINS_HOME/updates/ 目录（常见路径如：/var/lib/jenkins/updates/ 或 ~/.jenkins/updates/），将 default.json 中的下载域名替换为镜像源，例如：
- sed -i ‘s/updates.jenkins-ci.org/download/mirrors.tuna.tsinghua.edu.cn/jenkins/g’ default.json
- sed -i ‘s/www.google.com/www.baidu.com/g’ default.json
- 修改完成后重启 Jenkins 使配置生效：sudo systemctl restart jenkins。
四 离线安装与命令行安装
- 离线安装（界面）：在 Manage Plugins → Advanced 使用 Upload Plugin 上传 .hpi 文件，上传后按提示重启。
- 离线安装（手动）：将 .hpi 文件复制到 JENKINS_HOME/plugins/（常见路径：/var/lib/jenkins/plugins/），然后重启 Jenkins。
- 命令行安装（jenkins-cli）：
- 下载 jenkins-cli.jar，执行：
- java -jar jenkins-cli.jar -s http://your-jenkins-url/ install-plugin .hpi
- 安装完成后重启 Jenkins。
五 更新卸载与常见问题
- 更新插件：在 Manage Jenkins → Manage Plugins → Updates 选择需要更新的插件并执行更新，按提示重启。
- 卸载插件：在 Installed 选项卡选择插件并执行 Uninstall，随后重启。
- 常见问题与处理：
- 更新站点超时或无法访问：检查服务器网络连通性，替换为可达的国内镜像源（如清华源），并重启服务。
- 插件安装失败或依赖错误：检查网络与依赖，清理插件目录缓存后重试；必要时升级 Jenkins 版本或改为离线安装。
- 证书问题导致安装失败：可临时使用 skip-certificate-check 插件绕过证书校验（仅在内网可信环境使用）。