Windows系统上安装Jenkins的完整流程及关键注意事项

 更新时间:2026年04月08日 09:06:25   作者:莫比乌斯之梦  
Jenkins是一个开源的持续集成工具,用于自动化 构建、测试和部署软件项目,它提供了一个易于使用和可扩展的平台,帮助团队更高效地开发和交付软件,这篇文章主要介绍了Windows系统上安装Jenkins的完整流程及关键注意事项,需要的朋友可以参考下

前言

在构建持续集成与持续交付(CI/CD)环境的过程中,Jenkins 是最常用、最成熟的自动化工具之一。对于使用 Windows 操作系统的开发者而言,正确安装并配置 Jenkins 是迈向 DevOps 实践的第一步。本文将详细介绍在 Windows 系统上安装 Jenkins 的完整流程及关键注意事项,帮助读者快速完成环境搭建。

一、安装 Jenkins 前的环境准备

在 Windows 上安装 Jenkins 之前,需要确保系统环境满足基本要求:

  1. 操作系统要求

    • Windows 10 / Windows 11
    • Windows Server 2016 及以上版本
  2. Java 运行环境(必需)
    Jenkins 基于 Java 运行,需提前安装 JDK:

    • 推荐使用 JDK 8 或 JDK 11(LTS)
    • 正确配置 JAVA_HOME 环境变量
    • 在命令行中执行 java -version 验证是否安装成功
  3. 网络与权限

    • 确保可访问互联网以下载插件
    • 使用具有管理员权限的用户进行安装

二、下载 Jenkins 安装包

Jenkins 官方为 Windows 用户提供了多种安装方式,其中最推荐的是 Windows Installer(MSI)

下载时通常可选择:

  • LTS(长期支持版):稳定性高,适合生产环境
  • Weekly(周更新版):功能新,适合尝鲜和测试

建议初学者优先选择 LTS 版本,以获得更稳定的使用体验。

三、在 Windows 上安装 Jenkins 的具体步骤

  1. 运行安装程序

    双击下载好的 Jenkins MSI 安装包,启动安装向导。

  2. 选择安装路径

    可使用默认路径(如 C:\Program Files\Jenkins),一般无需修改。

  3. 配置运行端口

    • Jenkins 默认端口为 8080
    • 若端口被占用,可在此步骤修改为其他端口
  4. 设置 Jenkins 服务账户

    • 可选择使用本地系统账户
    • 或指定已有 Windows 用户(推荐在企业环境中使用)
  5. 确认并完成安装

    安装完成后,Jenkins 将以 Windows 服务的方式自动启动。

四、首次启动 Jenkins 与解锁配置

安装完成后,在浏览器中访问:

http://localhost:8080

首次访问 Jenkins 时,需要进行解锁操作:

  1. 根据页面提示,找到初始管理员密码文件路径

  2. 通常位于:

    C:\Program Files\Jenkins\secrets\initialAdminPassword

  3. 使用记事本打开文件,复制密码并粘贴到页面中

完成解锁后,即可进入 Jenkins 初始化配置界面。

五、安装推荐插件与创建管理员账户

在初始化向导中,Jenkins 会提示安装插件:

  • 安装推荐插件(Recommended):适合绝大多数用户
  • 自定义插件安装:适合有明确需求的高级用户

建议选择 推荐插件安装,以快速获得常用功能支持。

随后,需要创建一个 管理员用户账号,用于后续登录和管理 Jenkins 系统。完成此步骤后,即可进入 Jenkins 主界面。

六、Windows 上运行 Jenkins 的常见注意事项

  • 端口冲突问题:可在 Jenkins 配置文件或安装时调整端口
  • 防火墙设置:确保 Jenkins 端口未被防火墙拦截
  • 服务管理:可通过 Windows「服务」管理器启动或停止 Jenkins
  • JDK 版本兼容性:避免使用过新或不受支持的 Java 版本

七、常见问题与解决方案

