jenkins怎么安装？,jenkins安装与配置教程

Jenkins安装与配置的核心答案：下载官方war包或使用Docker镜像，几行命令即可完成部署，配置重点在于JDK环境、插件源和全局工具链，尤其适合中小团队快速搭建持续集成流水线。

Jenkins安装教程与配置步骤详解

安装前的环境准备

Jenkins本质是一个Java应用，所以第一步永远是准备JDK，行业共识认为，Java版本选择直接影响Jenkins兼容性，目前主流稳定版Jenkins LTS对Java 11或Java 17支持最好，建议不要直接用Java 8跑最新版本,否则启动会报错。

需要准备的环境清单：

• 一台Linux服务器（CentOS 7+/Ubuntu 20.04+）或Windows Server
• JDK 11/17，配置好JAVA_HOME环境变量
• 至少2GB内存，推荐4GB以上，否则构建大型项目容易卡死
• 服务器能访问外网，或能访问内网镜像源

验证JDK是否装好的命令：

java -version

若输出类似openjdk version "17.0.8"就说明环境没问题，如果服务器之前装过多个Java版本，务必手动指定JAVA_HOME,否则Jenkins可能识别错环境。

Jenkins安装的三种主流方式

业内专家指出，不同场景下的安装方式选择，直接决定后续维护成本，这里列出三种最常见的做法,并做对比。

安装方式	优点	缺点	适合场景
war包部署到Tomcat	复用已有中间件，管理习惯统一	需另装Tomcat，配置稍繁琐	已有Tomcat运维体系的团队
Docker运行	环境隔离，升级回滚方便	数据卷和权限需额外处理	云服务器或容器化环境
原生包（rpm/deb）	安装简单，开机自启	依赖系统JDK版本	单机快速验证

war包部署（最通用）

先去Jenkins官网下载jenkins.war，然后放进Tomcat的webapps目录，启动Tomcat后，访问http://服务器IP:8080/jenkins即可。

如果用独立方式运行war包,可以这样启动：

java -jar jenkins.war --httpPort=8080

首次启动后，控制台日志会输出一串初始管理员密码，路径一般在/var/lib/jenkins/secrets/initialAdminPassword

，接着访问http://IP:8080,输入密码解锁。

Docker安装（最轻量）

如果你正在找jenkins安装docker的具体步骤,下面这套命令可以直接复制：

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

挂载目录jenkins_home是数据卷，容器删了数据也不丢，50000端口是Jenkins agent的JNLP通信端口，如果只跑本机构建不开agent,可以去掉。

系统包安装（最省心）

Ubuntu下直接：

curl -fsSL https://pkg.jenkins.io/debian/jenkins.io-2026.key | sudo tee /usr/share/keyrings/jenkins-keyring.asc > /dev/null
echo deb [signed-by=/usr/share/keyrings/jenkins-keyring.asc] https://pkg.jenkins.io/debian binary/ | sudo tee /etc/apt/sources.list.d/jenkins.list > /dev/null
sudo apt update
sudo apt install jenkins

安装完成后会自动注册为systemd服务，用systemctl start jenkins启动就行。

Jenkins配置Java环境与全局工具链

安装只是开始，配置才是让Jenkins真正干活的关键，很多人在jenkins配置java环境这一步踩坑，因为构建Java项目需要单独的JDK/Maven,而不是Jenkins自带的那个。

全局工具配置入口

进入系统管理 -> 全局工具配置,在这里添加：

• JDK：勾选”自动安装”，选择JDK版本，Oracle账号问题可以改用AdoptOpenJDK或OpenJDK镜像
• Maven：指定版本例如3.9.x，自动从Apache镜像下载
• Git：如果系统已安装，直接填路径/usr/bin/git

保存后，新建构建任务时选择源码管理Git，再构建一个简单项目测试,就能确认工具链是否打通。

汉化配置与界面优化

很多国内团队第一步就需要jenkins汉化配置，在插件管理 -> 可选插件里搜索”Localization: Chinese (Simplified)”，安装后重启即可，注意新版Jenkins汉化插件不再和旧版兼容，记得勾选”兼容更新”选项。

界面优化建议：

• 在系统管理 -> 系统配置中设置Jenkins URL为外网可访问地址
• 调整构建队列线程数，默认2个可以改成4个
• 关闭CSRF保护如果内网无安全要求，或者配置反向代理时一并解决

Jenkins安装完成后的初始化配置

插件安装策略

