jenkins在ubuntu怎设置

ubuntu

小樊

2026-09-28 10:51:56

栏目: 智能运维

下面给你一份在 Ubuntu 上安装并配置 Jenkins 的常用做法（以 Ubuntu 20.04 / 22.04 为例，其他版本类似）。

一、环境准备

1. 更新系统

sudo apt update
sudo apt upgrade -y

2. 安装 Java（Jenkins 依赖）

Jenkins 需要 Java 11 或 Java 17

sudo apt install openjdk-17-jdk -y

检查：

java -version

二、安装 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

# 安装
sudo apt update
sudo apt install jenkins -y

三、启动 Jenkins

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

看到 active (running) 说明成功。

四、防火墙（如有）

sudo ufw allow 8080

五、首次访问与初始化

浏览器访问：

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

获取管理员密码

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

粘贴到页面中 → 安装推荐插件 → 创建管理员用户

六、常用配置

1. 修改端口（可选）

编辑：

sudo nano /etc/default/jenkins

修改：

HTTP_PORT=8080

重启：

sudo systemctl restart jenkins

2. 使用 Nginx 反向代理（推荐生产环境）

sudo apt install nginx -y

示例配置：

server {
    listen 80;
    server_name jenkins.example.com;

    location / {
        proxy_pass http://localhost:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

3. 设置开机自启

已默认开启，如未开启：

sudo systemctl enable jenkins

七、常见问题

Jenkins 无法启动

journalctl -u jenkins -f

常见原因：

Java 没装或版本不对
端口被占用

如果你是想：

用 Docker 安装 Jenkins
配置 GitHub / GitLab 自动构建
设置 Linux 节点（Agent）

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