Debian下Jenkins怎么配置

下面给你一个在 Debian 系统下配置 Jenkins 的完整思路，从安装到常见配置，适合服务器环境（Debian 11/12 均可参考）。

一、安装 Jenkins（Debian）

1. 安装 Java（Jenkins 依赖）

Jenkins 需要 Java 11 或 Java 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/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 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 jenkins
sudo systemctl start jenkins
sudo systemctl status jenkins

二、初始配置 Jenkins

1. 获取管理员密码

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

浏览器访问：

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

输入密码完成初始化。

2. 安装推荐插件

选择 Install suggested plugins
常见插件：
- Git
- Pipeline
- Credentials Binding
- SSH Agent

3. 创建管理员用户

初始化完成后，建议：

不使用默认 admin
新建一个管理员账号

三、Jenkins 常用配置（重点）

1. 修改 Jenkins 端口（可选）

编辑：

sudo nano /etc/default/jenkins

修改：

HTTP_PORT=8080

重启：

sudo systemctl restart jenkins

2. 配置 Git

sudo apt install -y git

Jenkins → Manage Jenkins → Global Tool Configuration

添加 Git
Path: /usr/bin/git

3. 配置 JDK / Maven / Node（按需）

例如 Maven：

Global Tool Configuration
Add Maven
自动安装或指定路径

4. 配置凭据（Credentials）

常用于：

Git 仓库（SSH / Token）
服务器部署（SSH）

路径：

Manage Jenkins → Credentials → System → Global credentials

5. 配置 Pipeline（最常用）

示例 Jenkinsfile：

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

四、生产环境建议

1. 使用 Nginx 反向代理（强烈推荐）

sudo apt install -y 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;
    }
}

2. 开启 HTTPS（Let’s Encrypt）

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

3. 权限与备份

定期备份：

/var/lib/jenkins

可使用 thinBackup 插件

五、常见问题

Jenkins 无法启动？

journalctl -u jenkins -xe

端口被占用？

sudo netstat -tunlp | grep 8080

忘记管理员密码？

删除：

/var/lib/jenkins/users/admin*

然后重启（会重置初始化）。

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

Debian 版本
用途（Java / 前端 / Docker / K8s）
是否要 CI/CD 到服务器

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