在 CentOS 上安装 Jenkins 插件的可行方法
一 通过 Web 界面安装（最常用）
- 登录 Jenkins 管理控制台：访问 http://<服务器IP>:8080，使用管理员账户进入。
- 进入插件管理：点击左侧 Manage Jenkins → Manage Plugins。
- 在线安装：
- 在 Available 页搜索插件（如 Git、Pipeline、Docker Pipeline 等），勾选后点击 Install without restart 或 Install with restart。
- 安装完成后到 Installed 页确认状态，必要时按提示重启 Jenkins。
- 上传安装（离线或指定版本）：
- 在 Advanced 页的 Upload Plugin 区域，选择本地 .hpi/.jpi 文件上传，上传后按提示重启以使插件生效。
二 使用 Jenkins CLI 安装（适合自动化与批量）
- 获取 CLI：在 Manage Jenkins → Global Tool Configuration 下载 jenkins-cli.jar，或在 Jenkins 首页右侧找到 CLI 下载链接。
- 安装插件命令示例：
- java -jar jenkins-cli.jar -s http://<服务器IP>:8080/ install-plugin git
- 批量安装（示例）：
- java -jar jenkins-cli.jar -s http://<服务器IP>:8080/ install-plugin git maven-integration workflow-aggregator
- 安装后重启以使插件生效：
- java -jar jenkins-cli.jar -s http://<服务器IP>:8080/ safe-restart
三 离线手动安装到插件目录（无外网或受限网络）
- 准备插件包：从官方或镜像站点下载 .hpi/.jpi 插件文件。
- 放置插件文件：将插件解压或直接复制到 /var/lib/jenkins/plugins/（推荐保持目录结构，插件目录名与文件名一致，避免嵌套错误）。
- 修正权限（如使用非 jenkins 用户运行）：
- chown -R jenkins:jenkins /var/lib/jenkins/plugins
- 重启 Jenkins 生效：
- systemctl restart jenkins
- 说明：也可将他人打包好的插件目录整体拷贝到 /var/lib/jenkins/plugins/ 后重启。
四 提升下载速度（更换更新站点与镜像）
- 更新站点镜像（UI 方式）：
- 进入 Manage Jenkins → Manage Plugins → Advanced，将 Update Site 改为 https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json，保存后重启。
- 替换更新中心元数据（文件方式）：
- sed -i ‘s|http://updates.jenkins-ci.org/download|https://mirrors.tuna.tsinghua.edu.cn/jenkins|g’ /var/lib/jenkins/updates/default.json
- sed -i ‘s|http://www.google.com|https://www.baidu.com|g’ /var/lib/jenkins/updates/default.json
- 重启 Jenkins 后再次尝试安装插件。
五 常见问题与排查要点
- 版本兼容：安装前确认 Jenkins 版本与插件兼容，必要时先升级 Jenkins 或选择插件兼容版本。
- 网络与离线：在线安装失败可更换为国内镜像或采用 上传 .hpi / 离线拷贝到 plugins 的方式。
- 重启策略：多数插件安装后需重启；Web 安装可选 Install without restart，但部分插件或环境需要重启才生效。
- 目录与权限：手动安装时确保插件文件在 /var/lib/jenkins/plugins/ 且 jenkins 用户有读写权限。
- 依赖关系：部分插件依赖其他插件，安装过程中会自动解析依赖；如失败请按提示安装依赖项。
