安装与初始配置:Jenkins 在 Linux/Windows/Mac 上的安装方式、首次启动、解锁、插件安装引导、创建管理员账户

Jenkins 的安装其实不复杂,但不同操作系统下的坑点不太一样。我最早在项目里搭 Jenkins 时,因为没注意 Java 版本兼容性,折腾了半小时才起来。今天咱们就一次性把 Linux、Windows、Mac 上的安装流程捋清楚,配合首次启动、解锁、插件选择、管理员创建,让你能快速跑通第一个实例。

前置条件:确保已安装 Java 8 或 11(推荐 11)。可以在终端用 java -version 检查。

Linux 安装(以 Ubuntu 为例)

我个人习惯用官方仓库安装,省去手动下载的麻烦。步骤如下:

  1. 添加 Jenkins 的 GPG 密钥和软件源
  2. 更新包列表并安装 jenkins
  3. 启动服务并设置开机自启
wget -q -O - https://pkg.jenkins.io/debian-stable/jenkins.io.key | sudo apt-key add -
sudo sh -c 'echo deb https://pkg.jenkins.io/debian-stable binary/ > /etc/apt/sources.list.d/jenkins.list'
sudo apt-get update
sudo apt-get install jenkins
sudo systemctl start jenkins
sudo systemctl enable jenkins

安装完默认监听 8080 端口。你可以用 sudo systemctl status jenkins 确认是否运行。我曾经在 CentOS 上用 yum 装,命令类似,只不过包名一样,但需要先装 EPEL 仓库。嗯,注意一下发行版差异就好。

Windows 安装

Windows 下有安装包(MSI)和 WAR 包两种方式。我推荐直接下载 MSI 安装器,图形化向导省心。

  • 去官网下载最新稳定版 MSI(或者用 chocolatey:choco install jenkins)
  • 双击运行,一路 Next,注意选择安装路径和端口(默认 8080)
  • 安装完成自动启动服务,也会注册为 Windows 服务

如果端口被占用,可以在安装过程中手动改成 8081 或其他端口。安装后也可以修改 Jenkins.xml 中的 --httpPort 参数。

Mac 安装

Mac 上最简单的方式是 Homebrew:

brew install jenkins-lts
brew services start jenkins-lts

这会自动安装 Java 依赖并启动服务。你可以在 /usr/local/opt/jenkins-lts/homebrew.mxcl.jenkins-lts.plist 看到配置。如果你不想用 brew,也可以直接下载 WAR 包用 java 启动:

java -jar jenkins.war --httpPort=8080

WAR 包方式适合临时测试,不过生产环境我还是建议用服务模式。

首次启动与解锁

无论哪种系统,启动后打开浏览器访问 http://localhost:8080,你会看到解锁页面。Jenkins 会生成一个初始密码,位置因系统而异:

操作系统 初始密码路径
Linux(apt/ yum)/var/lib/jenkins/secrets/initialAdminPassword
Windows(MSI)C:\ProgramData\Jenkins\.jenkins\secrets\initialAdminPassword
Mac(brew)/usr/local/var/jenkins/secrets/initialAdminPassword
WAR 包启动工作目录下的 secrets/initialAdminPassword

千万不要直接在浏览器里用管理员权限打开文件,复制密码粘贴即可。我曾经见过有人用 root 用户编辑密码文件导致权限错乱,后续 Jenkins 无法正常读写配置。嗯,记住只复制,不改写。

插件安装引导

解锁后进入插件安装界面,有两个选择:

  • 安装推荐的插件 – 适合新手,包含了 Git、Pipeline、Blue Ocean 等常用插件。我建议自己选择,因为默认插件包有时候包含你根本用不到的东西,反而拖慢启动。
  • 自定义安装 – 你可以按需勾选。我个人习惯只选:Pipeline、Git、GitHub Integration、Credentials Binding、Blue Ocean、Email Extension。如果做 CI 集成测试,JUnit / TestNG 插件也要加上。

插件安装过程会联网下载,时间取决于网络。如果你在公司内网,可能需要提前配置代理。我遇到过几次下载到一半超时,这时候耐心等重试,或者手动上传插件 .hpi 文件。

创建管理员账户

插件安装完成后,会要求创建第一个管理员用户。这里填写用户名、密码、邮箱等。注意:

  • 这个账号是 Jenkins 的超级管理员,务必牢记密码。
  • 邮箱最好填真实邮箱,后期邮件通知会用。
  • 之后的实例 URL 建议用 IP 或域名,不要留 localhost,否则从外部访问会出现回调地址错误。

创建完成,点击“保存并完成”,Jenkins 就准备就绪了。你会看到一个空白的 Dashboard。接下来就可以新建 Pipeline 了。

小技巧:如果你在安装过程中误点了“继续作为 admin 使用”,后面想改密码,可以去 Manage Jenkins → Manage Users → 选择 admin → Configure 里修改。

Jenkins 安装与初始配置流程 选择操作系统 Linux Windows Mac 安装方式 包管理器/WAR/jar 首次启动 java -jar jenkins.war 解锁 复制初始密码 插件安装引导 推荐 / 自定义选择 创建管理员账户 设置用户名/密码/邮箱 注意事项 • 不同系统密码路径不同,请按表格查找 • 插件安装建议自定义,避免冗余 • 管理员邮箱建议填写真实地址,用于邮件通知

好了,到现在 Jenkins 已经顺利跑起来了。你可以打开 http://localhost:8080 用刚创建的管理员账号登录,看到无人值守的空白面板。下一步就可以开始配置 Pipeline 了,但那是后面章节的事,我们先把基础打牢。