Windows 本地安装 Jenkins 教程

博主最近想装Jenkins跑一跑自动化,发现很多教程会让你去下载 .msi 或 .exe 安装包,但是一直都失败, 一直插件镜像源出错/连不上等问题, 其实最佳实践是: 使用 .war 包在 Windows 命令行极简启动, 这是目前在 Windows 上做自动化测试、测开练习最灵活、最稳定、最容易排错的安装方式。

第一阶段：准备 Java 17 或 21 环境

Jenkins 从 2.357 版本开始，不再支持 Java 8 和 Java 11。

下载 JDK 17 (或 21) ：
- 推荐去 Oracle 官网或国内镜像（如清华镜像、华为云）下载 jdk-17_windows-x64_bin.zip 或 .exe。
安装并配置环境变量 ：
- 如果不影响你现有的 JDK 8，你可以只解压不配置全局环境变量。
- 假设你把 JDK 17 解压到了 D:\Environment\jdk-17。

第二阶段：下载并启动 Jenkins

1. 下载 `jenkins.war`

进入 Jenkins 官方下载页：https://www.jenkins.io/download/
在左侧的 LTS (Long-Term Support) 版本下，找到 Generic Java package (.war)。
点击下载 jenkins.war。

2. 创建 Jenkins 工作目录

为了不让 Jenkins 把数据拉得到处都是（默认会拉在 C:\Users\你的用户名\.jenkins，导致 C 盘爆炸），我们手动指定它的"家"。

在 D 盘或 E 盘创建一个文件夹，比如：D:\Jenkins。
把你刚才下载的 jenkins.war 放到这个目录里。

3. 编写启动脚本 (解决所有环境和权限问题)

在 D:\Jenkins 目录下，新建一个文本文档，改名为 start_jenkins.bat。

右键编辑这个 .bat 文件，输入以下内容：

bat 复制代码

@echo off
title Jenkins Server

:: 设置 JDK 17 的路径 (替换成你刚才解压的实际路径)
set JAVA_HOME=D:\Environment\jdk-17
set PATH=%JAVA_HOME%\bin;%PATH%

:: 设置 Jenkins 的工作目录 (数据会存在这里，而不是 C 盘)
set JENKINS_HOME=D:\Jenkins\data

:: 启动 Jenkins (修改端口为 8080，如果被占用可以改 8888)
echo 正在启动 Jenkins...
java -jar jenkins.war --httpPort=8080

pause

保存文件。

第三阶段：解决国内插件源连不上的"世纪难题"🚨

现在，双击运行你刚才写的 start_jenkins.bat。

你会看到一个黑色的命令行窗口跳出大量的启动日志。
等大概 30 秒 ，日志中会出现一串类似于 ************************************************************* 包裹的随机密码（这就是初始密码）。
注意！此时先不要去浏览器打开网页！
（因为此时 Jenkins 默认的插件更新源是海外地址，一旦打开网页，它会去连谷歌测试网络，大概率会一直卡在 Getting Started 页面转圈，或者在安装插件时全部标红失败。）

核心破解步骤：替换国内清华源

先关闭 Jenkins ：在这个黑色命令行窗口里，按下 Ctrl + C，输入 Y 结束批处理（或者直接点右上角 X 关掉窗口）。
找到配置文件 ：
- 打开你刚才在脚本里设置的数据目录：D:\Jenkins\data
- 找到一个叫 hudson.model.UpdateCenter.xml 的文件，用记事本或 VSCode 打开。
修改 URL ：
将里面的 <url>https://updates.jenkins.io/update-center.json</url>
替换为清华大学的镜像源：
<url>https://updates.jenkins.io/stable/update-center.json</url>
修改 default.json (解决网络连通性测试卡死) ：
- 进入 D:\Jenkins\data\updates 目录（如果还没有这个目录，请看下面的附录说明）。
- 找到 default.json 文件，用文本编辑器打开（这个文件很大，建议用 VSCode）。
- 使用编辑器的查找替换 (Ctrl+H) 功能：
  - 查找：https://updates.jenkins.io/download
  - 全部替换为：https://mirrors.tuna.tsinghua.edu.cn/jenkins
  - 查找：https://www.google.com
  - 全部替换为：https://www.baidu.com
- 保存文件。

第四阶段：初始化 Web 界面

重新双击运行 start_jenkins.bat。
等命令行日志不再滚动后，打开浏览器，访问 http://localhost:8080。
页面会提示你"解锁 Jenkins (Unlock Jenkins)"。
输入密码 ：
- 你可以从那个黑色的命令行窗口里找到密码复制。
- 或者去 D:\Jenkins\data\secrets\initialAdminPassword 文件里复制。
安装插件 ：
- 此时，你已经替换了国内清华源，你可以放心地点击左侧的 "安装推荐的插件 (Install suggested plugins)"。
- 你会看到下载速度起飞，几十个插件很快就能变绿（成功）。
创建管理员：按提示输入你的账号密码。
配置实例 URL ：保持默认的 http://localhost:8080/ 即可，点击"保存并完成"。

💡 附录：如果在第三阶段找不到 `updates/default.json` 怎么办？

这是因为你第一次启动 Jenkins 的时间太短，它还没来得及去外网拉取这个文件。

补救方法：

只修改 hudson.model.UpdateCenter.xml 为清华源。
重新启动 Jenkins (.bat)。
在浏览器打开 http://localhost:8080，如果一直卡在 Please wait while Jenkins is getting ready to work...（或者那个老头的画面），就在浏览器地址栏输入：http://localhost:8080/pluginManager/advanced。
在这个高级设置页面，拉到最底部，你会看到 Update Site 这一栏。
确保 URL 已经是清华源：https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json，然后点击右下角的 Submit (提交) 按钮。
此时，Jenkins 会强制去国内源拉取文件，updates/default.json 就会生成在你的电脑上了。
然后你再关掉 Jenkins，去修改那个 default.json 文件里的 google.com 替换为 baidu.com 即可。

按照这个教程走，你的 Windows Jenkins 环境不仅清爽（全在一个文件夹里），而且永远不会因为系统服务权限问题导致你跑 UI 自动化脚本失败！