debian怎样配置jenkins

下面给你一份 在 Debian 上配置 Jenkins 的实用指南，从安装到基础配置，适合新手和运维使用。

一、环境准备

1. 系统要求

• Debian 10 / 11 / 12（推荐 11+）
• 至少 1 GB 内存（生产建议 2 GB+）
• 已安装 Java（JDK 11 或 17）

2. 安装 Java

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

验证：

java -version

二、安装 Jenkins

方法一：官方仓库安装（推荐）

1. 导入 Jenkins 密钥

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

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 > /dev/null

3. 安装 Jenkins

sudo apt update
sudo apt install -y jenkins

三、启动与开机自启

sudo systemctl enable --now jenkins
sudo systemctl status jenkins

默认端口：8080

四、初始配置

1. 获取管理员密码

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

2. 浏览器访问

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

3. 解锁 Jenkins

• 输入上面的密码
• 选择 Install suggested plugins
• 创建管理员用户

五、基础安全配置（重要）

1. 修改默认端口（可选）

编辑：

sudo nano /etc/default/jenkins

修改：

JENKINS_PORT=8080

重启：

sudo systemctl restart jenkins

2. 开启防火墙

sudo ufw allow 8080
sudo ufw enable

六、反向代理（Nginx，推荐）

1. 安装 Nginx

sudo apt install -y nginx

2. 配置站点

sudo nano /etc/nginx/sites-available/jenkins

示例：

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 ln -s /etc/nginx/sites-available/jenkins /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl restart nginx

七、常用插件推荐

• Git
• Pipeline
• Blue Ocean
• Credentials Binding
• Docker / Kubernetes

八、常见问题

Jenkins 启动失败

journalctl -u jenkins -xe

Java 版本不对

确认：

which java
java -version

九、总结

✅ 已完成：

• Debian 安装 Jenkins
• 初始化配置
• 基础安全与 Nginx 反代

如果你需要：

• Jenkins + Docker 构建
• Pipeline 示例
• Jenkins 权限管理（RBAC）

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