在 Linux 系统中安装与配置 Jenkins
Jenkins 是一款开源的持续集成与持续交付(CI/CD)工具,广泛应用于自动化构建、测试和部署软件项目,在 Linux 系统中安装 Jenkins 是开发团队实现 DevOps 流程的重要一步,本文将详细介绍在主流 Linux 发行版(如 Ubuntu、CentOS)中安装 Jenkins 的完整流程,包括环境准备、安装步骤、服务配置及常见问题解决,帮助读者快速搭建稳定的 CI/CD 环境。

环境准备
在安装 Jenkins 之前,需确保系统满足基本要求,以避免兼容性或性能问题。
-
系统版本选择
Jenkins 支持 64 位的 Linux 发行版,推荐使用以下稳定版本:- Ubuntu 18.04/20.04/22.04 LTS
- CentOS 7/8/RHEL 7/8
- Debian 9/10/11
-
系统依赖安装
Jenkins 基于 Java 运行,需提前安装 Java Development Kit(JDK)或 Java Runtime Environment(JRE),以 Ubuntu 为例,执行以下命令安装 OpenJDK 11:sudo apt update sudo apt install openjdk-11-jdk -y
对于 CentOS 系统,使用 yum 或 dnf 安装:
sudo yum install java-11-openjdk-devel -y # CentOS 7/8
安装完成后,验证 Java 版本:
java -version
若显示 Java 11 或更高版本,则依赖安装成功。
-
系统更新与用户配置
建议更新系统软件包至最新版本,并创建专用用户运行 Jenkins,避免使用 root 用户:sudo apt update && sudo apt upgrade -y # Ubuntu sudo useradd -m -s /bin/bash jenkins # 创建 Jenkins 用户 sudo passwd jenkins # 设置用户密码
安装 Jenkins
根据 Linux 发行版的不同,Jenkins 的安装方式分为包管理器安装、手动安装及 Docker 容器安装三种,推荐优先使用包管理器安装,以简化依赖管理。
通过包管理器安装(推荐)
-
Ubuntu/Debian 系统
Jenkins 官方提供了 APT 仓库,需先添加仓库密钥:
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'
更新包列表后安装 Jenkins:
sudo apt update sudo apt install jenkins -y
-
CentOS/RHEL 系统
使用 yum 或 dfn 添加 Jenkins 官方仓库:sudo wget -O /etc/yum.repos.d/jenkins.repo https://pkg.jenkins.io/redhat-stable/jenkins.repo sudo rpm --import https://pkg.jenkins.io/redhat-stable/jenkins.io.key
安装 Jenkins(需确保已安装 EPEL 仓库):
sudo yum install jenkins -y # CentOS 7 sudo dnf install jenkins -y # CentOS 8/RHEL 8
手动安装(WAR 包方式)
若无法使用包管理器,可下载 Jenkins WAR 包手动部署:
- 访问 Jenkins 官方下载页面(https://www.jenkins.io/download/),获取最新 WAR 包链接。
- 使用 wget 下载并移动至 Tomcat 或其他 Java Web 容器目录:
wget http://mirrors.jenkins.io/war-stable/latest/jenkins.war sudo mkdir -p /opt/jenkins sudo mv jenkins.war /opt/jenkins/
- 运行 Jenkins:
java -jar /opt/jenkins/jenkins.war --httpPort=8080
Docker 容器安装
若已部署 Docker 环境,可通过容器快速启动 Jenkins:
docker run -d --name jenkins -p 8080:8080 -p 50000:50000 -v jenkins_home:/var/jenkins_home jenkins/jenkins:lts
配置 Jenkins 服务
安装完成后,需启动 Jenkins 服务并配置开机自启。
-
启动与状态检查
sudo systemctl start jenkins # 启动服务 sudo systemctl status jenkins # 查看服务状态
若显示“active (running)”,则启动成功。
-
设置开机自启

sudo systemctl enable jenkins
-
访问 Jenkins 界面
打开浏览器,访问http://服务器IP:8080,首次进入需解锁 Jenkins。- 获取初始密码:
sudo cat /var/lib/jenkins/secrets/initialAdminPassword
- 复制密码至浏览器页面,按提示安装推荐的插件或自定义选择插件。
- 创建管理员账户,完成初始化配置。
- 获取初始密码:
配置防火墙与端口
若服务器启用了防火墙(如 UFW、firewalld),需开放 Jenkins 默认端口 8080:
-
Ubuntu(UFW)
sudo ufw allow 8080/tcp sudo ufw reload
-
CentOS(firewalld)
sudo firewall-cmd --permanent --add-port=8080/tcp sudo firewall-cmd --reload
常见问题解决
-
启动失败:端口被占用
若 Jenkins 启动时提示端口 8080 被占用,可修改默认端口:sudo nano /etc/default/jenkins # Ubuntu # 修改 HTTP_PORT=8080 为其他端口,如 8081 sudo systemctl restart jenkins
-
插件安装失败
检查网络连接是否正常,或配置国内镜像源(如清华大学镜像),在 Jenkins 管理界面进入“系统管理”→“插件管理”→“高级”,更新升级站点 URL。 -
权限问题
若 Jenkins 无法操作文件或目录,需确保运行用户(如 jenkins)具有相应权限:sudo chown -R jenkins:jenkins /var/lib/jenkins # 修改目录所有者
通过上述步骤,读者已可在 Linux 系统中成功安装并运行 Jenkins,作为 CI/CD 的核心工具,Jenkins 可与 Git、Docker、Kubernetes 等工具结合,实现代码自动构建、测试与部署,后续建议根据项目需求配置 Jenkinsfile、流水线任务(Pipeline)及通知机制,充分发挥其在 DevOps 流程中的自动化优势,定期更新 Jenkins 版本及插件,及时修复安全漏洞,也是保障系统稳定运行的重要措施。


















