jenkins在linux启动失败主因是java版本错配、端口权限或网络配置问题；应强制指定java_home启动，替换更新中心url为国内镜像，ssh密钥需为jenkins用户生成并配置，构建脚本须用绝对路径并理清进程身份与权限边界。
Jenkins 在 Linux 上跑不起来，八成不是 Jenkins 本身的问题，而是 Java、端口、权限或网络配置没对齐。直接用 java -jar jenkins.war 启动最可控，比扔进 Tomcat 少一层干扰。
确认 Java 版本和 JAVA_HOME 是否真被 Jenkins 识别
Jenkins 要求 Java 11+（官方明确不支持 Java 17 的某些早期 LTS 版本，慎用 17.0.1），但很多系统装了多个 JDK，java -version 显示的版本 ≠ Jenkins 实际用的版本。
- 检查
/usr/lib/jenkins/jenkins.sh或/etc/init.d/jenkins（如果用 service 安装）里是否硬编码了JAVA_HOME；没写就默认走系统 PATH，容易错配 - 用
ps aux | grep jenkins看启动命令里有没有显式指定-Djava.home=；没有的话，Jenkins 会自己猜，常猜错 - 最稳妥：启动时强制指定，例如
java -Djava.home=/usr/lib/jvm/java-11-openjdk-amd64 -jar jenkins.war --httpPort=8080
插件更新失败 / “Jenkins 正在启动，请稍后…” 卡死
这是国内部署 Jenkins 最高频的阻塞点——它默认从 https://updates.jenkins-ci.org/update-center.json 拉插件元数据，DNS 污染 + HTTPS 证书校验失败导致超时或空响应。
Linux Ai Server
下载
Linux AI 服务器 — 将 Linux 服务器转换为本地 AI 推理集群。使用 systemd、NVIDIA CUDA 实现无头 Linux AI，零 GUI 开销。
- 别改浏览器设置，要改 Jenkins 自己的更新中心 URL：编辑
/var/lib/jenkins/hudson.model.UpdateCenter.xml - 把里面的
updates.jenkins-ci.org替换为镜像地址，例如：mirror.xmission.com/jenkins/updates/current（注意保留路径结构） - 改完必须重启 Jenkins 进程，
systemctl restart jenkins或kill -9后重跑java -jar命令 - 如果仍失败，临时关防火墙：
sudo ufw disable（验证后再开）
Git 拉不到代码：SSH key 不生效或认证失败
Jenkins 进程默认以 jenkins 用户运行，它看不到你个人账户下的 ~/.ssh/id_rsa，也不会读你的 ssh-agent。
- 切到 jenkins 用户下操作：
sudo -u jenkins -s，再运行ssh -T git@github.com测试连通性 - 生成专属密钥：
ssh-keygen -t rsa -b 4096 -C "jenkins@yourdomain" -f /var/lib/jenkins/.ssh/id_rsa - 把公钥内容（
cat /var/lib/jenkins/.ssh/id_rsa.pub）贴到 GitHub/GitLab 的 Deploy Keys 或 SSH Keys 设置页 - 源码管理里 URL 必须用 SSH 格式：
git@github.com:owner/repo.git，不能用 HTTPS
构建后无法自动发布到目标服务器
常见于用 sh 构建步骤执行 scp 或 rsync 失败，错误信息往往只显示 “command not found” 或 “Permission denied”，实际是环境隔离问题。
- Jenkins 的 shell 步骤默认不加载用户 profile，PATH 很可能不含
scp、rsync或java；建议写全路径，比如/usr/bin/rsync - 目标服务器的 SSH 登录用户，必须和 Jenkins 所用密钥的授权用户一致；别用 root 密钥去连普通用户目录
- 如果用 systemd 管理服务（如
spring-boot.jar），Jenkins 的sh步骤里执行systemctl restart myapp会失败——因为没 TTY 且权限不足；应改用sudo systemctl restart myapp，并提前给 jenkins 用户免密 sudo 权限：echo "jenkins ALL=(ALL) NOPASSWD: /bin/systemctl restart myapp" | sudo tee /etc/sudoers.d/jenkins
真正卡住的地方，从来不是 Jenkins 界面按钮怎么点，而是它的进程身份、环境变量、文件权限这三层边界没理清。每次构建失败，先看 /var/log/jenkins/jenkins.log 里最顶上那几行报错，比在 Web UI 里瞎点“查看控制台输出”快得多。
