Jenkins 在 Ubuntu 咋部署

ubuntu

小樊

2026-10-21 19:40:22

栏目: 智能运维

下面给你一份在 Ubuntu 上部署 Jenkins 的常用、稳妥方案（以 Ubuntu 20.04 / 22.04 为例，使用 官方 apt 源 + Java 11/17）。

一、环境准备

1. 更新系统

sudo apt update
sudo apt upgrade -y

2. 安装 Java（Jenkins 依赖）

Jenkins 2.4xx 推荐 Java 17（也支持 11）

sudo apt install -y openjdk-17-jdk

验证：

java -version

二、安装 Jenkins

1. 添加 Jenkins 官方源

sudo wget -O /usr/share/keyrings/jenkins-keyring.asc \
  https://pkg.jenkins.io/debian-stable/jenkins.io-2023.key

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

2. 安装 Jenkins

sudo apt update
sudo apt install -y jenkins

三、启动 Jenkins

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

看到 active (running) 即可。

四、防火墙 & 访问

1. 开放 8080 端口

sudo ufw allow 8080
sudo ufw enable

2. 浏览器访问

http://<服务器IP>:8080

五、初始化 Jenkins

1. 获取管理员密码

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

复制粘贴到网页中。

2. 安装插件

推荐：Install suggested plugins
或自定义（Git、Pipeline、Docker 等）

3. 创建管理员账号

六、常见问题

1. Jenkins 启动失败

查看日志：

journalctl -u jenkins -n 50

常见原因：

Java 没装
端口被占用

2. 修改端口

编辑：

sudo nano /etc/default/jenkins

修改：

HTTP_PORT=8081

重启：

sudo systemctl restart jenkins

3. 用 Nginx 反代（可选）

适合生产环境：

jenkins.example.com → 127.0.0.1:8080

七、Docker 方式（可选）

如果你更想用 Docker：

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

如果你告诉我：

Ubuntu 版本
是否用 Docker
是否要 生产环境 / CI / 生产部署

我可以给你更精确的部署方案。