问题原因解决方案
Jenkins无法启动JDK版本不匹配检查Jenkins版本,安装对应JDK版本
8080端口被占用其他程序占用端口修改 jenkins.xml 中的 httpPort 参数
插件安装失败网络问题更换国内镜像源或手动下载离线安装
忘记管理员密码删除 JENKINS_HOME/config.xml 中的安全配置节,重启Jenkins
控制台输出中文乱码编码问题在构建任务中设置 LANG=zh_CN.UTF-8 环境变量
服务启动时权限不足账号缺少服务登录权限使用具备“作为服务登录”权限的账号重新配置

结语

通过以上步骤,即可在 Windows 系统上成功安装并运行 Jenkins。作为 CI/CD 体系的核心组件,Jenkins 为后续的自动化构建、测试和部署奠定了坚实基础。完成安装只是第一步,合理配置插件、流水线和安全策略,才能充分发挥 Jenkins 的价值。

到此这篇关于Windows系统上安装Jenkins的完整流程及关键注意事项的文章就介绍到这了,更多相关Windows安装Jenkins内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

您可能感兴趣的文章:

相关文章

  • SpringBoot3配置Logback日志滚动文件的方法

    SpringBoot3配置Logback日志滚动文件的方法

    本文介绍了在SpringBoot3中配置Logback日志滚动文件的方法,因为SpringBoot3内置的logback版本是1.4.14,之前使用SpringBoot2.1.5的logback配置发现有些东西不能生效了,需要的朋友可以参考下
    2024-08-08
  • MybatisPlusException:Failed to process,Error SQL异常报错的解决办法

    MybatisPlusException:Failed to process,Error SQL异常报错的解决办法

    这篇文章主要给大家介绍了关于MybatisPlusException:Failed to process,Error SQL异常报错的解决办法,文中通过实例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2023-03-03
  • Java环境配置原理全面解析

    Java环境配置原理全面解析

    下面小编就为大家带来一篇Java环境配置原理全面解析。小编觉得挺不错的,现在就分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2016-09-09
  • java中double转化为BigDecimal精度缺失的实例

    java中double转化为BigDecimal精度缺失的实例

    下面小编就为大家带来一篇java中double转化为BigDecimal精度缺失的实例。小编觉得挺不错的,现在就分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2017-03-03
  • 详解Java使用JMH进行基准性能测试

    详解Java使用JMH进行基准性能测试

    本文主要介绍了Java使用JMH进行基准性能测试,文中通过示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2021-11-11
  • Mybatis实现批量更新数据(批量update)

    Mybatis实现批量更新数据(批量update)

    本文介绍了MyBatis批量更新数据的两种方案,方案一使用foreach标签拼接多条update语句,通过在数据库连接URL中指定allowMultiQueries参数值为true来支持多条语句的执行,提高效率;方案二拼接成一条SQL,但SQL语句会非常复杂且难以阅读,不推荐使用
    2026-04-04
  • Java函数式编程(五):闭包

    Java函数式编程(五):闭包

    这篇文章主要介绍了Java函数式编程(五):闭包,本文是系列文章的第5篇,其它篇章请参阅相关文章,需要的朋友可以参考下
    2014-09-09
  • Java Scanner 类的使用小结

    Java Scanner 类的使用小结

    在笔试编程过程中,关于数据的读取如果迷迷糊糊,那后来的编程即使想法很对,实现很好,也是徒劳,于是在这里认真总结了Java Scanner 类的使用,需要的朋友可以参考下
    2018-10-10
  • java生成缩略图的方法示例

    java生成缩略图的方法示例

    这篇文章主要介绍了java生成缩略图的方法,结合具体实例形式分析了java生成缩略图过程中所涉及的各种常见的图形处理技巧,需要的朋友可以参考下
    2017-03-03
  • SpringBoot使用Aspect切面拦截打印请求参数的示例代码

    SpringBoot使用Aspect切面拦截打印请求参数的示例代码

    这篇文章主要介绍了SpringBoot使用Aspect切面拦截打印请求参数,本文通过实例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2021-07-07

最新评论