Jenkins 安装指南

本章详细介绍在不同操作系统和环境中安装 Jenkins 的方法。

系统要求

硬件要求

配置	最低要求	推荐配置
CPU	1 核	4+ 核
内存	256 MB	4+ GB
磁盘	1 GB	50+ GB
Java	Java 8 或 11	Java 11 LTS

软件要求

操作系统：Ubuntu、Debian、CentOS、Windows、macOS
Java：OpenJDK 8/11/17 或 Oracle JDK 8/11/17
浏览器：Chrome、Firefox、Edge 最新版本

Docker 安装（推荐）

使用 Docker 运行 Jenkins

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

# 运行 Jenkins 容器
docker run -d \
  --name jenkins \
  -p 8080:8080 \
  -p 50000:50000 \
  -v jenkins_home:/var/jenkins_home \
  jenkins/jenkins:lts

Docker Compose 方式

创建 docker-compose.yml 文件：

version: '3.8'
services:
  jenkins:
    image: jenkins/jenkins:lts
    container_name: jenkins
    restart: unless-stopped
    ports:
      - "8080:8080"
      - "50000:50000"
    volumes:
      - jenkins_home:/var/jenkins_home
      - /var/run/docker.sock:/var/run/docker.sock
    environment:
      - JAVA_OPTS=-Djenkins.install.runSetupWizard=false
volumes:
  jenkins_home:

启动服务：

docker-compose up -d

Linux 安装

Ubuntu / Debian

# 1. 安装 Java
sudo apt update
sudo apt install openjdk-11-jdk

# 2. 添加 Jenkins 仓库
curl -fsSL https://pkg.jenkins.io/debian/jenkins.io.key | sudo tee \
    /usr/share/keyrings/jenkins-keyring.asc > /dev/null
echo deb [signed-by=/usr/share/keyrings/jenkins-keyring.asc] \
    https://pkg.jenkins.io/debian binary/ | sudo tee \
    /etc/apt/sources.list.d/jenkins.list > /dev/null

# 3. 安装 Jenkins
sudo apt update
sudo apt install jenkins

# 4. 启动 Jenkins
sudo systemctl start jenkins
sudo systemctl enable jenkins

CentOS / RHEL / Fedora

# 1. 安装 Java
sudo yum install java-11-openjdk java-11-openjdk-devel

# 2. 添加 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

# 3. 安装 Jenkins
sudo yum install jenkins

# 4. 启动 Jenkins
sudo systemctl start jenkins
sudo systemctl enable jenkins

Windows 安装

使用 Chocolatey

# 安装 Chocolatey（如果未安装）
Set-ExecutionPolicy BypassRemoteSignedMachineScope -Scope CurrentUser -Force
iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))

# 安装 Jenkins
choco install jenkins -y

手动安装

下载 Jenkins Windows 安装包
运行安装向导
选择安装路径和服务配置
完成安装后访问 http://localhost:8080

初始化配置

解锁 Jenkins

首次访问 Jenkins 时需要解锁：

访问 http://localhost:8080
查看解锁密钥：

# Docker 环境
docker exec jenkins cat /var/jenkins_home/secrets/initialAdminPassword

# Linux 环境
sudo cat /var/lib/jenkins/secrets/initialAdminPassword

安装推荐插件

选择 安装推荐插件
等待插件安装完成
创建第一个管理员账户

配置完成页面

配置项	说明
URL	Jenkins 访问地址
用户名	管理员用户名
密码	管理员密码
全名	显示名称
邮箱	通知邮箱

升级 Jenkins

Docker 升级

# 拉取新版本
docker pull jenkins/jenkins:lts

# 停止并删除旧容器
docker stop jenkins
docker rm jenkins

# 重新启动（新版本会自动使用已有的数据卷）
docker run -d \
  --name jenkins \
  -p 8080:8080 \
  -p 50000:50000 \
  -v jenkins_home:/var/jenkins_home \
  jenkins/jenkins:lts

Linux 升级

# Ubuntu/Debian
sudo apt update
sudo apt upgrade jenkins

# CentOS/RHEL
sudo yum update jenkins

卸载 Jenkins

Docker 卸载

docker stop jenkins
docker rm jenkins
docker rmi jenkins/jenkins:lts
# 可选：删除数据卷
docker volume rm jenkins_home

Linux 卸载

# Ubuntu/Debian
sudo apt remove --purge jenkins
sudo rm -rf /var/lib/jenkins
sudo rm -rf /etc/jenkins

# CentOS/RHEL
sudo yum remove jenkins
sudo rm -rf /var/lib/jenkins
sudo rm -rf /etc/jenkins

常见问题

1. Java 版本不兼容

# 检查 Java 版本
java -version

# 切换 Java 版本（Ubuntu）
sudo update-alternatives --config java

2. 端口被占用

修改 jenkins.xml 或环境变量：

<arguments>-Xrs -Xmx256m -Dhudson.lifecycle=hudson.lifecycle.WindowsServiceLifecycle -jar "%BASE%\jenkins.war" --httpPort=8081</arguments>

3. 权限问题

# 修复 Jenkins 主目录权限
sudo chown -R jenkins:jenkins /var/jenkins_home
sudo chmod -R 755 /var/jenkins_home

下一步

安装完成后，让我们学习如何快速开始使用 Jenkins！

👉 快速入门

💡 提示：生产环境建议使用 Docker 或 Kubernetes 部署，便于管理和升级。