Jenkins插件怎么安装

Jenkins 插件安装主要有 在线安装、离线安装 和 命令行/脚本安装 三种方式，下面按常见场景一步步说明（适用于 Jenkins 2.x）。

一、在线安装（最常用 ✅）

1️⃣ 通过 Web 界面安装

1. 登录 Jenkins
2. 进入：

   Manage Jenkins → Manage Plugins（插件管理）
   

3. 切换到 Available（可选插件）
4. 搜索你需要的插件
   例如：Git、Pipeline、Blue Ocean
5. 勾选插件 → 点击 Install without restart 或 Download now and install after restart
6. 安装完成后，重启 Jenkins（如需要）

✅ 适合：Jenkins 能访问互联网的情况

二、离线安装（内网 / 无外网环境）

方式 1：手动上传 .hpi 文件

步骤

1. 在能上网的机器访问：

   https://plugins.jenkins.io/
   

2. 搜索插件 → 下载 .hpi 文件
   ⚠️ 注意 Jenkins 版本兼容性
3. 进入 Jenkins：

   Manage Jenkins → Manage Plugins → Advanced
   

4. 在 Upload Plugin 区域上传 .hpi
5. 上传完成后重启 Jenkins

✅ 适合：内网服务器、安全限制环境

方式 2：依赖插件也要一起装 ⚠️

很多插件有 依赖插件，否则会安装失败或功能异常。
建议：

• 查看插件页面的 Dependencies
• 一并下载并安装依赖插件

三、通过 Jenkins CLI 安装（高级）

java -jar jenkins-cli.jar -s http://localhost:8080/ install-plugin git

或指定版本：

install-plugin http://url/to/plugin.hpi

四、Docker / 启动参数安装（推荐自动化）

Docker 示例

docker run -d \
  -p 8080:8080 \
  -p 50000:50000 \
  -v jenkins_home:/var/jenkins_home \
  jenkins/jenkins:lts

安装插件（推荐用 install-plugins.sh）：

install-plugins.sh git pipeline-model-definition blueocean

五、使用 plugins.txt（CI / 自动化部署推荐 ✅）

1️⃣ 创建 plugins.txt

git
pipeline-model-definition
blueocean
docker-workflow

2️⃣ 启动时自动安装

jenkins-plugin-cli --plugin-file plugins.txt

六、常见问题排查

❌ 插件安装失败

• Jenkins 版本过低
• 依赖插件未安装
• 网络问题（代理 / 防火墙）

✅ 检查日志

Manage Jenkins → System Log

或服务器日志：

/var/log/jenkins/jenkins.log

七、推荐基础插件（新环境）

• Git
• Pipeline
• Blue Ocean
• Docker Pipeline
• Credentials Binding
• SSH Agent

如果你愿意，可以告诉我：

• ✅ Jenkins 版本
• ✅ 是否联网
• ✅ 是 Docker / Linux / Windows
• ✅ 想装哪个插件

我可以给你 最合适的具体安装方案。