Jenkins在Linux下安装需严格匹配Java版本（2.357+要求Java 11+）、正确导入2023年密钥、按systemd优先级修改服务配置文件，并确保目录权限与启动用户一致，否则将卡在启动或访问环节。
Jenkins在Linux下安装不是“选个包装上就行”的事——Java版本错、仓库密钥失效、服务用户权限配错，任何一个环节出问题都会卡在java -version或systemctl start jenkins这一步。直接用官方推荐方式（仓库安装）最稳妥，但必须严格按发行版区分操作，不能混用Debian和RHEL的命令。
确认Java版本是否满足Jenkins 2.357+要求
Jenkins 2.357起强制要求Java 11+，最新稳定版推荐Java 17或21。用java -version查到输出里带1.8.0或openjdk version "10.就立刻停手——继续装会启动失败，日志里只报Unsupported Java version，不指明具体哪一行错。
- Ubuntu/Debian：运行
sudo apt install openjdk-17-jdk，装完再sudo update-alternatives --config java选中17版本 - CentOS/RHEL 8+：用
sudo dnf install java-17-openjdk-devel；RHEL 7需先启用rhel-7-server-optional-rpms源 - 别用
java -jar jenkins.war临时跑来“验证Java可用”——它可能用的是系统默认Java，而非你刚装的17，实际服务启动时仍会崩
Debian/Ubuntu用apt装Jenkins时密钥导入失败
执行wget下载jenkins-keyring.asc后，apt update报NO_PUBKEY或KEYEXPIRED，本质是Jenkins官方密钥轮换过，旧脚本里的URL已失效。2026年当前有效密钥地址是https://pkg.jenkins.io/debian-stable/jenkins.io-2023.key，不是文档里常见的2021.key或2019.key。
- 删掉旧密钥：
sudo rm /usr/share/keyrings/jenkins-keyring.asc - 重新下载：
sudo wget -O /usr/share/keyrings/jenkins-keyring.asc https://pkg.jenkins.io/debian-stable/jenkins.io-2023.key - 检查密钥有效性：
gpg --no-default-keyring --keyring /usr/share/keyrings/jenkins-keyring.asc --list-keys，看到jenkins.io且有效期到2027年才算成功 - 如果
wget报Unable to establish SSL connection，先sudo apt install ca-certificates再重试
RHEL/CentOS改端口或切换运行用户要改对配置文件
很多人改/etc/sysconfig/jenkins发现没用，是因为新版Jenkins（2.361+）默认使用systemd托管，配置优先级是：/usr/lib/systemd/system/jenkins.service > /etc/sysconfig/jenkins。直接改后者，systemctl daemon-reload后仍读取service文件里的硬编码值。
- 改端口：编辑
/usr/lib/systemd/system/jenkins.service，找到Environment="JENKINS_PORT=8080"行，改成想要的端口（如8081），然后sudo systemctl daemon-reload && sudo systemctl restart jenkins - 切用户：同一文件里把
User=jenkins和Group=jenkins改成User=root（仅限测试环境！生产环境必须用独立低权用户），同时确保/var/lib/jenkins目录属主同步改掉：sudo chown -R root:root /var/lib/jenkins - 改完务必
sudo systemctl status jenkins看输出里Active:是否为active (running)，且Loaded:行末尾有(enabled; vendor preset: disabled)才说明生效
War包方式启动后插件安装卡住或构建失败
用java -jar jenkins.war启动时，若后续在Web界面点“安装推荐插件”一直转圈，或Maven构建报Cannot run program 'mvn'，大概率是工作目录权限或环境变量隔离导致的。
- 启动命令必须加
--prefix=/jenkins（避免反向代理冲突）和--httpPort=8080（显式指定端口），完整示例：nohup java -Djenkins.home=/var/lib/jenkins -jar /usr/local/jenkins.war --httpPort=8080 --prefix=/jenkins > /var/log/jenkins.log 2>&1 & -
/var/lib/jenkins目录权限必须和启动用户一致（比如用root启动，就得chown root:root /var/lib/jenkins），否则插件解压失败静默丢弃 - Maven/Git等工具不在
PATH里：Jenkins War包启动时不会继承系统PATH，得在Jenkins Web界面的“全局工具配置”里手动填绝对路径，例如/usr/bin/mvn、/usr/bin/git，不能只写mvn
真正麻烦的从来不是“装不上”，而是装上后systemctl status jenkins显示active，但浏览器打不开——这时候90%是防火墙没放行端口，或者SELinux策略拦截了监听行为，而不是Jenkins本身的问题。
