Jenkins Linux版如何启动

Linux 上启动 Jenkins 的常用方式

一 前置检查

• 确认已安装 Java（推荐 OpenJDK 11 或更高版本）：执行 java -version 查看版本。若未安装，可先安装 OpenJDK 11 再继续后续步骤。

二 方式一 系统服务启动 Debian 或 Ubuntu

• 安装（如尚未安装）：导入密钥与仓库后安装包
  • wget -q -O - https://pkg.jenkins.io/debian-stable/jenkins.io.key | sudo gpg --dearmor -o /usr/share/keyrings/jenkins-keyring.asc
  • echo "deb [signed-by=/usr/share/keyrings/jenkins-keyring.asc] https://pkg.jenkins.io/debian-stable binary/" | sudo tee /etc/apt/sources.list.d/jenkins.list > /dev/null
  • sudo apt-get update && sudo apt-get install jenkins -y
• 启动与开机自启
  • sudo systemctl start jenkins
  • sudo systemctl enable jenkins
  • sudo systemctl status jenkins（看到 active (running) 即为成功）
• 首次访问与解锁
  • 浏览器访问：http://服务器IP:8080
  • 初始管理员密码：sudo cat /var/lib/jenkins/secrets/initialAdminPassword
  • 按向导完成插件安装与管理员设置。

三 方式二 系统服务启动 RHEL 或 CentOS

• 安装（如尚未安装）：导入仓库并安装
  • 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.key
  • sudo yum upgrade
  • sudo yum install epel-release java-11-openjdk-devel -y
  • sudo yum install jenkins -y
• 启动与开机自启
  • sudo systemctl daemon-reload
  • sudo systemctl start jenkins
  • sudo systemctl enable jenkins
  • sudo systemctl status jenkins
• 访问与解锁：同方式一（默认端口 8080，解锁文件位于 /var/lib/jenkins/secrets/initialAdminPassword）。

四 方式三 直接运行 WAR 包

• 准备与启动
  • 下载 WAR 包：wget https://get.jenkins.io/war-stable/latest/jenkins.war
  • 前台运行：java -jar jenkins.war（默认端口 8080）
  • 指定端口：java -jar jenkins.war --httpPort=9090
  • 后台运行：nohup java -jar jenkins.war --httpPort=8080 > jenkins.log 2>&1 &
• 自定义 JENKINS_HOME（可选）
  • 临时：JENKINS_HOME=/data/jenkins java -jar jenkins.war
  • 永久：在环境变量中设置 JENKINS_HOME 后再启动
• 访问：http://服务器IP:8080（或自定义端口），首次解锁密码路径为 $JENKINS_HOME/secrets/initialAdminPassword。

五 常见问题与排查

• 端口冲突：修改配置文件中的 HTTP_PORT（如 /etc/default/jenkins 或 /etc/sysconfig/jenkins），将 8080 改为未占用端口，然后重启服务 sudo systemctl restart jenkins。
• 查看日志定位问题
  • systemd 部署：sudo journalctl -u jenkins -f
  • WAR 后台运行：tail -f jenkins.log
• 云服务器访问不通：在云厂商安全组与系统防火墙放行对应端口（如 8080/9090）。
• 插件安装慢或失败：在 Manage Jenkins > Manage Plugins > Advanced 将 Update Site 改为 https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json。