如何部署debian上的jenkins

下面给你一份在 Debian 上部署 Jenkins 的实用指南，适用于 Debian 11 / 12（也基本适用于 Ubuntu）。

一、准备工作

1. 系统要求

• Debian 11/12（64 位）
• 至少 1 GB 内存（推荐 2 GB+）
• Java 11 或 Java 17（Jenkins 当前主流要求）

2. 更新系统

sudo apt update
sudo apt upgrade -y

二、安装 Java

Jenkins 依赖 Java，推荐安装 OpenJDK 17：

sudo apt install -y openjdk-17-jdk

验证：

java -version

三、添加 Jenkins 官方仓库

1. 安装依赖

sudo apt install -y curl gnupg2 ca-certificates

2. 导入 Jenkins GPG 密钥

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

3. 添加软件源

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

四、安装 Jenkins

sudo apt update
sudo apt install -y jenkins

五、启动 Jenkins

1. 启动并设置开机自启

sudo systemctl enable --now jenkins

2. 查看状态

sudo systemctl status jenkins

六、配置防火墙（如有）

sudo apt install -y ufw
sudo ufw allow 8080
sudo ufw enable

七、初始化 Jenkins

1. 浏览器访问

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

2. 获取管理员密码

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

3. 安装插件

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

4. 创建管理员用户

八、常见问题

1. Jenkins 启动失败

查看日志：

journalctl -u jenkins -f

2. Java 版本不对

确保：

which java
java -version

3. 修改端口

编辑：

sudo nano /etc/default/jenkins

修改：

JENKINS_PORT=9090

重启：

sudo systemctl restart jenkins

九、（可选）使用 Nginx 反代

sudo apt install -y 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
• 启动并初始化
• 基础运维配置

如果你需要：

• Docker 方式部署 Jenkins
• Jenkins + GitLab / GitHub
• Pipeline 示例
• Jenkins 集群 / Agent 配置

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