在Linux服务器上部署Jenkins需先安装OpenJDK 11+,再通过APT/YUM、Docker或WAR包方式安装服务,启动后开放8080端口,访问Web界面输入初始密码完成初始化,安装Git/Pipeline等插件,配置全局工具与凭据,最后通过Jenkinsfile实现代码提交自动构建部署。

Jenkins 在 Linux 服务器上部署,核心是“装对环境、跑稳服务、连得上源、构得出来”。它不是单纯装个软件,而是搭建一条从代码提交到自动上线的流水线。关键不在步骤多,而在每一步是否踩准依赖和权限。
先配好 Java 环境(硬性前提)
Jenkins 是 Java 应用,没 Java 就起不来。2026 年主流版本要求 OpenJDK 11 或更高(推荐 17/21),低于 11 的 JDK 会直接启动失败。
- 检查当前版本:
java -version,输出含11.0.x、17.0.x或21.0.x才合规 - Ubuntu/Debian 安装 OpenJDK 17:
sudo apt update && sudo apt install -y openjdk-17-jdk - CentOS/RHEL/Fedora 安装 OpenJDK 17:
sudo dnf install -y java-17-openjdk-devel - 设为默认 Java(可选但建议):
sudo update-alternatives --config java,选对应版本
选一种安装方式(按场景选)
不推荐手动下载 WAR 包运行(维护难、升级麻烦),优先用包管理器或 Docker。三类方式适用场景不同:
-
APT/YUM 官方源安装:适合生产环境长期运维。自动创建
jenkins用户、服务单元、日志路径,升级方便。Ubuntu 执行添加密钥→加源→apt install jenkins;CentOS 执行导入 key→建 repo→yum/dnf install jenkins -
Docker 运行(推荐新手):隔离性好、无系统污染、一键启停。拉镜像:
docker pull jenkins/jenkins:lts;运行:docker run -d -p 8080:8080 -p 50000:50000 --name jenkins -v /var/jenkins_home:/var/jenkins_home -v /var/run/docker.sock:/var/run/docker.sock jenkins/jenkins:lts(注意挂载宿主机目录和 Docker socket,否则无法构建 Docker 镜像) -
WAR 包方式(仅调试/临时用):下载
jenkins.war,用java -jar jenkins.war --httpPort=8080启动。所有数据默认存在当前用户~/.jenkins,易丢失且权限混乱,不建议用于正式部署
初始化与基础插件配置(开箱即用)
首次访问 http://服务器IP:8080,会提示输入初始管理员密码——它在 /var/lib/jenkins/secrets/initialAdminPassword(APT/YUM 安装)或容器内对应路径(Docker 方式需 docker exec -it jenkins cat /var/jenkins_home/secrets/initialAdminPassword)。
- 勾选“安装推荐的插件”,完成后创建管理员账号
- 进 系统管理 → 插件管理 → 可选插件,搜索并安装:
Git(拉代码)、Pipeline(写流水线脚本)、Configuration as Code(配置即代码,便于备份迁移)、Blue Ocean(可视化流水线界面,更直观) - 进 系统管理 → 全局工具配置,设置 Maven、Gradle、JDK 路径(如使用 Maven 构建,需提前在服务器安装 Maven 并填入
MAVEN_HOME)
对接 Git + 编写 Pipeline 实现自动化(闭环落地)
装完只是开始,真正价值在于让 Jenkins 自动响应代码变更。以 GitHub/Gitee 为例:
- 在 Jenkins 中添加凭据:进入 凭据 → 系统 → 全局凭据 → 添加凭据,类型选
Username with password或SSH Username with private key,填仓库账号或私钥 - 新建 Pipeline 任务,选择“Pipeline script from SCM”,指定 Git URL 和分支(如
main),并在仓库根目录放一个Jenkinsfile - 示例
Jenkinsfile(Spring Boot + Maven):
pipeline {
agent any
stages {
stage('Checkout') {
steps { checkout scm }
}
stage('Build') {
steps { sh 'mvn clean package -DskipTests' }
}
stage('Deploy') {
steps { sh 'scp target/*.jar user@prod-server:/opt/app/' }
}
}
}
保存后点击“立即构建”测试通路;再配置 Webhook(Gitee/GitHub 仓库设置里填 http://服务器IP:8080/github-webhook/ 或 Gitee 对应地址),就能实现“推代码→自动构建→自动部署”。











