先简单介绍一下背景。Jenkins 作为持续集成领域的老牌工具,在 Windows 下搭建其实并不复杂,但不少新手在第一步就容易被绕晕。这篇文章将用最直观的方式,带您从零开始快速掌握 Jenkins 的搭建与配置,看完即可上手。

一、准备工作
确认 JDK 已安装正确
按下 Win + R → 输入 cmd → 回车,执行以下命令:
java -version
如果能够正常显示版本号(例如 1.8.x、11.x 或 17.x),说明环境配置成功。若提示“找不到命令”,则需要先安装 JDK,并配置好 JAVA_HOME 环境变量,这是 Jenkins 运行的基础前提。
获取 jenkins.war 文件
下载好 jenkins.war 后,建议将其放在一个固定的目录中,例如 D:\Jenkins,这样后续操作更清晰,也便于管理和维护。
二、启动 Jenkins(两种方式)
方法一:命令行启动(推荐)
进入 jenkins.war 所在目录,在空白处按住 Shift 并右键,选择“在此处打开命令窗口”或“PowerShell”。然后输入以下命令:
java -jar jenkins.war
默认端口为 8080。当控制台输出 Jenkins is fully up and running 时,表示启动成功。如需更换端口(例如使用 9090),可以执行:
java -jar jenkins.war --httpPort=9090
需要注意的是,以这种方式启动后,关闭命令行窗口 Jenkins 就会停止运行,因此适合初次体验或调试时使用。
方法二:后台服务方式(可选)
如果希望 Jenkins 像 Windows 服务一样在后台持续运行,可以使用 jenkins.msi 安装包,或者借助 nssm 工具进行封装。不过对于新手而言,建议先用命令行跑通基本流程,等熟悉操作后再考虑服务化部署。
三、初始化配置
打开浏览器访问 Jenkins
在浏览器地址栏输入 https://localhost:8080(如果改变了端口,则替换为对应的数字,例如 https://localhost:9090)。
输入初始密码解锁
页面会提示“Unlock Jenkins”,并显示对应的文件路径。此时需要打开 secrets\initialAdminPassword 文件(该路径在启动日志中也能直接看到),将文件中的密码复制粘贴到输入框,然后点击“Continue”继续。
安装插件
新手可以直接选择“Install suggested plugins”(安装推荐的插件),系统会自动下载并安装。如果网络状况不佳,也可以先跳过,后续在插件管理页面手动安装所需插件。
创建管理员账号
根据页面提示填写用户名、密码、邮箱等信息,然后点击“Save and Finish”保存并完成。
实例配置
确认 Jenkins URL(通常保持默认即可),然后点击“Start using Jenkins”进入主界面,至此环境搭建完毕。
