Jenkins 安装与简单配置全流程指南

Jenkins 是一款开源的自动化服务器，广泛用于持续集成（CI）和持续交付（CD），支持构建、测试、部署软件项目。无论是 Java、Python 还是前端项目，Jenkins 都能通过插件灵活适配。本文将详细介绍 Jenkins 的 安装步骤 和 基础配置流程，帮助您快速搭建一个可用的自动化环境。

一、安装前的准备工作

1. 系统要求

Jenkins 支持多种操作系统，常见环境包括：

Linux（推荐 Ubuntu/CentOS，资源占用低，适合服务器部署）
Windows（适合本地开发或小型团队）
macOS（适合开发测试环境）

最低配置建议：

内存：≥512MB（推荐 2GB 以上，复杂项目需 4GB+）
磁盘空间：≥1GB（用于存储构建日志、依赖包等）
Java 环境：Jenkins 依赖 Java 运行，需提前安装 Java 11 或 Java 17（官方推荐 LTS 版本）

📌 注意：Jenkins 2.357 及以上版本仅支持 Java 17，旧版本（如 2.346 及之前）支持 Java 8/11。请根据下载的 Jenkins 版本确认 Java 要求。

2. 安装 Java 环境（若未安装）

Linux（Ubuntu/CentOS 示例）

# Ubuntu/Debian
sudo apt update
sudo apt install openjdk-17-jdk -y  # 安装 Java 17

# CentOS/RHEL
sudo yum install java-17-openjdk-devel -y

Windows/macOS

从 Oracle JDK 或 OpenJDK 下载对应版本的 JDK，按向导安装。
安装后验证是否成功： java -version # 输出应包含 "17.x.x" 或 "11.x.x"

二、Jenkins 安装步骤（分系统说明）

1. Linux 系统安装（以 Ubuntu 为例）

方法一：通过官方仓库安装（推荐）

# 1. 添加 Jenkins 官方仓库密钥和源
wget -q -O - https://pkg.jenkins.io/debian/jenkins.io.key | sudo apt-key add -
sudo sh -c 'echo deb http://pkg.jenkins.io/debian-stable binary/ > /etc/apt/sources.list.d/jenkins.list'

# 2. 更新软件包列表并安装 Jenkins
sudo apt update
sudo apt install jenkins -y

# 3. 启动 Jenkins 并设置开机自启
sudo systemctl start jenkins
sudo systemctl enable jenkins

方法二：手动下载 WAR 包（适合自定义部署）

# 1. 从官网下载最新版 Jenkins WAR 包（如 jenkins.war）
wget https://get.jenkins.io/war-stable/latest/jenkins.war

# 2. 通过 Java 命令启动（默认端口 8080）
java -jar jenkins.war --httpPort=8080

📌 此方式需手动管理进程，适合测试环境；生产环境建议用系统服务（如 systemd）托管。

2. Windows 系统安装

下载安装包：
访问 Jenkins 官网，选择 Windows 版本（如 jenkins.msi）。
运行安装向导：
双击下载的 .msi 文件，按提示完成安装（默认安装路径为 C:\Program Files\Jenkins，HTTP 端口为 8080）。
启动服务：
安装完成后，Jenkins 会自动注册为 Windows 服务并启动。若需手动操作，可通过「服务管理器」（services.msc）找到 Jenkins 服务，设置启动类型为「自动」并启动。

3. macOS 系统安装

方法一：通过 Homebrew 安装（推荐）

# 1. 安装 Homebrew（若未安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 2. 通过 Homebrew 安装 Jenkins
brew install jenkins-lts  # 推荐安装长期支持版（LTS）

# 3. 启动 Jenkins 服务
brew services start jenkins-lts

方法二：手动运行 WAR 包

# 1. 下载 jenkins.war 并运行
wget https://get.jenkins.io/war-stable/latest/jenkins.war
java -jar jenkins.war --httpPort=8080

三、Jenkins 初始配置

安装完成后，需通过浏览器访问 Jenkins 的 Web 管理界面完成初始化设置。

1. 访问 Jenkins 管理页面

Linux/macOS：浏览器打开 http://<服务器IP>:8080（本地测试用 http://localhost:8080）。
Windows：浏览器打开 http://localhost:8080。

若无法访问，请检查：

服务器防火墙是否放行了 8080 端口（Linux 执行 sudo ufw allow 8080）；
Jenkins 服务是否正常运行（通过 systemctl status jenkins 或 brew services list 查看状态）。

2. 解锁 Jenkins

首次访问时，页面会提示 「解锁 Jenkins」，需要输入管理员密码。按以下步骤获取：

查找密码文件：
- Linux：密码位于 /var/lib/jenkins/secrets/initialAdminPassword，执行以下命令查看： sudo cat /var/lib/jenkins/secrets/initialAdminPassword
- Windows：密码位于 C:\Program Files\Jenkins\secrets\initialAdminPassword，用记事本打开该文件。
- macOS：密码位于 /Users/<用户名>/.jenkins/secrets/initialAdminPassword（通过 Homebrew 安装时路径可能为 /usr/local/opt/jenkins-lts/libexec/secrets/initialAdminPassword）。
输入密码：将复制的 32 位字符密码粘贴到浏览器页面的输入框中，点击 「继续」。

3. 安装推荐插件（或自定义插件）

解锁后，Jenkins 会提示安装插件：

推荐选项：点击 「安装推荐的插件」（自动安装常用插件，如 Git、Maven、Pipeline 等，适合新手快速上手）。
自定义选项：若需特定插件（如 Docker、Kubernetes），选择 「选择插件来安装」，在列表中勾选所需插件后点击 「安装」。

📌 插件安装可能需要几分钟，耐心等待即可。若网络不稳定，可配置国内镜像源（如阿里云 Maven 仓库）加速下载。

4. 创建管理员用户

插件安装完成后，需设置 Jenkins 的管理员账号：

在页面中输入 用户名、密码、邮箱（例如：用户名 admin，密码 YourStrongPassword123）。
点击 「保存并完成」，至此 Jenkins 初始化完成！

四、基础配置验证

1. 访问 Jenkins 主页

登录后进入 Jenkins 控制台（http://<IP>:8080），首页会显示 「欢迎使用 Jenkins！」 及已安装的插件列表。

2. 验证核心功能

系统信息：点击左侧菜单 「系统管理」→「系统信息」，确认 Java 版本、Jenkins 版本等信息正常。
插件管理：通过 「系统管理」→「插件管理」 可查看已安装插件，或搜索安装新插件（如 Docker Pipeline、GitHub Integration）。
构建任务测试：点击 「新建任务」，创建一个简单的 「自由风格的软件项目」，配置一个打印「Hello Jenkins」的 Shell 脚本（或 Windows 批处理命令），运行后确认构建成功。

五、常见问题解决

1. 无法访问 Jenkins 页面

原因：端口被占用或防火墙未放行。
解决：
- 检查 Jenkins 服务是否运行（systemctl status jenkins 或 brew services list）。
- 确认端口（默认 8080）未被其他程序占用（Linux 执行 netstat -tulnp | grep 8080）。
- 放行防火墙端口（Linux：sudo ufw allow 8080；Windows：在「高级安全 Windows 防火墙」中添加入站规则）。

2. 插件安装失败

原因：网络连接不稳定或镜像源问题。
解决：
- 更换 Jenkins 插件镜像源（进入 「系统管理」→「插件管理」→「高级」，修改「更新站点」URL 为国内镜像，如 https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json）。
- 手动下载插件（从 Jenkins 插件官网下载 .hpi 文件，通过 「高级」→「上传插件」 安装）。