麒麟OS部署Jenkins需独立安装JDK 11、下载校验官方WAR包、配置systemd服务、放行防火墙端口，并精简安装Git/Pipeline/JUnit插件以避免兼容性问题。
如果您在麒麟操作系统上部署Jenkins持续集成环境时遇到启动失败、Java版本不兼容或服务无法开机自启等问题，则很可能是由于系统默认JDK版本与Jenkins版本要求不匹配，或服务配置未适配麒麟OS的systemd机制。以下是针对麒麟OS（V10系列）安装Jenkins并完成CI基础部署的实战步骤：
一、确认系统环境与JDK准备
麒麟OS V10默认预装JDK 1.8，但Jenkins 2.426及以上LTS版本强制要求JDK 11或更高版本。为避免破坏系统稳定性，需独立安装JDK 11并隔离使用。此步骤确保Jenkins运行时不受系统JAVA_HOME干扰。
1、执行uname -m确认架构为x86_64或aarch64，下载对应OpenJDK 11压缩包（如openjdk-11.0.20_linux-x64_bin.tar.gz）
2、创建统一Java安装目录：sudo mkdir -p /usr/java
3、解压JDK 11至指定路径：sudo tar -xzf openjdk-11.0.20_linux-x64_bin.tar.gz -C /usr/java/
4、重命名解压目录为jdk-11.0.20，并验证：/usr/java/jdk-11.0.20/bin/java -version应输出openjdk version "11.0.20"
二、获取并校验Jenkins WAR包
绕过麒麟OS软件源中可能滞后的旧版Jenkins，直接采用官方LTS WAR包部署，可精准控制版本并规避yum/apt依赖冲突。校验SHA256哈希值是防止镜像劫持或下载损坏的关键操作。
1、创建专用部署目录：sudo mkdir -p /opt/jenkins
2、进入目录并下载最新LTS版WAR包：cd /opt/jenkins && sudo wget https://mirrors.jenkins.io/war-stable/latest/jenkins.war
3、获取官方发布的SHA256摘要（访问https://www.jenkins.io/changelog-stable/对应版本页），执行：sudo sha256sum jenkins.war
4、比对输出值与官网一致后，方可进入下一步；若不一致，必须删除当前jenkins.war并重新下载
三、配置systemd服务文件实现稳定托管
直接使用nohup启动Jenkins在麒麟OS下易因会话终止、日志丢失或进程失控而失效。通过标准systemd服务单元管理，可保障自动重启、日志归集及权限隔离。
1、创建服务定义文件：sudo vim /usr/lib/systemd/system/jenkins.service
2、写入以下内容（严格替换路径与端口）：[Unit]Description=Jenkins Continuous Integration ServerAfter=network.target[Service]Type=simpleUser=jenkinsGroup=jenkinsEnvironment="JENKINS_HOME=/var/lib/jenkins"Environment="JAVA_HOME=/usr/java/jdk-11.0.20"ExecStart=/usr/java/jdk-11.0.20/bin/java -Djava.awt.headless=true -DJENKINS_HOME=/var/lib/jenkins -jar /opt/jenkins/jenkins.war --httpPort=8080 --webroot=/var/cache/jenkins/warRestart=on-failureRestartSec=10[Install]WantedBy=multi-user.target
3、创建jenkins用户与必要目录：sudo useradd -r -s /bin/false jenkins && sudo mkdir -p /var/lib/jenkins /var/cache/jenkins/war && sudo chown -R jenkins:jenkins /var/lib/jenkins /var/cache/jenkins /opt/jenkins
4、重载服务配置：sudo systemctl daemon-reload
四、放行防火墙端口并初始化服务
麒麟OS默认启用firewalld，若未开放Jenkins监听端口，外部浏览器将无法访问Web界面，导致初始化流程中断。
1、执行永久放行命令：sudo firewall-cmd --add-port=8080/tcp --permanent
2、重载防火墙规则：sudo firewall-cmd --reload
3、启动Jenkins服务：sudo systemctl start jenkins
4、设为开机自启：sudo systemctl enable jenkins
5、检查服务状态：sudo systemctl status jenkins，确认输出中含active (running)且无红色error日志；若失败，立即执行sudo journalctl -u jenkins -n 50 -f排查
五、完成Web端初始化与插件精简安装
Jenkins首次启动后生成初始管理员密码，该密码仅存在于服务器本地文件中。跳过推荐插件全量安装可避免因麒麟OS缺少部分依赖库（如libgdiplus）导致的插件安装卡死或崩溃。
1、提取初始化密码：sudo cat /var/lib/jenkins/secrets/initialAdminPassword
2、在浏览器中访问http://[麒麟服务器IP]:8080，粘贴上述密码解锁
3、在“自定义 Jenkins”页面，务必选择“选择插件来安装”而非“安装推荐的插件”
4、在插件列表中，仅勾选Git、Pipeline、JUnit三项核心插件，取消其余所有勾选
5、点击“安装”后等待完成，随后创建管理员账户并完成实例配置
