如何用Debian跑Jenkins

下面给你一份在 Debian 上运行 Jenkins 的实用指南，从安装到基本使用，适合服务器环境（Debian 11/12 均可）。

一、准备工作

1. 系统要求

• Debian 11 (Bullseye) 或 Debian 12 (Bookworm)
• 至少 1 GB 内存（推荐 2 GB+）
• 已安装 sudo 的用户
• Java（Jenkins 依赖）

二、安装 Java

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

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

验证：

java -version

三、安装 Jenkins

方式一（推荐）：使用官方仓库

1. 导入 Jenkins GPG Key

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

2. 添加仓库

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

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

默认端口：8080

五、初始化 Jenkins

1. 打开浏览器

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

2. 获取初始管理员密码

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

3. 按向导操作

• 安装推荐插件
• 创建管理员用户
• 完成配置

六、防火墙（如有）

sudo ufw allow 8080

七、常见问题

1. Jenkins 启动失败

查看日志：

journalctl -u jenkins -f

常见原因：

• Java 版本不对
• 端口被占用

2. 修改端口

编辑：

sudo nano /etc/default/jenkins

修改：

JENKINS_PORT=9090

重启：

sudo systemctl restart jenkins

3. 用 Nginx 反向代理（可选）

适合生产环境，可隐藏端口、启用 HTTPS。

八、Docker 方式（备选）

如果你更想用 Docker：

docker run -d \
  -p 8080:8080 -p 50000:50000 \
  -v jenkins_home:/var/jenkins_home \
  --name jenkins \
  jenkins/jenkins:lts

九、总结

✅ Debian 跑 Jenkins 最稳方式：

• apt 安装 Jenkins
• systemd 管理
• Java 17

如果你愿意，我也可以帮你：

• 配置 Jenkins + Git + Maven
• 写 CI/CD Pipeline
• 配 Nginx + HTTPS
• 用 Docker Compose 部署

你准备用在什么场景？