如何用Debian配置Jenkins

下面以 Debian 11 / 12 为例，介绍如何安装和配置 Jenkins（基于官方推荐方式，使用 Java + Jenkins 仓库）。

一、环境准备

1. 更新系统

sudo apt update
sudo apt upgrade -y

2. 安装 Java（Jenkins 依赖）

Jenkins 需要 Java 11 或 Java 17

sudo apt install -y openjdk-17-jdk

验证：

java -version

二、安装 Jenkins

1. 导入 Jenkins GPG Key

sudo wget -O /usr/share/keyrings/jenkins-keyring.asc \
  https://pkg.jenkins.io/debian-stable/jenkins.io-2023.key

2. 添加 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

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. 开放防火墙（如有）

sudo ufw allow 8080

四、初始配置

1. 获取管理员密码

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

2. 浏览器访问

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

3. 初始化步骤

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

五、基本配置（推荐）

1. 修改 Jenkins 端口（可选）

编辑：

sudo nano /etc/default/jenkins

修改：

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

六、常见问题

1. Jenkins 无法启动

检查 Java：

which java

2. 插件安装慢

可在：

Manage Jenkins → Plugin Manager → Advanced

更换镜像源（如清华源）

如果你需要：

• 配置 CI/CD 流水线
• 集成 Git / Docker / Maven
• 使用 systemd 或 Docker 部署 Jenkins

可以继续告诉我你的使用场景。