Jenkins在Debian如何设置

下面给你一份在 Debian 上安装与基础配置 Jenkins 的实用指南（以 Debian 11/12 为例，适用于 systemd）。

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

1. 安装依赖

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

Jenkins 需要 Java

• Jenkins 2.4xx+ 推荐 Java 17
• 旧版本可用 Java 11

查看 Java：

java -version

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

二、启动与开机自启

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

访问地址：

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

三、初始配置

1. 获取管理员密码

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

在浏览器中输入该密码。

2. 安装插件

• 推荐：Install suggested plugins
• 或自定义插件（Git、Pipeline、Docker 等）

3. 创建管理员用户

按页面提示设置用户名、密码、邮箱。

四、常用配置

1. 修改 Jenkins 端口

编辑：

sudo nano /etc/default/jenkins

修改：

JENKINS_PORT=8080

重启：

sudo systemctl restart jenkins

2. 防火墙（如有）

sudo ufw allow 8080

3. 使用 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;
    }
}

五、目录与日志说明

六、常见问题

Jenkins 启动失败

journalctl -u jenkins -xe

Java 版本不对

sudo update-alternatives --config java

如果你需要：

• Jenkins + Docker
• Jenkins Pipeline 示例
• Debian + Jenkins + GitHub 自动部署

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