在 Ubuntu 上安装 Jenkins 的标准流程
一 准备环境
- 更新系统软件包索引并升级：
- sudo apt update && sudo apt upgrade -y
- 安装 Java（Jenkins 依赖 Java 运行时）。推荐安装 OpenJDK 11（或 OpenJDK 17）：
- sudo apt install openjdk-11-jdk -y
- 如需使用 Java 17：sudo apt install openjdk-17-jdk -y
- 验证 Java 版本：
- java -version
- 输出应显示 11 或 17 的版本信息。
二 安装方式一 APT 官方仓库安装（推荐）
- 导入 Jenkins GPG 密钥（使用 keyring 方式，适配新版 apt）：
- curl -fsSL https://pkg.jenkins.io/debian/jenkins.io.key | sudo tee /usr/share/keyrings/jenkins-keyring.asc > /dev/null
- 添加 Jenkins 官方 APT 源（稳定版）：
- 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
- 更新索引并安装 Jenkins：
- sudo apt update
- sudo apt install jenkins -y
- 说明：旧教程可能使用 apt-key add 直接向可信密钥环导入，新系统更推荐 keyring 方式。
三 安装方式二 WAR 包运行（轻量、快速）
- 下载稳定版 WAR 包：
- wget https://get.jenkins.io/war-stable/latest/jenkins.war
- 创建工作目录并启动（示例将数据目录设为 /opt/jenkins，端口 8080）：
- mkdir -p /opt/jenkins
- export JENKINS_HOME=/opt/jenkins
- nohup java -Xmx2g -jar jenkins.war --httpPort=8080 > /opt/jenkins/jenkins.log 2>&1 &
- 查看日志（获取初始管理员密码或排查问题）：
- tail -f /opt/jenkins/jenkins.log
- 提示：WAR 包方式便于快速试用与容器化，生产环境建议使用系统服务管理。
四 启动服务与防火墙
- 启动并设置开机自启（适用于 APT 安装）：
- sudo systemctl start jenkins
- sudo systemctl enable jenkins
- sudo systemctl status jenkins（确认状态为 active (running)）
- 放行防火墙端口（默认 8080/tcp）：
- UFW：sudo ufw allow 8080/tcp && sudo ufw enable
- firewalld：sudo firewall-cmd --permanent --add-port=8080/tcp && sudo firewall-cmd --reload
- 访问地址：在浏览器打开 http://<服务器IP>:8080。
五 首次启动与安全设置
- 获取初始管理员密码（APT 安装常见路径）：
- sudo cat /var/lib/jenkins/secrets/initialAdminPassword
- WAR 包路径为 $JENKINS_HOME/secrets/initialAdminPassword
- 在浏览器完成初始化：
- 解锁 Jenkins（粘贴初始密码）
- 选择 Install suggested plugins（安装推荐插件）
- 创建管理员用户
- 配置 Jenkins URL（可使用服务器 IP 或域名）
- 常用优化（可选）：
- 更换插件更新源为国内镜像（提升下载速度）：管理 Jenkins → 管理插件 → 高级 → 更新站点 URL 填入：https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json
- 安装中文语言包（可选）：Locale plugin 与 Localization: Chinese (Simplified)，在“系统管理 → 系统配置”将 Locale 设为 zh_CN 并重启页面。