ubuntu jenkins如何配置

下面按**“在 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

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

# 导入 GPG 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

1. 启动服务

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

2. 开放端口（默认 8080）

sudo ufw allow 8080

浏览器访问：

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

四、初始化 Jenkins

1. 获取管理员密码

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

复制到网页中。

2. 安装插件

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

3. 创建管理员用户

五、基础配置（重点）

1. 配置 JDK / Maven / Git

Manage Jenkins → Global Tool Configuration

JDK：取消自动安装，填 /usr/lib/jvm/java-17-openjdk-amd64
Git：一般 /usr/bin/git
Maven（可选）：指定安装路径

2. 配置用户权限

Manage Jenkins → Security

推荐：
- 启用 Logged-in users can do anything
- 或安装 Role-based Authorization Strategy

3. 配置构建节点（Agent，可选）

适合多机器构建：

# Agent 机器
java -jar agent.jar -jnlpUrl http://IP:8080/...

六、创建一个简单任务（示例）

New Item → Freestyle Project
Source Code Management → Git
```
https://github.com/xxx/xxx.git
```
Build Steps → Execute shell
```
echo "Hello Jenkins"
./build.sh
```
保存 → Build Now

七、常见实用配置

1. 修改 Jenkins 端口

sudo nano /etc/default/jenkins

修改：

HTTP_PORT=8080

重启：

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. 配置自动启动

sudo systemctl enable jenkins

八、常见问题

Jenkins 无法启动

journalctl -u jenkins -f

端口被占用

sudo netstat -tunlp | grep 8080

如果你愿意，我可以继续帮你：

✅ 配置 Pipeline（Jenkinsfile）
✅ 接入 GitHub Webhook
✅ Docker + Jenkins
✅ CI/CD 完整示例

你现在的 Jenkins 是用来做什么项目？（Java / 前端 / Python / Docker？）