以下步骤基于 Ubuntu 24.04 系统，全程采用 Docker 容器化部署，兼顾数据持久化、端口可用性和操作便捷性，适合新手和生产环境快速部署。

一、前置条件：安装 Docker 环境

Ubuntu 24 系统默认未安装 Docker，需先完成 Docker 官方版安装（一键脚本方式，简单高效）：

# 下载并执行 Docker 官方一键安装脚本curl -fsSL https://get.docker.com -o get-docker.shsudo sh get-docker.sh# （可选）将当前用户加入 docker 组，避免后续执行 docker 命令需 sudosudo usermod -aG docker $USER# 生效组配置（需重新登录终端或重启系统）newgrp docker

验证 Docker 安装成功：

docker --version# 输出类似 Docker version 26.0.0, build 2ae903e 即表示成功

二、创建 Jenkins 数据卷（核心：数据持久化）

Docker 容器默认数据存储在容器内部，容器删除后数据会丢失，因此必须创建独立的 Docker 数据卷挂载到 Jenkins 容器，实现配置、插件、项目数据的持久化：

# 创建名为 jenkins-data 的 Docker 数据卷（名称可自定义）docker volume create jenkins-data

查看数据卷信息（确认创建成功）：

docker volume inspect jenkins-data

三、拉取 Jenkins 官方 LTS 镜像

推荐使用LTS（长期支持版），稳定性更高，适配生产环境：

# 拉取 Jenkins 官方 LTS 最新版镜像docker pull jenkins/jenkins:lts

拉取完成后，查看本地镜像：

docker images# 输出中能看到 jenkins/jenkins:lts 即表示拉取成功

四、创建并启动 Jenkins 容器

通过 docker run 命令创建容器，核心参数包含端口映射、数据卷挂载、开机自启等，执行以下命令：

docker run -d \  --name jenkins \  --restart always \  -p 8080:8080 \  -p 50000:50000 \  -v jenkins-data:/var/jenkins_home \  --user root \  jenkins/jenkins:lts

命令参数说明

• -d：后台运行容器；
• --name jenkins：指定容器名称为 jenkins（方便后续管理）；
• --restart always：容器随 Docker 开机自启，避免服务器重启后 Jenkins 失效；
• -p 8080:8080：端口映射，主机 8080 端口对应容器内 Jenkins Web 访问端口；
• -p 50000:50000：端口映射，主机 50000 端口对应容器内 Jenkins 代理节点通信端口（必备，否则无法添加从节点）；
• -v jenkins-data:/var/jenkins_home：数据卷挂载，将之前创建的 jenkins-data 卷挂载到容器内 Jenkins 核心数据目录 /var/jenkins_home，实现数据持久化；
• --user root：以 root 权限运行容器，避免后续插件安装、文件操作出现权限不足问题；
• jenkins/jenkins:lts：使用的镜像名称（LTS 版）。

验证容器启动成功

# 查看容器运行状态docker ps# 输出中 jenkins 容器状态为 Up 即表示启动成功

五、获取 Jenkins 初始管理员密码

Jenkins 首次启动后会生成随机初始密码，需通过该密码完成首次登录，执行以下命令直接查看初始密码：

docker exec jenkins cat /var/jenkins_home/secrets/initialAdminPassword

备用方式（复制密码文件到本地查看）

若上述命令执行异常，可将密码文件复制到 Ubuntu 主机本地后查看：

# 将容器内密码文件复制到主机当前目录docker cp jenkins:/var/jenkins_home/secrets/initialAdminPassword ./# 查看本地密码文件内容cat initialAdminPassword

执行后会输出一串 32 位的随机字符串（如 1234567890abcdef1234567890abcdef），保存该字符串，用于后续登录。

六、Jenkins 首次访问与初始化配置

1. 访问 Jenkins Web 界面

在浏览器中输入 Ubuntu 主机的 IP 地址 + 8080 端口，格式：

http://你的Ubuntu主机IP:8080

（若在本机操作，可输入 http://localhost:8080）

2. 输入初始密码完成验证

在页面的「Administrator password」输入框中，粘贴上一步获取的 32 位初始密码，点击「Continue」。

3. 安装推荐插件

验证通过后，进入插件安装页面，选择 **「Install suggested plugins」（安装推荐插件）**，等待插件自动安装完成（全程无需手动操作，网络较慢时耐心等待）。

推荐插件包含版本控制（Git/SVN）、构建工具（Maven/Gradle）、常用流水线插件等，满足基础使用需求。

4. 创建管理员账户

插件安装完成后，进入管理员账户创建页面，填写：

• 用户名（如 admin）；
• 密码（自定义，建议复杂密码）；
• 确认密码；
• 全名、邮箱（可选）；

填写完成后点击「Save and Continue」，完成管理员账户创建（后续登录将使用该账户，替代初始密码）。

5. 完成初始化

最后一步确认 Jenkins 访问地址（保持默认的 http://你的IP:8080/ 即可），点击「Save and Finish」，再点击「Start using Jenkins」，即可进入 Jenkins 主界面，完成全部初始化。

七、Jenkins 容器后续常用操作

部署完成后，日常维护可使用以下命令管理 Jenkins 容器：

# 启动 Jenkins 容器docker start jenkins# 停止 Jenkins 容器docker stop jenkins# 重启 Jenkins 容器（插件安装后需重启生效）docker restart jenkins# 查看 Jenkins 运行日志（排查启动/运行问题）docker logs -f jenkins

总结

本次 Ubuntu 24 下 Docker 安装 Jenkins 的核心步骤可概括为：

1. 安装 Docker 环境（官方一键脚本）；
2. 创建 Docker 数据卷（jenkins-data）实现数据持久化，避免容器丢失导致数据损坏；
3. 拉取 Jenkins LTS 稳定版镜像，通过 docker run 创建容器，核心配置8080/50000 端口映射和数据卷挂载；
4. 经 docker exec 快速获取初始密码，完成浏览器端首次登录和初始化；
5. 掌握 start/stop/restart 等容器日常管理命令，满足后续维护需求。

部署完成后，Jenkins 已实现开机自启、数据持久化、权限无限制，可直接进行插件安装、项目配置、流水线搭建等后续操作。