下面是一个详细的、可直接操作的教程，教你如何在 Linux 环境（以 Red Hat Enterprise Linux 9 / CentOS 9 / Rocky 9 等兼容系统） 下安装 Jenkins 2.346.3，并确保它能正常运行在 Docker 或系统服务 模式下。

🧩 一、系统要求

组件要求
操作系统RHEL 9 / CentOS Stream 9 / Rocky 9
JavaJDK 11（推荐 AdoptOpenJDK / Temurin 版本）
网络能访问 Jenkins 官方仓库或镜像源
权限root 或 sudo 用户

⚙️ 二、安装 Java 环境

Jenkins 2.346.3 需要 Java 11（不支持 Java 17+）。

sudo dnf install java-11-openjdk java-11-openjdk-devel -y

验证：

java -version

输出类似：

openjdk version "11.0.23" 2024-04-16

🧱 三、添加 Jenkins 官方仓库

sudo wget -O /etc/yum.repos.d/jenkins.repo \
    https://pkg.jenkins.io/redhat-stable/jenkins.repo
sudo rpm --import https://pkg.jenkins.io/redhat-stable/jenkins.io-2023.key

🔹 Jenkins 2.346.3 属于 LTS（Long-Term Support）系列，可以直接从官方 stable 仓库安装。

🧰 四、安装指定版本 Jenkins（2.346.3）

先查看仓库中有哪些版本：

dnf list jenkins --showduplicates

找到 2.346.3 版本后安装：

sudo dnf install jenkins-2.346.3 -y

安装完成后，Jenkins 主要文件路径如下：

路径说明
/usr/lib/jenkins/jenkins.war主程序文件
/etc/sysconfig/jenkins配置环境变量（端口、JAVA_HOME等）
/var/lib/jenkins默认 Jenkins Home（插件、Job、配置等）
/var/log/jenkins/jenkins.log日志文件
/usr/lib/systemd/system/jenkins.servicesystemd 服务文件

🚀 五、启动 Jenkins 服务

启动并设置开机自启：

sudo systemctl daemon-reload
sudo systemctl enable jenkins
sudo systemctl start jenkins

查看状态：

sudo systemctl status jenkins

若看到：

Active: active (running)

则启动成功。

🌐 六、开放防火墙端口（默认8080）

sudo firewall-cmd --permanent --add-port=8080/tcp
sudo firewall-cmd --reload

🔑 七、首次访问与解锁 Jenkins

浏览器访问：

http://<你的服务器IP>:8080

系统会提示输入 初始管理员密码：

查看密码：

sudo cat /var/lib/jenkins/secrets/initialAdminPassword

复制后粘贴到网页中，进入 Jenkins 初始化向导。

🧩 八、插件安装与用户设置

你会看到两个选项：

  • Install suggested plugins（推荐安装）
  • Select plugins to install（自定义安装）

建议先选择推荐安装，安装完后创建第一个管理员用户。

🔧 九、Jenkins 配置优化（可选）

编辑环境配置文件：

sudo vim /etc/sysconfig/jenkins

可修改：

JENKINS_PORT="8080"
JENKINS_USER="jenkins"
JAVA_ARGS="-Djava.awt.headless=true -Xmx1024m"

保存后重启 Jenkins：

sudo systemctl restart jenkins

🐳 十、（可选）用 Docker 方式部署 Jenkins 2.346.3

若你不想直接安装到系统，可用 Docker：

docker run -d \
  --name jenkins \
  -p 8080:8080 -p 50000:50000 \
  -v jenkins_home:/var/jenkins_home \
  jenkins/jenkins:2.346.3-lts-jdk11

查看日志：

docker logs -f jenkins

同样访问 http://<IP>:8080 即可。

🧠 十一、验证与维护

检查 Jenkins 启动状态：

sudo systemctl status jenkins

查看日志：

sudo tail -f /var/log/jenkins/jenkins.log

更新插件：
进入 Jenkins → Manage Jenkins → Manage Plugins。

✅ 十二、卸载 Jenkins（若需）

sudo systemctl stop jenkins
sudo dnf remove jenkins -y
sudo rm -rf /var/lib/jenkins /var/log/jenkins