Jenkins在Debian怎么配置

下面按从零开始的思路，给你一份在 Debian 上配置 Jenkins 的实用指南（以 Debian 11/12 为例，适用于大多数情况）。

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

1. 安装依赖

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

Jenkins 2.4xx 推荐 Java 17
如果用旧版 Jenkins，可用 openjdk-11-jdk

2. 添加 Jenkins 官方仓库

curl -fsSL https://pkg.jenkins.io/debian-stable/jenkins.io.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

二、启动并配置 Jenkins

1. 启动服务

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

2. 开放端口（默认 8080）

sudo ufw allow 8080

或（无 ufw 时）：

sudo iptables -A INPUT -p tcp --dport 8080 -j ACCEPT

3. 获取初始管理员密码

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

浏览器访问：

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

三、初始化 Jenkins

1. 输入初始密码
2. 选择：
   • Install suggested plugins（推荐）
3. 创建管理员用户
4. 完成安装

四、常用配置

1. 修改 Jenkins 端口

编辑：

sudo nano /etc/default/jenkins

修改：

HTTP_PORT=8080

重启：

sudo systemctl restart jenkins

2. 配置 Jenkins 以非 root 用户运行（默认已是 jenkins）

查看用户：

ps aux | grep jenkins

3. 安装常用插件

• Git
• Pipeline
• GitHub Integration
• Docker
• Credentials Binding

五、用 Nginx 反向代理（可选但推荐）

1. 安装 Nginx

sudo apt install nginx

2. 配置

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;
    }
}

sudo nginx -t
sudo systemctl restart nginx

六、常见问题

Jenkins 启动失败

journalctl -u jenkins -f

常见原因：

• Java 版本不对
• 端口被占用

忘记管理员密码

sudo nano /var/lib/jenkins/users/admin/config.xml

或删除用户目录后重启。

七、简单 Pipeline 示例

pipeline {
    agent any
    stages {
        stage('Build') {
            steps {
                sh 'echo Hello Jenkins'
            }
        }
    }
}

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

• Debian 版本
• 是否用 Docker
• 是否要 CI/CD（Git + Maven / Node / Docker）

我可以给你更针对性的配置方案。