Jenkins在Linux上启动失败通常源于Java版本错配、端口未开放、插件源被墙或SSH密钥权限错误；需确保JAVA_HOME与Jenkins实际使用的Java一致（推荐OpenJDK 11.0.22+或17.0.9+），强制指定-Djava.home启动；替换更新中心为国内镜像；Jenkins用户需独立配置SSH密钥并使用SSH格式仓库地址；WAR包方式启动比service安装更可控。
Jenkins 在 Linux 上跑不起来，八成不是 Jenkins 本身的问题，而是 Java 版本错配、端口没开、插件源被墙，或者 SSH 密钥权限不对——这几个点踩中任意一个，自动化部署就卡在第一步。
Zynq Linux Hardware Debug
下载
Zynq‑7000 / Zynq UltraScale+ 硬件调试技能。适用于 Xilinx Zynq（Cortex‑A9/A53 + FPGA）Linux 环境，调试 I2C、I2S、UART、GPIO 等外设。包括设备树配置、内核驱动、用户空间调试工具、交叉编译和常见问题排查，支持 PetaLinux 开发。
Java 版本和 JAVA_HOME 必须对齐
Jenkins 2.357+ 要求 Java 11 或 17（注意：OpenJDK 17.0.1 有兼容性问题，建议用 17.0.9+ 或 11.0.22+）。但系统里装了多个 JDK 时，java -version 显示的 ≠ Jenkins 实际用的。
- 查看 Jenkins 启动时到底用了哪个 Java：
ps aux | grep jenkins，找-Djava.home=参数 - 如果没指定，Jenkins 会自己猜，常猜错；最稳做法是启动时强制指定：
java -Djava.home=/usr/lib/jvm/java-11-openjdk-amd64 -jar jenkins.war --httpPort=8080 - 用包管理器安装（apt/yum）时，检查
/etc/default/jenkins（Debian）或/etc/sysconfig/jenkins（RHEL），确认JAVA_HOME指向正确路径 - 别信
update-alternatives --config java的结果——Jenkins 不走这个链路
插件更新失败卡在“正在启动，请稍后…”
这是国内部署 Jenkins 最常见的假死现象，根源是默认更新中心updates.jenkins-ci.org 访问超时或证书校验失败。
- 直接改配置文件：
/var/lib/jenkins/hudson.model.UpdateCenter.xml，把所有updates.jenkins-ci.org替换成镜像地址，例如：mirror.xmission.com/jenkins/updates/current（注意保留/updates/current路径结构） - 改完必须重启进程：
sudo systemctl restart jenkins或 kill 后重跑java -jar命令 - 临时验证可关防火墙：
sudo ufw disable（调试完再开） - 不要改浏览器代理或 hosts——Jenkins 进程自己发起 HTTPS 请求，跟你的浏览器无关
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 - 把
/var/lib/jenkins/.ssh/id_rsa.pub内容贴到 GitHub/GitLab 的 Deploy Keys（不是 SSH Keys）里 - Jenkins 项目配置里的 Repository URL 必须用 SSH 格式：
git@github.com:owner/repo.git，不能用 HTTPS
War 包方式比 service 安装更可控
用apt install jenkins 或 dnf install jenkins 看似省事，但背后绑定了 systemd、预设用户、硬编码路径，出问题时排查路径深、改配置多。
- 直接下载 WAR 包启动最透明：
wget -O /opt/jenkins.war <a href="https://www.php.cn/link/b176888a2b15da6c12ff7ce7e4f92ad7">https://www.php.cn/link/b176888a2b15da6c12ff7ce7e4f92ad7</a> - 手动指定工作目录和端口：
java -Djenkins.home=/var/lib/jenkins -jar /opt/jenkins.war --httpPort=8080 --httpListenAddress=0.0.0.0 - 日志直接输出到终端，异常堆栈一眼可见；想后台运行就加
nohup ... &，日志重定向到文件 - 这种方式不依赖系统级服务配置，也不受
/etc/init.d/jenkins或/usr/lib/systemd/system/jenkins.service里各种隐式参数干扰
真正卡住自动化部署的，往往不是流水线语法写错，而是 Jenkins 进程根本没拿到 Git 密钥、插件根本没装上、或者构建脚本里用了相对路径却跑在 jenkins 用户家目录下。先确保这四件事都对了，再谈 Pipeline 怎么写。