解锁Jenkins后会进入插件安装向导，对于新项目，推荐选择”安装推荐的插件”，包含Git、JDK、Email Extension等基础插件，如果网络慢，可以先把插件管理 -> 高级中的升级站点URL改为国内镜像,例如清华大学镜像源。

常用的插件清单：

• Pipeline：流水线核心，必装
• Blue Ocean：可视化构建过程，新手友好
• Docker Pipeline：在流水线中调用docker命令
• Harbor/GitLab插件：和私有代码仓库集成

用户权限与安全配置

系统管理 -> 全局安全配置中，建议关闭”允许用户注册”，启用”Logged-in users can do anything”（小型团队内部使用），如果团队超过十人,应该用插件实现角色权限分离。

安全配置检查项：

• 确保管理员的初始密码已修改
• 开启Jenkins访问日志，便于审计
• 定期备份JENKINS_HOME目录，特别是config.xml和jobs/文件夹

Jenkins持续集成部署的实操流程

创建一个自由风格项目

在Dashboard首页点击”新建任务”，输入项目名称后选择”自由风格软件项目”,配置要点：

• General：填写项目描述，开启”丢弃旧的构建”保留最近10次
• 源码管理：选Git，填仓库地址，如果私有仓库需要添加凭据
• 构建触发器：勾选”Poll SCM”，每分钟检测代码变化
• 构建环境：勾选”Delete workspace before build start”
• 构建步骤：调用Maven执行clean package -DskipTests

保存后点击”立即构建”，控制台输出显示BUILD SUCCESS就完成了第一个构建。

使用Pipeline脚本与Jenkinsfile

比自由风格更现代的是Pipeline方式，在项目配置中选择”Pipeline script from SCM”，仓库根目录放一个Jenkinsfile,下面是一个简单的声明式流水线示例：

pipeline {
    agent any
    stages {
        stage('Checkout') {
            steps { git url: 'https://your-repo.git' }
        }
        stage('Build') {
            steps { sh 'mvn clean package' }
        }
        stage('Deploy') {
            steps { sh 'scp target/.jar user@server:/app/' }
        }
    }
}

这种写法让构建流程版本化,后续维护和review都很方便。

Jenkins安装过程中的常见问题与解决

端口冲突怎么办

如果8080已经被占用，Linux下用lsof -i:8080找到进程，杀掉或者换端口，war包启动时用--httpPort=9090即可,Docker方式则把映射改掉。

启动速度慢或卡住

很多情况下是插件安装失败导致，查看日志/var/log/jenkins/jenkins.log，如果是下载插件超时，就去镜像站手动下载对应的.hpi文件，放到/usr/lib/jenkins/plugins/目录后重启。

忘记管理员密码

直接编辑JENKINS_HOME/users/admin/config.xml，将passwordHash对应的加密串替换为空，重启后用空白密码登录，再重新设置,具体命令：

sed -i 's|<passwordHash>.</passwordHash>|<passwordHash></passwordHash>|' /var/lib/jenkins/users/admin/config.xml
systemctl restart jenkins

Jenkins安装与配置的常见问题解答

问：Jenkins安装后一直显示离线状态怎么办

这是因为插件管理默认从官方源下载，国内网络经常连不上，进入系统管理 -> 插件管理 -> 高级，把升级站点URL改成https://mirrors.tuna.tsinghua.edu.cn/jenkins/update-center/update-center.json，保存后等待十分钟左右,再刷新页面就能正常在线安装插件。

问：Jenkins配置了JDK但构建还是找不到Java

如果全局工具配置已添加JDK，但仍报Java找不到，先确认构建任务是否选择了正确的JDK，进入任务配置页面，在”JDK”下拉框选择你添加的版本，另外用系统包安装的Jenkins，服务脚本可能没有读取全局JAVA_HOME，编辑/etc/sysconfig/jenkins，加入JAVA_HOME=$(dirname $(dirname $(readlink -f $(which java)))),重启服务即可。

问：Jenkins持续集成部署时如何自动化执行脚本

可以在构建步骤中选择”执行shell”，在输入框里直接写sh deploy.sh；更推荐用Pipeline的sh步骤，如果目标服务器是远程的，需要先在Jenkins的”凭据”中添加SSH私钥，然后用ssh user@host 'bash -s' < local_script.sh方式传递脚本，多节点部署时，使用publish over ssh插件批量发送构建产物并远程执行命令,这是目前最主流的做法。