Linux环境Jenkins 安装配置篇
一、准备工作
-
资源下载（在可联网机器操作）
-
下载 Jenkins 安装包 访问 Jenkins 官网，选择 Generic Java package (.war) 或对应系统的 RPM/DEB 包。 示例：
# 下载jenkins war包 wget https://get.jenkins.io/war-stable/2.426.3/jenkins.war -
下载 JDK 11+ 从 Oracle JDK 或 OpenJDK 下载 Linux 版 JDK（如
jdk-11.0.20_linux-x64_bin.tar.gz）。 -
下载插件及依赖 在 Jenkins 插件市场 下载所需插件（如
git、pipeline）及其依赖，或使用jenkins-plugin-cli批量下载：# 安装插件管理工具（需 Java 环境） wget https://github.com/jenkinsci/plugin-installation-manager-tool/releases/download/2.12.11/jenkins-plugin-manager-2.12.11.jar # 示例：下载 git 插件及其依赖到 plugins 目录 java -jar jenkins-plugin-manager.jar --war /path/to/jenkins.war --plugins git:5.0.0 -d ./plugins
-
-
传输文件到离线机器 使用 U盘、SCP 或内部网络将以下文件传输到目标服务器：
-
jenkins.war或.deb/.rpm包 -
jdk-11.0.20_linux-x64_bin.tar.gz -
plugins/目录（包含所有插件.hpi/.jpi文件）
-
二、安装 Java 环境
# 解压 JDK 到 /usr/local
sudo tar -xzf jdk-11.0.20_linux-x64_bin.tar.gz -C /usr/local/
# 配置环境变量
echo 'export JAVA_HOME=/usr/local/jdk-11.0.20' | sudo tee -a /etc/profile
echo 'export PATH=$JAVA_HOME/bin:$PATH' | sudo tee -a /etc/profile
source /etc/profile
# 验证安装
java -version # 应输出 JDK 11 版本信息三、安装 Jenkins
方式 1：使用 .war 包运行（通用）
# 创建 Jenkins 工作目录
sudo mkdir -p /var/lib/jenkins
# 将 jenkins.war 放到指定路径（如 /opt）
sudo mv jenkins.war /opt/
# 启动 Jenkins（默认端口 8080）
java -jar /opt/jenkins.war --httpPort=8080 --webroot=/var/lib/jenkins/war
# 后台运行（推荐）
nohup java -jar /opt/jenkins.war --httpPort=8080 > /var/log/jenkins.log 2>&1 &方式 2：使用systemctl 启动
#配置systemctl 这里就不详细写了
# 启动服务
sudo systemctl start jenkins
sudo systemctl enable jenkins四、配置 Jenkins
-
初始化解锁 访问
http://<服务器IP>:8080，输入初始密码：#初始密码位置 cat /var/lib/jenkins/secrets/initialAdminPassword -
跳过插件安装 在初始化界面选择 Skip plugin installation（插件已离线准备）。
-
创建管理员账户 填写用户名、密码和邮箱。
-
手动安装插件
-
将
plugins/目录拷贝到 Jenkins 插件目录：cp -r plugins/* /var/lib/jenkins/plugins/ chown -R jenkins:jenkins /var/lib/jenkins/plugins/ -
重启 Jenkins：
# 直接终止进程后重新启动 ps -ef | grep java | grep jenkins| grep -v grep | awk '{print $2}' | xargs kill # 若使用 systemd sudo systemctl restart jenkins
-
五、防火墙配置
# 若服务启动正常，却无法访问可考虑是因为防火墙策略导致
sudo firewall-cmd --permanent --add-port=8080/tcp
sudo firewall-cmd --reload六、验证安装
-
访问
http://<服务器IP>:8080，登录后检查插件是否生效（如 Git、Pipeline）。 -
创建测试任务，验证源码拉取和构建功能。
七、常见问题
-
插件依赖缺失
-
检查
/var/lib/jenkins/plugins/插件名/META-INF/MANIFEST.MF中的依赖列表，补全缺失插件。
-
-
Jenkins 无法启动
-
检查 Java 环境：
java -version -
查看日志：
# 查看日志文件 tail -f /var/log/jenkins.log # systemd可以使用 sudo journalctl -u jenkins # systemd 服务
-
-
端口冲突
-
修改启动参数：
java -jar jenkins.war --httpPort=9090
-
八、附录
-
常用插件列表
-
Git (
git): 集成 Git 仓库 -
Pipeline (
workflow-aggregator): 流水线任务 -
Blue Ocean (
blueocean): 现代化界面 -
Credentials Binding (
credentials-binding): 凭据管理
-
-
资源地址
-
Jenkins 官网：Jenkins
-
插件市场：Jenkins Plugins
-
通过本手册，您可在无外网环境下完成 Jenkins 的完整安装和配置，支持自动化构建与部署。
