直接用 docker 启动 jenkins 容器最轻量可控，三步完成：拉取官方 lts 镜像（如 jenkins/jenkins:lts）、运行容器并挂载命名卷 jenkins_home、初始化后安装 docker pipeline 等关键插件，再配置 jdk/maven/docker 工具链，最后通过 pipeline 验证各工具版本。
直接用 Docker 启动 Jenkins 容器是最轻量、最可控的方式，不用折腾系统依赖和 Java 环境冲突。核心就三步：拉镜像、跑容器、配插件，全程命令可复现。
拉取并运行 Jenkins 容器
推荐使用官方 LTS 镜像，稳定且长期维护。执行以下命令：
- 拉取镜像：
docker pull jenkins/jenkins:lts（截至 2026 年，最新 LTS 版本为 2.541.3） - 启动容器：
docker run -d -p 8080:8080 -p 50000:50000 \ -v jenkins_home:/var/jenkins_home \ --name jenkins jenkins/jenkins:lts - 首次启动后，用
docker exec jenkins cat /var/jenkins_home/secrets/initialAdminPassword获取初始密码
注意：使用命名卷 jenkins_home 而非绝对路径，更易迁移；若需容器内调用宿主机 Docker（如构建镜像），可加 -v /var/run/docker.sock:/var/run/docker.sock。
完成初始化与关键插件安装
浏览器访问 http://localhost:8080，输入初始密码后进入向导：
- 插件选择阶段，建议先选「Install suggested plugins」快速起步；后续再按需增补
- 必须后续手动安装的插件包括：Docker Pipeline（原生支持 Docker 构建）、Pipeline Utility Steps（解析 YAML/JSON）、Git（源码拉取）、Credentials Binding（安全传密钥）
- 避免插件下载失败：国内用户可进「Manage Jenkins → Plugins → Advanced」，将 Update Site 改为清华或华为镜像源（如
https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json）
配置基础构建能力
Jenkins 要真正干活，得连上外部工具链：
- JDK 配置：进「Manage Jenkins → Global Tool Configuration」→ 添加 JDK，勾选「Install automatically」，选 OpenJDK 17（LTS）或 21（当前主流）
- Maven/Gradle 配置：同页面添加对应工具，也建议自动安装，版本选 3.9.x（Maven）或 8.10+（Gradle）
-
Docker 连接（可选但推荐）：如果构建过程要 build/push 镜像，需在「Manage Jenkins → Configure System → Cloud → Add a new cloud → Docker」中填入
unix:///var/run/docker.sock（容器内已挂载时）
这些配置不是“一次做完就完事”，而是让每个 Pipeline 脚本能通过 tool 'maven-3.9' 或 withDockerRegistry 等语法直接调用。
验证一个最小可用流水线
新建一个 Pipeline 类型任务，写一段极简脚本测试是否打通：
pipeline {
agent any
stages {
stage('Hello') {
steps {
sh 'java -version'
sh 'mvn -version'
sh 'docker --version'
}
}
}
}
保存后立即构建，看控制台输出是否显示各工具版本。全成功，说明环境已就绪；某条报错，就回头检查对应工具配置或容器挂载权限。
