如何下载和安装 Jenkins on Windows
编辑团队
⚡ 智能摘要
下载并安装 Jenkins on Windows 使用官方 MSI 安装程序，然后解锁控制器，应用插件，并创建第一个管理员帐户。稳定运行自动化服务器所需的所有先决条件、端口设置和服务权限如下所示。
Jenkins 可以安装在任一端 Windows 或者 Unix 平台，但本教程重点介绍…… Windows 仅安装。 Windows MSI安装程序注册 Jenkins 作为一个 Windows 服务并选择 64 位 Java 它为您提供运行时环境，是搭建可用自动化服务器的最快途径。打开安装程序之前，请确认您的计算机满足下一节中列出的要求。
Jenkins 前提条件和系统要求
Jenkins 机器在静止状态下轻量级，但一旦构建历史记录、工作区和插件不断积累，体积就会迅速增大。在初始阶段正确配置机器容量可以避免日后痛苦的迁移。
硬件要求：
| 更多相关资源 | 绝对最低值 | 推荐用于小型团队 |
|---|---|---|
| 内存 | 256 MB | 4 GB或更多 |
| 驱动器空间 | 1 GB | 50 GB或更多 |
| Java 运行 | Java 21 | Java 21或 Java 25（64位） |
软件要求：
- Jenkins 运行 Java因此，一个受支持的 Java 开发套件 （JDK）或 Java 必须存在运行时环境 (JRE)。当前 Jenkins 发布需要 Java 21或更高版本; Java 8、11 和 17 已不再受最新长期支持计划的支持。
- 需要使用现代网络浏览器才能访问该网站。 Jenkins 仪表板。
- 具有管理员权限的帐户 Windows 需要一台机器来注册 Jenkins 服务。
确认已安装 Java 在继续操作之前，请先从命令提示符中输入 JDK 版本。如果命令失败或报告的版本低于 21，请先安装受支持的 JDK。
:: Check the Java version available on the machine java -version :: Expected output resembles the following openjdk version "21.0.5" 2024-10-15 LTS OpenJDK Runtime Environment Temurin-21.0.5+11 (build 21.0.5+11-LTS) OpenJDK 64-Bit Server VM Temurin-21.0.5+11 (build 21.0.5+11-LTS, mixed mode)
发布类型
Jenkins 发布两条版本线，选择哪条版本线会影响升级频率。
| 发布线 | Cadence公司 | 稳定性 | 目标受众 |
|---|---|---|---|
| 长期支持 (LTS) | 每12周 | 仅经过广泛测试并向后移植的修复程序 | 最终用户和生产团队 |
| 包周 | 每周 | 最新功能和错误修复，更少的现场测试 | 插件开发者和早期用户 |
本教程以 LTS 版本为例，但每周发布的版本安装过程完全相同。满足所有先决条件后，即可开始下载。
如何下载 Jenkins?
按照以下步骤获取 Windows 安装程序并成功完成安装：
步骤1） 在MyCAD中点击 软件更新 https://www.jenkins.io/download/ 然后选择平台。在我们的例子中， Windows.
步骤2） 请前往本地电脑上的下载位置，解压缩下载的软件包。 Double点击解压缩文件 jenkins.msi 文件中。 Jenkins 也可以从 WAR（Web 应用程序归档）文件运行，但不建议这样做。 Windows 因为它跳过了安装程序处理的服务注册。
注意： Windows SmartScreen可能会报告它阻止了未识别应用程序的启动。选择 更多信息， 然后 无论如何，运行继续签署 Jenkins 安装程序。
步骤3） 在 Jenkins 设置屏幕，点击 下一篇.
步骤4） 选择位置 Jenkins 应该安装实例。当前 64 位安装程序的默认位置是 C：\ Program Files文件\Jenkins请注意此路径，因为初始管理员密码存储在其中。点击 下一篇.
步骤5） 安装程序随后会要求输入服务登录凭据和端口号。请提供专用的本地或域帐户，然后单击。 测试凭证然后设置端口并单击 测试口。 港口 8080 是默认值。运行中 Jenkins 使用指定的服务帐户比使用 LocalSystem 选项更安全，因为 LocalSystem 选项会授予额外的权限。 Jenkins 完全控制机器。
步骤6） 确认 Java 安装程序检测到的主目录，查看自定义安装选项，然后单击 安装 按钮。安装完成后，点击。 完成.
步骤7） 安装过程中，可能会出现一个信息面板，提示您在当前安装完成后需要重启电脑。点击该面板即可重启电脑。 OK 当信息面板出现时，按下按钮。
文件已保存到磁盘，服务也已注册。下一步将解锁 Web 界面。
如何解锁 Jenkins?
完成后 Jenkins 安装阶段，控制器将被锁定，直到您输入自动生成的密码。以下步骤说明如何解锁。 Jenkins 应用程序：
步骤1） 安装过程完成后，浏览器会打开一个标签页，要求输入初始管理员密码。 Jenkins请在浏览器中浏览至以下路径。
http://localhost:8080
如果上述地址可以加载，则表示安装成功，服务正在运行。
步骤2） 初始管理员密码存储在…… Jenkins 安装路径是您在安装步骤 4 中设置的路径。默认位置 C：\ Program Files文件\Jenkins一个名为 初始管理员密码 位于 C：\ Program Files文件\Jenkins秘密如果选择了自定义路径，则检查该位置。相同的值也会写入到 jenkins.err.log 文件中 Jenkins 主目录。
步骤3） 打开选中的文件并复制其内容。 初始管理员密码 文件中。
步骤4） 将密码粘贴到 管理员密码 解锁字段 Jenkins 在浏览器中打开页面，然后点击 继续 按钮。
控制器解锁后，设置向导将继续进行插件和第一个用户帐户的设置。
定制 Jenkins
您还可以自定义您的 Jenkins 按照以下步骤配置环境：
步骤1） 点击 安装推荐的插件 按钮，以便 Jenkins 检索并安装必要的插件。
Jenkins 开始下载并安装创建新应用所需的所有插件 Jenkins 工作。
注意： 您可以选择该选项 选择要安装的插件 只需选择您需要的插件即可。插件可以稍后添加或删除。 物业管理 Jenkins 插件所以这个选择并非永久性的。
步骤2） 所有建议的插件安装完毕后， 创建第一个管理员用户 面板随即出现。请填写所有字段，输入所需的帐户详细信息，然后单击。 保存并完成 按钮。
步骤3） Jenkins 最后问 URL 实例将连接到哪里？保留默认值以避免后续混淆。如果其他应用程序已占用端口 8080，请在此处提供其他端口，然后单击“确定”。 保存并继续 按钮。
恭喜！一个新的 Jenkins 服务器已安装完毕。点击 开始使用 Jenkins 按钮。
此 Jenkins 实例已启动并运行，可以开始您的第一个任务了。 Jenkins 初学者教程 解释如何创造这份工作。
如何验证 Jenkins 安装和管理服务
仪表盘只加载一次并不能证明安装成功。因为 MSI 安装程序会注册 Jenkins 作为一个 Windows 服务必须在重启后仍能正常运行，并能按需正常重启。请在设置向导关闭后立即完成以下检查。
- 确认该服务是否存在。 媒体中心 WIN + R，类型
services.msc然后按 Enter 键。找到名为“ Jenkins 并确认状态显示为： 运行 启动类型显示 自动表. - 检查正在使用的账户。 打开属性 Jenkins 服务和审查 登录“ 标签页。对于本地实验以外的任何操作，最好使用专用服务帐户，而不是 LocalSystem 帐户。
- 请检查监听端口。 运行
netstat -ano | findstr :8080从命令提示符中。监听条目确认了这一点。 Jenkins 占据端口。 - 请阅读版本说明。 在登录
http://localhost:8080并查看仪表盘右下角的版本号。将其与您下载的版本进行比较。 - 重启一次。 重新启动 Windows 然后再次浏览到控制面板，无需手动启动任何操作。如果页面加载成功，则说明该服务确实实现了自动化。
该服务还可以通过提升权限的命令提示符进行控制，这比图形控制台速度更快，并且在部署脚本中也能很好地运行：
:: Stop, start, and query the Jenkins Windows service net stop "Jenkins" net start "Jenkins" sc query "Jenkins" :: Install Jenkins silently on a fleet of machines msiexec.exe /i "C:\installers\jenkins.msi" /qn /norestart ^ INSTALLDIR="D:\Jenkins" ^ PORT=8080 ^ /L*v "C:\logs\jenkins-install.txt"
💡提示： 静默安装程序接受 INSTALLDIR, PORT, JAVA_HOME, SERVICE_USERNAME和 SERVICE_PASSWORD 作为属性覆盖。任何未传递的值都将回退到其默认值，并且在静默模式下，除非提供服务帐户，否则服务将以 LocalSystem 身份运行。
如果这些检查中的任何一项失败，其原因通常是可以预测的，如下一节所示。
相当常见 Jenkins 安装错误 Windows 以及如何修复它们
大多数都失败了 Windows 的应用 trac回到少数几个原因：一个没有证据支持的原因。 Java 运行时错误、端口被占用或服务帐户没有作为服务登录的权限。每种错误都会导致不同的症状，因此只要仔细阅读错误信息，通常就能很快找到解决方法。
- 无效的服务登录凭据： 安装程序在安装过程中拒绝了该帐户。 测试凭证 步骤。打开
secpol.msc，扩大 本地策略 > 用户权限分配，开放 作为服务登录然后添加账户。之后重试凭证测试。 - 端口 8080 已被占用： 此 测试口 按钮变为红色，是因为另一个应用程序（通常是本地 Tomcat 或开发服务器）已经占用了该端口。请选择一个空闲端口，例如 8081，或者停止被识别出的冲突进程。
netstat -ano. - 不支持或缺失 Java: 安装程序无法预先填写 Java 如果服务启动后立即停止，请安装 64 位 JDK 21 或更高版本，然后将安装程序指向其主目录。
- SmartScreen 阻止了安装程序： Windows 报告存在无法识别的应用程序。选择 更多信息， 然后 无论如何，运行在确认该文件来自官方渠道后 Jenkins 下载页面。
- 未找到 initialAdminPassword 文件： 选择了一个自定义安装目录。请查看目录内容。
secrets从该目录的文件夹中读取密码 jenkins.err.log ，在 Jenkins 主目录。
一旦 Jenkins 如果运行稳定可靠，下一步自然是将其连接到源代码库和构建管道。以下是相关步骤。 Jenkins GitHub整合 和 CI/CD 管道 解释如何围绕此安装构建持续集成。
