ubuntu jenkins怎么配置

下面按常见场景给你一份「在 Ubuntu 上安装并配置 Jenkins」的实用指南，从安装到基础配置，适合新手和生产环境参考。

一、环境准备（Ubuntu）

1. 系统更新

sudo apt update
sudo apt upgrade -y

2. 安装 Java（Jenkins 依赖）

Jenkins 需要 Java 11 或 17（推荐 17）

sudo apt install openjdk-17-jdk -y
java -version

二、安装 Jenkins

方式一：官方仓库安装（推荐）

# 导入 Jenkins key
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 > /dev/null

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

三、启动 Jenkins

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

默认端口：8080

浏览器访问：

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

四、初始配置

1. 获取管理员密码

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

复制到网页中解锁 Jenkins。

2. 安装插件

推荐：Install suggested plugins
常用插件：
- Git
- GitHub
- Pipeline
- Docker
- SSH

3. 创建管理员用户

设置用户名 / 密码 / 邮箱

五、基础配置（重点）

1. 配置 JDK

Manage Jenkins → Global Tool Configuration

添加 JDK
取消“自动安装”
指定 /usr/lib/jvm/java-17-openjdk-amd64

2. 配置 Git

通常已自动识别：

which git

如未识别，手动填写路径

3. 配置 Maven / Node（按需）

Maven：指定 MAVEN_HOME
Node：安装 NodeJS 插件

六、创建第一个任务（Freestyle）

新建任务 → Freestyle project
源码管理 → Git
```
https://github.com/your/repo.git
```
构建步骤 → Execute shell
```
echo "Hello Jenkins"
```
保存 → 立即构建

七、生产环境建议配置

1. 修改 Jenkins 端口

sudo nano /etc/default/jenkins

修改：

JENKINS_PORT=9090

重启：

sudo systemctl restart jenkins

2. 使用 Nginx 反向代理（推荐）

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

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

3. 开启 HTTPS（Let’s Encrypt）

sudo apt install certbot python3-certbot-nginx -y
sudo certbot --nginx

八、常见问题

Jenkins 无法启动

journalctl -u jenkins -xe

端口被占用

sudo lsof -i:8080

权限问题

sudo chown -R jenkins:jenkins /var/lib/jenkins

九、你接下来可以做什么？

✅ Pipeline as Code（Jenkinsfile）
✅ Docker 构建与部署
✅ 多节点 Slave
✅ Webhook 自动触发

如果你愿意，可以告诉我：

Ubuntu 版本（20.04 / 22.04？）
是否用于 Docker / K8s / Java / 前端
是否要 公网访问 / 内网

我可以直接给你定制版配置方案。