如何基于Debian部署Jenkins

下面给你一份基于 Debian（如 Debian 11 / 12）部署 Jenkins 的实用指南，从系统准备到基本配置，适合生产或测试环境。

一、系统准备

1. 更新系统

sudo apt update
sudo apt upgrade -y

2. 安装基础依赖

sudo apt install -y curl wget gnupg2 software-properties-common ca-certificates

二、安装 Java（Jenkins 依赖）

Jenkins 需要 Java 11 或 Java 17（推荐 Java 17）

安装 OpenJDK 17

sudo apt install -y openjdk-17-jdk

验证：

java -version

三、添加 Jenkins 官方仓库

1. 导入 Jenkins GPG Key

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

四、启动并配置 Jenkins

1. 启动服务

sudo systemctl enable jenkins
sudo systemctl start jenkins

查看状态：

sudo systemctl status jenkins

五、防火墙配置（如有）

放行 8080 端口

sudo ufw allow 8080

访问地址：

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

六、初始化 Jenkins

1. 获取初始管理员密码

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

在浏览器中粘贴该密码完成初始化。

2. 安装推荐插件

• 选择 Install suggested plugins
• 创建管理员账号
• 配置 Jenkins URL（默认即可）

七、（可选）使用 Nginx 反向代理

1. 安装 Nginx

sudo apt install -y 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;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

sudo nginx -t
sudo systemctl reload nginx

八、常见问题

1. Jenkins 无法启动

检查：

• Java 是否正确安装
• 端口是否被占用

2. 插件安装慢

可配置国内镜像（如清华源）：

https://mirrors.tuna.tsinghua.edu.cn/jenkins/

九、总结

✅ 已完成：

• Debian 系统准备
• Java 环境
• Jenkins 安装与启动
• Web 初始化

如果你需要：

• Docker 方式部署 Jenkins
• Jenkins + GitLab / GitHub 集成
• Pipeline 示例
• 生产级安全加固

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