Linux安装Jenkins流水线核心是“环境稳、服务起、插件全、流水通”：必须先装JDK 11+（推荐17），确保JAVA_HOME指向含javac的完整JDK；用官方APT/YUM源安装而非WAR包；初始化选“推荐插件”并重启服务；最后确认Git访问、Jenkinsfile位置及构建工具权限。
Linux 运维中安装配置 Jenkins 自动化部署流水线，核心是“环境稳、服务起、插件全、流水通”。跳过 JDK 11+ 或用错安装源，后续所有步骤都会卡在启动失败或 Pipeline 报错上。
必须先装对 Java 环境
Jenkins 启动时不仅检查 java -version，还严格验证 $JAVA_HOME/bin/javac 是否存在。很多系统自带的 JRE 或精简版 OpenJDK 不含编译器，会导致 systemctl start jenkins 直接失败。
- Ubuntu/Debian 推荐执行：
sudo apt install openjdk-17-jdk - CentOS/RHEL 推荐执行：
sudo yum install java-17-openjdk-devel - 装完后运行：
sudo update-alternatives --config java，确认默认指向 JDK（含javac） - 再验证：
echo $JAVA_HOME应输出路径，且ls $JAVA_HOME/bin/javac必须有结果
用官方源安装 Jenkins 服务
不建议直接跑 WAR 包——它缺 systemd 集成、日志轮转和自动更新，运维负担重。官方 APT/YUM 源安装更规范、权限更可控。
- Ubuntu/Debian：
curl -fsSL https://pkg.jenkins.io/debian-stable/jenkins.io-2023.key | sudo gpg --dearmor -o /usr/share/keyrings/jenkins-stable-keyring.ascecho "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/jenkins-stable-keyring.asc] https://pkg.jenkins.io/debian-stable binary/" | sudo tee /etc/apt/sources.list.d/jenkins.listsudo apt update && sudo apt install jenkins - CentOS/RHEL：
sudo rpm --import https://pkg.jenkins.io/redhat-stable/jenkins.io-2023.keysudo sh -c 'echo "[jenkins-stable]\nname=Jenkins-stable\nbaseurl=https://pkg.jenkins.io/redhat-stable\nenabled=1\ngpgcheck=1\ngpgkey=https://pkg.jenkins.io/redhat-stable/jenkins.io-2023.key" > /etc/yum.repos.d/jenkins.repo'sudo yum install jenkins - 启动并设为开机自启：
sudo systemctl enable --now jenkins - 检查状态：
sudo systemctl status jenkins，若失败立刻查日志：journalctl -u jenkins -n 50 -f
初始化时选“推荐安装”并配好关键插件
初始 Web 页面解锁后，务必点“Install suggested plugins”。选“Custom”容易漏掉 Pipeline 支持，导致新建项目找不到 Pipeline 类型，或执行 pipeline { } 报 CpsScript not found 错误。
- “推荐安装”默认包含：Pipeline、Git、Credentials Binding、SCM API 四个核心插件
- 装完后必须重启服务：
sudo systemctl restart jenkins，否则部分类加载不全 - 初始管理员密码在：
sudo cat /var/lib/jenkins/secrets/initialAdminPassword - 后续需配置全局工具（如 Maven、Node.js）、添加 Git 凭据、设置构建节点权限（如
jenkins用户需有部署目录写入权）
创建第一个声明式流水线前确认三件事
很多人建完 Pipeline 项目点“立即构建”就失败，问题不在 Jenkinsfile，而在前置链没打通。
- Git 仓库地址能被 Jenkins 服务器访问（SSH key 已加到
/var/lib/jenkins/.ssh/，或 HTTPS 凭据已存 Credential Store） - Jenkinsfile 存在且语法正确（放在代码根目录，不是子目录；用 官方语法校验器 验证）
- 构建节点（默认 master）已安装所需命令行工具（如
git、mvn、docker），且jenkins用户对其有执行权限
整个过程不复杂但容易忽略细节。把 Java 和源配对、服务跑稳、插件装全、权限理清，流水线就能自然跑起来。
