Jenkins入门教程（二）：在Linux系统上安装Jenkins

本文将详细介绍如何在Linux系统（以Ubuntu/CentOS为例）上安装Jenkins，包括使用包管理器安装和Docker安装两种方式，并提供完整的执行过程和输出示例。

环境要求

在安装Jenkins之前，请确保你的系统满足以下要求：

• Java 11或Java 17（推荐Java 17）
• 至少256MB内存（推荐1GB以上）
• 至少1GB磁盘空间（推荐50GB以上用于构建）

方式一：Ubuntu系统安装（推荐）

步骤1：安装Java

# 更新软件包列表
sudo apt update

# 安装OpenJDK 17
sudo apt install openjdk-17-jdk -y

# 验证安装
java -version

执行结果：

$ java -version
openjdk version "17.0.9" 2023-10-17
OpenJDK Runtime Environment (build 17.0.9+9-Ubuntu-122.04)
OpenJDK 64-Bit Server VM (build 17.0.9+9-Ubuntu-122.04, mixed mode, sharing)

步骤2：添加Jenkins官方源

# 下载Jenkins GPG密钥
curl -fsSL https://pkg.jenkins.io/debian-stable/jenkins.io-2023.key | sudo tee /usr/share/keyrings/jenkins-keyring.asc > /dev/null

# 添加Jenkins软件源
echo deb [signed-by=/usr/share/keyrings/jenkins-keyring.asc] https://pkg.jenkins.io/debian-stable binary/ | sudo tee /etc/apt/sources.list.d/jenkins.list > /dev/null

# 更新软件包列表
sudo apt update

步骤3：安装Jenkins

# 安装Jenkins
sudo apt install jenkins -y

# 启动Jenkins服务
sudo systemctl start jenkins

# 设置开机自启
sudo systemctl enable jenkins

# 查看服务状态
sudo systemctl status jenkins

执行结果：

$ sudo systemctl status jenkins
● jenkins.service - Jenkins Continuous Integration Server
     Loaded: loaded (/lib/systemd/system/jenkins.service; enabled; vendor preset: enabled)
     Active: active (running) since Sat 2026-02-08 11:30:00 UTC; 1min ago
   Main PID: 12345 (java)
      Tasks: 42 (limit: 4648)
     Memory: 1.2G
        CPU: 45.123s
     CGroup: /system.slice/jenkins.service
             └─12345 /usr/bin/java -Djava.awt.headless=true -jar /usr/share/java/jenkins.war

Feb 08 11:30:00 ubuntu-server systemd[1]: Starting Jenkins Continuous Integration Server...
Feb 08 11:30:15 ubuntu-server jenkins[12345]: Jenkins is fully up and running

方式二：CentOS/RHEL系统安装

# 安装Java
sudo yum install java-17-openjdk-devel -y

# 验证Java安装
java -version

# 添加Jenkins仓库
sudo wget -O /etc/yum.repos.d/jenkins.repo https://pkg.jenkins.io/redhat-stable/jenkins.repo

# 导入GPG密钥
sudo rpm --import https://pkg.jenkins.io/redhat-stable/jenkins.io-2023.key

# 安装Jenkins
sudo yum install jenkins -y

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

# 查看状态
sudo systemctl status jenkins

方式三：使用Docker安装（推荐快速部署）

Docker方式安装最为简单，适合快速部署和测试：

# 创建数据目录
mkdir -p /data/jenkins_home
chmod 777 /data/jenkins_home

# 拉取Jenkins LTS镜像
docker pull jenkins/jenkins:lts

# 运行Jenkins容器
docker run -d \
  --name jenkins \
  --restart=unless-stopped \
  -p 8080:8080 \
  -p 50000:50000 \
  -v /data/jenkins_home:/var/jenkins_home \
  -v /var/run/docker.sock:/var/run/docker.sock \
  jenkins/jenkins:lts

执行结果：

$ docker pull jenkins/jenkins:lts
lts: Pulling from jenkins/jenkins
8a1e25ce7c4f: Pull complete
...
Digest: sha256:abc123...
Status: Downloaded newer image for jenkins/jenkins:lts

$ docker run -d --name jenkins ...
3a4b5c6d7e8f9g0h1i2j3k4l5m6n7o8p9q0r1s2t3u4v5w6x7y8z9

$ docker ps
CONTAINER ID   IMAGE                 STATUS         PORTS                                              NAMES
3a4b5c6d7e8f   jenkins/jenkins:lts   Up 2 minutes   0.0.0.0:8080->8080/tcp, 0.0.0.0:50000->50000/tcp   jenkins

初始化配置

步骤1：获取初始管理员密码

# 包管理器安装方式
sudo cat /var/lib/jenkins/secrets/initialAdminPassword

# Docker安装方式
docker exec jenkins cat /var/jenkins_home/secrets/initialAdminPassword

执行结果：

$ sudo cat /var/lib/jenkins/secrets/initialAdminPassword
8a7b6c5d4e3f2g1h0i9j8k7l6m5n4o3p

步骤2：访问Jenkins Web界面

打开浏览器访问 http://你的服务器IP:8080，输入上一步获取的初始密码。

步骤3：安装推荐插件

选择"安装推荐的插件"，Jenkins会自动安装常用插件，包括Git、Pipeline、Credentials等。

步骤4：创建管理员账号

填写管理员用户名、密码、邮箱等信息，完成初始化配置。

防火墙配置

如果无法访问Jenkins，需要开放8080端口：

# Ubuntu (ufw)
sudo ufw allow 8080/tcp
sudo ufw status

# CentOS (firewalld)
sudo firewall-cmd --permanent --add-port=8080/tcp
sudo firewall-cmd --reload
sudo firewall-cmd --list-ports

执行结果：

$ sudo ufw allow 8080/tcp
Rule added
Rule added (v6)

$ sudo ufw status
Status: active

To                         Action      From
--                         ------      ----
22/tcp                     ALLOW       Anywhere
8080/tcp                   ALLOW       Anywhere

验证安装

使用curl命令验证Jenkins是否正常运行：

$ curl -I http://localhost:8080
HTTP/1.1 403 Forbidden
Date: Sat, 08 Feb 2026 11:35:00 GMT
X-Content-Type-Options: nosniff
Set-Cookie: JSESSIONID.abc123=xyz789; Path=/; HttpOnly
Expires: Thu, 01 Jan 1970 00:00:00 GMT
Content-Type: text/html;charset=utf-8
Server: Jetty(10.0.x)

403状态码表示Jenkins正在运行，需要登录才能访问。

常见问题排查

如果Jenkins启动失败，检查以下内容：

# 查看Jenkins日志
sudo journalctl -u jenkins -f

# 检查端口占用
sudo netstat -tlnp | grep 8080

# 检查Java版本
java -version

# 检查Jenkins目录权限
ls -la /var/lib/jenkins/

总结

本文介绍了在Linux系统上安装Jenkins的三种方式：Ubuntu/Debian包管理器、CentOS/RHEL包管理器和Docker。包管理器方式适合生产环境，便于管理和升级；Docker方式适合开发测试环境，部署简单。

下一篇我们将介绍Jenkins的基础配置和系统管理。