Jenkins Windows MSI 安装包完整安装教程

📦 Jenkins Windows MSI 安装包完整安装教程

下面是从下载到启动的全流程，每一步都有详细说明，新手也能一次成功。

一、安装前准备（必做！）

Jenkins 是基于 Java 开发的，必须先安装 JDK，否则安装会失败。

JDK 版本要求 ：
- Jenkins 2.346.3 LTS（你截图的版本）：要求 JDK 11 或 JDK 17
- Jenkins 2.366+：要求 JDK 11 或 JDK 17（部分新版本已不支持 JDK 8）
验证安装 ：打开 cmd 命令提示符，输入 java -version，能看到版本号即说明安装成功。

cmd
复制代码
```
java -version
```
配置环境变量 ：确保 JAVA_HOME 系统变量已正确配置，指向 JDK 安装目录（如 C:\Program Files\Java\jdk-11.0.xx）。

二、MSI 安装包安装步骤

步骤 1：运行安装程序

双击你下载的 jenkins.msi 文件，启动安装向导，点击 Next。

系统无法识别 .msi 文件的默认打开程序时，用命令行强制运行安装程序（最快）

按下 Win + R 打开「运行」，输入 cmd，按 Ctrl + Shift + Enter 以管理员身份打开命令提示符。
切换到 jenkins.msi 所在目录（假设文件在桌面）：

cmd
复制代码
```
cd %USERPROFILE%\Desktop
```
执行安装命令： cmd
复制代码
```
msiexec /i jenkins.msi
```
msiexec 是 Windows 安装程序核心工具，/i 表示安装，执行后会直接弹出安装向导。

步骤 2：选择安装目录

默认安装路径为 C:\Program Files\Jenkins\，建议保持默认，也可自定义路径，点击 Next。

步骤 3：选择服务运行账户（关键步骤）

Jenkins 会以 Windows 服务的形式后台运行，需要选择服务账户：

推荐选择 ：Use Local System account（本地系统账户，权限最高，适合绝大多数场景，无需额外配置）
备选方案 ：Use a different user account（指定专用服务账户，适合企业级安全要求高的场景，需手动输入账户密码）选择后点击 Next。

步骤 4：配置服务端口

默认端口为 8080 ，如果 8080 端口被占用（如被 Tomcat、其他服务占用），可修改为其他端口（如 8081、9090），点击 Next。

验证端口是否被占用：cmd 输入 netstat -ano | findstr "8080"，无输出则端口空闲。

步骤 5：指定 JDK 路径

安装程序会自动检测已安装的 JDK，如果自动识别失败，手动填写 JAVA_HOME 路径（如 C:\Program Files\Java\jdk-11.0.20），点击 Next。

步骤 6：完成安装

点击 Install 开始安装，等待进度条完成后，点击 Finish，安装向导会自动启动 Jenkins 服务。

三、安装后初始化配置

步骤 1：访问 Jenkins 控制台

打开浏览器，输入 http://localhost:8080（如果修改了端口，对应改为 http://localhost:你的端口），进入解锁页面。

步骤 2：获取初始管理员密码

Jenkins 会生成一个随机初始密码，存储在以下路径：

plaintext

复制代码

C:\Program Files\Jenkins\secrets\initialAdminPassword

用记事本打开该文件，复制里面的 32 位字符串，粘贴到浏览器的输入框中，点击 Continue。

步骤 3：安装插件

推荐选择 ：Install suggested plugins（安装推荐插件，包含 Git、Maven、Pipeline 等常用插件，适合新手）
自定义选择 ：Select plugins to install（按需选择，适合有经验的用户）等待插件安装完成，自动进入下一步。

步骤 4：创建管理员账户

设置管理员用户名、密码、邮箱，点击 Save and Continue（建议妥善保存账户信息）。

步骤 5：配置实例 URL

默认 URL 为 http://localhost:8080/，如果是服务器部署，可修改为服务器 IP / 域名（如 http://192.168.1.100:8080/），点击 Save and Finish。

步骤 6：开始使用

点击 Start using Jenkins，即可进入 Jenkins 主界面，安装完成！

四、常见问题与解决方案

1. 安装后无法访问 `http://localhost:8080`

原因 1 ：Jenkins 服务未启动解决：Win+R 输入 services.msc，找到 Jenkins 服务，右键选择「启动」，并设置为「自动」启动。
原因 2 ：端口被占用解决：修改 Jenkins 端口：
1. 停止 Jenkins 服务
2. 打开 C:\Program Files\Jenkins\jenkins.xml
3. 修改 <arguments> 标签中的 --httpPort=8080 为 --httpPort=8081
4. 保存后重启 Jenkins 服务，访问 http://localhost:8081
原因 3：防火墙拦截解决：在 Windows 防火墙中，允许 Jenkins 程序通过防火墙，或开放对应端口。

2. 忘记管理员密码

停止 Jenkins 服务
打开 C:\Program Files\Jenkins\config.xml
找到 <useSecurity>true</useSecurity>，修改为 <useSecurity>false</useSecurity>
保存后重启 Jenkins 服务，此时无需密码即可登录
登录后重新设置管理员密码，再改回 <useSecurity>true</useSecurity>，重启服务

3. 服务启动失败

检查 JDK 版本是否符合要求，JAVA_HOME 是否配置正确
检查 jenkins.xml 中的 JDK 路径是否正确
查看日志 C:\Program Files\Jenkins\jenkins.err.log 定位具体错误

五、MSI 安装 vs WAR 包部署对比

表格

特性	MSI 安装包	WAR 包部署
部署难度	一键安装，自动配置服务	手动部署，需命令行启动
运行方式	后台 Windows 服务，开机自启	依赖命令行窗口，关闭则停止
灵活性	低，适合生产环境	高，适合开发测试
维护成本	低，服务自动管理	高，需手动启停、配置

六、后续优化建议

配置 HTTPS：生产环境建议配置 SSL 证书，启用 HTTPS 访问，保障数据安全
配置邮件通知：在系统设置中配置 SMTP 服务器，实现构建失败邮件提醒
安装常用插件 ：如 GitLab、SonarQube、Allure 等，适配自动化测试 / CI/CD 流程
备份数据 ：定期备份 C:\Program Files\Jenkins\ 目录，防止数据丢失

Jenkins Windows MSI 安装包完整安装教程