debian jenkins部署哪步易错

在 Debian 上部署 Jenkins，最容易出错的环节通常集中在下面几个地方（按“踩坑频率”排序）：

1. Java 环境（最高频错误）

问题：

• Jenkins 新版本要求 Java 11 或 Java 17
• 系统自带 openjdk-8 或没装 JDK

易错点：

java -version

显示不对，但 Jenkins 已启动失败

正确做法：

sudo apt update
sudo apt install openjdk-17-jdk
java -version

⚠️ 不要只装 jre

2. 仓库和 GPG 密钥（Debian 特有坑）

问题：

• 官方源 GPG key 变了
• apt update 报 NO_PUBKEY

易错命令（老教程已失效）：

wget -q -O - https://pkg.jenkins.io/debian/jenkins.io.key

推荐方式（2023+）：

sudo wget -O /usr/share/keyrings/jenkins-keyring.asc \
  https://pkg.jenkins.io/debian-stable/jenkins.io-2023.key

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

3. 端口被占用 / 防火墙

问题：

• 默认 8080 被占用
• 云服务器安全组没开

检查：

sudo netstat -tunlp | grep 8080

防火墙：

sudo ufw allow 8080

云服务器还要在控制台放行

4. 权限问题（systemd）

问题：

• /var/lib/jenkins 权限不对
• 用 root 手动跑过 jenkins

错误现象：

Permission denied

修复：

sudo chown -R jenkins:jenkins /var/lib/jenkins
sudo systemctl restart jenkins

5. 初始化密码找不到

正确路径：

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

⚠️ 不是 /var/log/jenkins

6. 插件安装失败（国内常见）

原因：

• 默认插件源在国外

解决：

• 换清华源
• 或离线安装

7. 用 Docker 但没映射卷

错误：

docker run jenkins

容器一删，数据全没

✅ 正确：

-v jenkins_home:/var/jenkins_home

总结（最容易错 Top 3）

1. Java 版本不对
2. GPG 源配置错误
3. 端口/权限问题

如果你愿意，我可以：

• 给你一份 Debian 12 + Jenkins 最新版完整命令
• 或帮你 排查当前报错日志