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（推荐 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.key

# 添加 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 > /dev/null

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

三、启动 Jenkins

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

默认端口：8080

四、初始配置

1. 打开浏览器

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

2. 获取管理员密码

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

复制粘贴到页面中。

3. 安装插件

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

4. 创建管理员用户

设置用户名、密码、邮箱。

五、基础配置（重点）

1. 全局工具配置

路径：

Manage Jenkins → Global Tool Configuration

配置：

JDK
Git
Maven / Gradle
NodeJS（前端项目）

示例（Git）：

Name: Default Git
Path: /usr/bin/git

2. 配置凭据（Credentials）

路径：

Manage Jenkins → Credentials → System → Global

常用凭据类型：

Username with password（Git / 服务器）
SSH Username with private key
Docker Registry

3. 配置时区（中文环境推荐）

sudo timedatectl set-timezone Asia/Shanghai

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

1. 新建 Item

选择 Freestyle project 或 Pipeline

2. 配置 Git

Repository URL: git@github.com:xxx/xxx.git
Credentials: 选择 SSH Key

3. 构建步骤

echo "Hello Jenkins"

4. 保存并 Build Now

七、常见问题

1. 端口冲突

修改端口：

sudo nano /etc/default/jenkins

JENKINS_PORT=8081

sudo systemctl restart jenkins

2. 无法访问 8080

sudo ufw allow 8080

3. Jenkins 启动失败

查看日志：

journalctl -u jenkins

八、进阶建议

✅ 使用 Pipeline + Jenkinsfile
✅ 配合 Docker / Kubernetes
✅ 使用 Nginx 反向代理 + HTTPS
✅ 定期备份 /var/lib/jenkins

如果你有具体用途（如：Java 项目 / Vue 前端 / Docker 部署 / 多节点），我可以给你针对性的 Jenkins 配置示例。