Jenkins在Debian上怎么部署

下面是 在 Debian 系统上部署 Jenkins 的完整步骤（官方推荐方式），适用于 Debian 11/12（bullseye / bookworm）。

一、环境准备

1. 更新系统

sudo apt update
sudo apt upgrade -y

2. 安装 Java（Jenkins 依赖）

Jenkins 依赖 Java 11 或 Java 17（推荐 Java 17）。

sudo apt install -y openjdk-17-jdk

验证：

java -version

二、添加 Jenkins 官方仓库（推荐）

1. 导入 Jenkins GPG 密钥

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

2. 添加 Jenkins APT 源

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

四、开放防火墙端口（如有 UFW）

Jenkins 默认使用 8080 端口。

sudo ufw allow 8080
sudo ufw reload

五、初始化 Jenkins

1. 获取初始管理员密码

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

2. 浏览器访问

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

粘贴上面获取的密码，点击 Continue。

六、安装插件 & 创建管理员

选择 Install suggested plugins（推荐）
等待插件安装完成
创建管理员账号
确认 Jenkins URL

七、常见问题

1. Jenkins 启动失败

查看日志：

journalctl -u jenkins -f

或：

cat /var/log/jenkins/jenkins.log

2. Java 版本问题

确认 Jenkins 使用的 Java：

sudo systemctl cat jenkins

可手动指定：

sudo update-alternatives --config java

八、可选配置

1. 修改 Jenkins 端口

编辑：

sudo nano /usr/lib/systemd/system/jenkins.service

修改：

Environment="JENKINS_PORT=8081"

重新加载：

sudo systemctl daemon-reload
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;
    }
}

九、总结

✅ Debian 上部署 Jenkins 的核心步骤：

安装 Java
添加 Jenkins 官方仓库
安装并启动 Jenkins
解锁并初始化
配置防火墙 / 反向代理

如果你需要 Docker 方式部署 Jenkins、Jenkins + GitLab / GitHub 集成、或 Pipeline 配置示例，可以继续问我。