直接用系统包管理器安装Jenkins不可用，因版本太老（如Ubuntu 22.04自带2.361），会导致Pipeline语法报错、插件不兼容及Java版本冲突；必须换官方apt源或Docker方式部署，并严格配置Java 17、清华镜像源及正确JAVA_HOME路径。
直接用系统包管理器装 jenkins（比如 Ubuntu 22.04 的 apt install jenkins）基本不可用——版本太老，Pipeline 语法报错、插件不兼容、Java 版本冲突全都会撞上。必须换源或换部署方式。
用官方 apt 源安装 Jenkins（推荐用于生产环境）
系统自带源的 jenkins 版本滞后严重（如 Ubuntu 22.04 自带 2.361），而当前 LTS 版本已要求 Java 17、支持现代 Pipeline 语法。官方源能保证版本同步和安全更新。
- 先彻底清理旧版：
sudo apt remove --purge jenkins，并手动删掉/var/lib/jenkins - 导入 GPG 密钥：
wget -q -O - https://pkg.jenkins.io/debian-stable/jenkins.io-2023.key | sudo apt-key add - - 加源：
echo "deb https://pkg.jenkins.io/debian-stable binary/" | sudo tee /etc/apt/sources.list.d/jenkins.list - 装 OpenJDK 17：
sudo apt install openjdk-17-jdk，再确认路径：readlink -f $(which java)往上推两级得到JAVA_HOME - 编辑
/etc/default/jenkins，设置JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64（路径按实际调整） - 启动：
sudo systemctl daemon-reload && sudo systemctl start jenkins
用 Docker 运行 Jenkins（适合快速验证或隔离环境）
Docker 方式省去 Java 环境冲突和系统服务配置，但注意：容器内默认没装 git、mvn、docker CLI，后续构建 SpringBoot 或需要调用本地 Docker 的场景会失败。
- 拉镜像：
docker pull jenkins/jenkins:lts - 运行时挂载数据卷和 socket：
docker run -d -p 8080:8080 -p 50000:50000 -v jenkins_home:/var/lib/jenkins -v /var/run/docker.sock:/var/run/docker.sock --name jenkins jenkins/jenkins:lts - 首次访问卡在“请等待初始化完成”，不是挂了，是插件中心连不上
updates.jenkins-ci.org；进容器改/var/lib/jenkins/updates/default.json，把url字段换成清华镜像地址：https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json - 如果要用
docker build，宿主机的docker命令必须可用，且容器需有权限读写/var/run/docker.sock（不建议用 root 用户跑容器）
Jenkins 启动失败常见原因和诊断方法
systemctl status jenkins 显示 Failed to start LSB: Start Jenkins at boot time，90% 是 Java 版本问题。Jenkins 2.387+ 强制要求 Java 17，但系统默认可能是 11 或 8。
- 查当前 Java：
java -version和update-alternatives --config java - 日志里典型错误：
java.lang.UnsupportedClassVersionError: org/eclipse/jetty/server/handler/HandlerCollection has been compiled by a more recent version of the Java Runtime - 确认
/etc/default/jenkins中的JAVA_HOME指向的是 JDK 17 路径，不是 JRE，也不是/usr/bin/java这种软链接 - 改完一定要执行
sudo systemctl daemon-reload，否则systemctl restart jenkins不会重读配置
首次访问页面卡住不动怎么办
这不是 Jenkins 崩溃，而是它在后台尝试从官方更新中心下载插件列表。国内网络环境下，DNS 解析慢 + 连接超时会导致页面进度条卡死，tail -f /var/log/jenkins/jenkins.log 会反复刷 Failed to load update center。
- 最轻量解法：启动前在
/etc/default/jenkins加JENKINS_ARGS="--httpPort=8080 --disable-updates"，跳过插件加载，进后台再手动装 - 更稳妥做法：编辑
/var/lib/jenkins/updates/default.json，把url改成清华镜像：https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json - 别用浏览器反复刷新——这会触发多次重复请求，加重阻塞；等 2~3 分钟，看日志是否有
Finished Downloading updates类似提示
真正麻烦的不是安装步骤，而是 Java 版本、插件中心网络、Docker 权限这三处细节一旦漏掉一个，就会卡在某个环节半天没反应。尤其是 JAVA_HOME 路径写错、/var/run/docker.sock 权限没给、镜像地址没换——这些地方不会报明确错误，只会静默失败。
