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

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

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）：

sudo netstat -tnlp | grep 8080

四、初始配置

1. 浏览器访问

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

2. 获取初始管理员密码

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

粘贴到网页中。

3. 安装插件

推荐：Install suggested plugins
或按需选择（Git、Pipeline、Docker 等）

4. 创建管理员用户

按提示填写用户名、密码、邮箱。

五、常用配置

1. 修改 Jenkins 端口（可选）

编辑：

sudo nano /etc/default/jenkins

修改：

HTTP_PORT=8081

重启：

sudo systemctl restart jenkins

2. 配置 Git

sudo apt install git -y

Jenkins → Manage Jenkins → Global Tool Configuration → Git

3. 配置 JDK / Maven（如需要）

Manage Jenkins → Global Tool Configuration
添加 JDK / Maven 自动安装

4. 配置构建用户权限

sudo usermod -aG docker jenkins
sudo systemctl restart jenkins

（如 Jenkins 需要执行 Docker）

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

New Item → Freestyle project
Source Code Management → Git
Build Steps → Execute shell
输入测试命令：

echo "Hello Jenkins"

保存 → Build Now

七、防火墙（如有）

sudo ufw allow 8080

八、常见问题

Jenkins 无法启动

journalctl -u jenkins -xe

忘记管理员密码

删除：

sudo rm /var/lib/jenkins/secrets/initialAdminPassword

重启 Jenkins 重新初始化（或改 config.xml）

如果你有具体用途（如：Spring Boot 自动部署、Docker 构建、K8s、流水线 Pipeline），我可以直接给你对应配置示例。