怎样在 Ubuntu 跑 Jenkins

ubuntu

小樊

2026-10-21 19:42:21

栏目: 智能运维

在 Ubuntu 上运行 Jenkins 通常有几种方式：直接用 apt 安装（最常用）、用 Docker 跑、用 WAR 包跑。下面给你最实用、最常见的做法。

一、用 apt 在 Ubuntu 上安装 Jenkins（推荐）

1. 安装 Java（Jenkins 需要 JDK）

Jenkins 2.4xx 一般要求 Java 17 或 21

sudo apt update
sudo apt install -y openjdk-17-jdk

验证：

java -version

2. 添加 Jenkins 官方源

sudo apt install -y curl gnupg
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://pkg.jenkins.io/debian-stable/jenkins.io-2023.key | sudo tee \
  /etc/apt/keyrings/jenkins-keyring.asc > /dev/null

echo deb [signed-by=/etc/apt/keyrings/jenkins-keyring.asc] \
  https://pkg.jenkins.io/debian-stable binary/ | sudo tee \
  /etc/apt/sources.list.d/jenkins.list > /dev/null

3. 安装 Jenkins

sudo apt update
sudo apt install -y jenkins

4. 启动并设置开机自启

sudo systemctl enable jenkins
sudo systemctl start jenkins
sudo systemctl status jenkins

看到 active (running) 就成功了。

5. 开放防火墙（如有）

sudo ufw allow 8080

6. 访问 Jenkins

浏览器打开：

http://<你的IP>:8080

查看初始管理员密码：

sudo cat /var/lib/jenkins/secrets/initialAdminPassword

按提示完成初始化即可。

二、用 Docker 跑 Jenkins（更干净）

1. 安装 Docker

sudo apt install -y docker.io
sudo systemctl enable --now docker

2. 启动 Jenkins 容器

docker run -d \
  --name jenkins \
  -p 8080:8080 \
  -p 50000:50000 \
  -v jenkins_home:/var/jenkins_home \
  jenkins/jenkins:lts

3. 查看密码

docker logs jenkins

或：

docker exec jenkins cat /var/jenkins_home/secrets/initialAdminPassword

三、常见问题

Jenkins 启动失败？

Java 版本不对（必须 17+）
端口被占用（改 /etc/default/jenkins 或 Docker -p）

想改端口？

apt 安装：

sudo nano /etc/default/jenkins
# 修改 JENKINS_PORT=8080
sudo systemctl restart jenkins

如果你告诉我：

Ubuntu 版本（20.04 / 22.04 / 24.04）
是否用服务器 / 云主机
是否要 Docker / Kubernetes

我可以给你更精确的一步到位方案。