debian上jenkins怎么配置

下面按最常见场景给你一份在 Debian（11/12 均适用）上安装并配置 Jenkins 的实用指南，偏向“能跑起来 + 基本可用配置”。

一、安装 Jenkins（Debian）

1. 安装 Java（Jenkins 依赖）

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

sudo apt update
sudo apt install -y openjdk-17-jdk

验证：

java -version

2. 添加 Jenkins 官方源

sudo apt install -y curl gnupg

curl -fsSL https://pkg.jenkins.io/debian-stable/jenkins.io-2023.key | sudo tee \
  /usr/share/keyrings/jenkins-keyring.asc > /dev/null

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

3. 安装 Jenkins

sudo apt update
sudo apt install -y jenkins

4. 启动并设置开机自启

sudo systemctl enable --now jenkins
sudo systemctl status jenkins

二、初始配置

1. 获取管理员密码

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

浏览器访问：

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

粘贴密码 → 继续

2. 安装插件

推荐：Install suggested plugins
常用插件：
- Git
- Pipeline
- Docker
- SSH Pipeline Steps
- Blue Ocean（可选）

3. 创建管理员用户

完成后即可登录 Jenkins

三、基础系统配置（重点）

1. 配置 JDK / Maven / Git

Manage Jenkins → Global Tool Configuration

JDK
- 名称：JDK17
- 勾选 Install automatically（或指定路径）
Git
- 一般系统已自带 /usr/bin/git
Maven（Java 项目需要）
- 名称：Maven3
- 自动安装

2. 配置凭据（Credentials）

Manage Jenkins → Credentials → System → Global

常见类型：

Username with password（Git / 服务器）
SSH Username with private key（推荐）

示例（Git SSH）：

cat ~/.ssh/id_rsa

粘贴到 Private Key

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

如果是多机器：

新建节点
启动方式：
- SSH
- 或 Java Web Start（不推荐）

四、创建一个简单 Job（示例）

1. 新建 Item

名称：test-pipeline
类型：Pipeline

2. Pipeline 示例

pipeline {
    agent any
    stages {
        stage('Clone') {
            steps {
                git 'https://github.com/your/repo.git'
            }
        }
        stage('Build') {
            steps {
                sh 'mvn clean package'
            }
        }
    }
}

五、常见问题 & 配置技巧

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. 权限管理（重要）

Matrix Authorization Strategy
或安装 Role-based Authorization Strategy

六、升级 Jenkins

sudo apt update
sudo apt upgrade jenkins

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

✅ Debian 版本
✅ Jenkins 用途（Java / 前端 / Docker / K8s）
✅ 是否要 HTTPS / 域名

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