Debian部署Jenkins注意啥

在 Debian 上部署 Jenkins，有几个容易踩坑但很关键的点，下面按“系统准备 → 安装 → 配置 → 安全 → 运维”给你梳理一下。

一、系统准备

1. 系统版本

• 推荐 Debian 11 / 12
• 确保是 64 位系统

uname -m

2. Java 版本（非常重要）

Jenkins 对 Java 版本非常敏感

• Jenkins 2.4xx：Java 17 或 Java 21
• 旧版本可能只支持 Java 11

推荐：

apt install openjdk-17-jdk

检查：

java -version

⚠️ 不要混装多个 Java，容易导致 Jenkins 起不来

二、安装方式（推荐官方仓库）

1. 添加 Jenkins 官方源

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

echo deb [signed-by=/usr/share/keyrings/jenkins-keyring.asc] \
  https://pkg.jenkins.io/debian binary/ | sudo tee \
  /etc/apt/sources.list.d/jenkins.list > /dev/null

apt update

2. 安装

apt install jenkins

三、首次启动与初始化

1. 启动服务

systemctl enable --now jenkins

2. 查看初始密码

cat /var/lib/jenkins/secrets/initialAdminPassword

⚠️ 如果打不开页面，先确认端口（默认 8080）

四、网络与防火墙

1. 防火墙

ufw allow 8080

2. 云服务器

• 安全组必须放行 8080
• 不建议直接公网暴露 Jenkins

五、安全配置（非常重要）

1. 不要匿名访问

• 安装后立刻：
  • 创建管理员账号
  • 禁用匿名 read

2. 使用反向代理（强烈推荐）

推荐 Nginx + HTTPS

示例：

location / {
    proxy_pass http://127.0.0.1:8080;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
}

六、权限与目录

1. Jenkins 用户

• 默认运行用户：jenkins
• 家目录：/var/lib/jenkins

⚠️ 不要用 root 跑 Jenkins

2. 磁盘空间

• /var/lib/jenkins 很容易爆
• 构建历史、workspace 会越来越大

建议：

• 单独挂载磁盘
• 定期清理旧构建

七、插件与更新

1. 插件

• 初次只装 推荐插件
• 后续按需安装

2. 升级

• 先备份 /var/lib/jenkins
• 再 apt upgrade jenkins

八、常见坑总结

❌ Java 版本不对
❌ 8080 被占用
❌ 用 root 启动
❌ 公网裸奔
❌ 磁盘写满导致构建失败

如果你愿意，我可以：

• 给你一套 Debian + Nginx + Jenkins 完整部署脚本
• 或按你的 使用场景（CI / 部署 / 流水线） 给建议

你现在是打算 学习用 还是 生产环境？