Jenkins如何在Ubuntu搭建

ubuntu

小樊

2026-09-25 13:06:51

栏目: 智能运维

下面给你一份在 Ubuntu 上搭建 Jenkins 的实用指南（以 Ubuntu 20.04 / 22.04 为例，其他版本类似）。

一、环境准备

1. 更新系统

sudo apt update
sudo apt upgrade -y

2. 安装 Java（Jenkins 依赖 Java）

Jenkins 需要 Java 11 或以上

sudo apt install openjdk-17-jdk -y

验证：

java -version

二、安装 Jenkins

方式一（推荐）：使用官方仓库

1. 导入 Jenkins Key

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

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

3. 安装 Jenkins

sudo apt update
sudo apt install jenkins -y

三、启动 Jenkins

sudo systemctl start jenkins
sudo systemctl enable jenkins

查看状态：

sudo systemctl status jenkins

四、配置防火墙（如有）

sudo ufw allow 8080
sudo ufw enable

五、初始化 Jenkins

1. 浏览器访问

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

2. 获取初始管理员密码

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

粘贴到页面中。

3. 安装插件

推荐：Install suggested plugins
或自定义插件

4. 创建管理员用户

六、常见问题

1. 端口修改

编辑：

sudo nano /etc/default/jenkins

修改：

JENKINS_PORT=9090

重启：

sudo systemctl restart jenkins

2. 权限问题

Jenkins 默认使用 jenkins 用户，注意目录权限。

3. Docker 集成（常用）

sudo usermod -aG docker jenkins
sudo systemctl restart jenkins

七、可选（生产建议）

使用 Nginx + HTTPS
定期备份 /var/lib/jenkins
限制 8080 端口公网访问

如果你需要：

✅ Jenkins + Docker 自动化部署
✅ Jenkins + GitLab / GitHub
✅ Jenkins Pipeline 示例

可以告诉我你的使用场景，我可以直接给你配置示例。