如何在 Ubuntu 22.04 LTS 上部署 Jenkins 自动化服务器？
1. 环境准备：搭建Jenkins的基石
在Ubuntu 22.04上部署Jenkins前，我们需要先准备好运行环境。Jenkins作为Java应用，对运行环境有特定要求，就像盖房子前需要打好地基一样。我去年在给一家电商公司部署CI/CD系统时，就遇到过因环境配置不当导致Jenkins频繁崩溃的问题，后来发现是Java版本不兼容导致的。
首先确保你的系统是最新的。打开终端执行：
sudo apt update && sudo apt upgrade -yJava环境是Jenkins运行的核心依赖。虽然OpenJDK 8也能运行，但实测在Ubuntu 22.04上使用OpenJDK 11或17性能更稳定。安装命令如下：
sudo apt install openjdk-11-jdk -y验证Java版本（关键步骤别跳过）：
java -version # 应该看到类似输出： # openjdk version "11.0.20.1" 2023-08-24对于生产环境，我强烈建议单独创建一个Jenkins运行用户，而不是直接使用root。这样可以有效隔离权限：
sudo useradd -r -m -U -d /var/lib/jenkins -s /bin/bash jenkins注意：如果系统已有其他Java版本，可以用
sudo update-alternatives --config java切换默认版本。我在客户现场就遇到过三个Java版本共存导致环境混乱的情况。
2. 安装Jenkins：两种实战方案对比
Jenkins官方提供了多种安装方式，这里我推荐通过官方仓库安装，比直接下载war包更便于后续维护。去年帮一个游戏工作室部署时，他们最初用war包部署，结果插件依赖问题折腾了两天。
方案一：官方仓库安装（推荐）
curl -fsSL https://pkg.jenkins.io/debian-stable/jenkins.io-2023.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-stable binary/" | sudo tee \ /etc/apt/sources.list.d/jenkins.list > /dev/null sudo apt update sudo apt install jenkins -y方案二：Docker方式（适合快速测试）
sudo apt install docker.io -y sudo systemctl enable --now docker sudo docker run -d -p 8080:8080 -p 50000:50000 \ -v jenkins_home:/var/jenkins_home jenkins/jenkins:lts-jdk11安装完成后启动服务：
sudo systemctl enable --now jenkins检查状态时我习惯用这个命令组合：
sudo systemctl status jenkins --no-pager -l # 看到"Active: active (running)"才算成功3. 防火墙与网络配置实战
Ubuntu 22.04默认使用ufw防火墙，但很多新手容易在这里踩坑。上周还有个学员问我为什么Jenkins页面打不开，结果发现是防火墙没配置。
放行默认端口（8080是Web界面，50000是Agent通信）：
sudo ufw allow 8080/tcp sudo ufw allow 50000/tcp sudo ufw enable如果使用云服务器（比如AWS/Azure），还需要在安全组中放行这些端口。曾经有个客户在阿里云上折腾半天，最后发现是安全组没配置。
验证端口监听状态：
ss -tulnp | grep jenkins # 应该看到： # tcp LISTEN 0 50 *:8080 *:* users:(("java",pid=1234,fd=123))重要提示：生产环境强烈建议用Nginx反代并配置HTTPS。可以用
sudo apt install nginx安装后，在/etc/nginx/sites-available/下添加配置。
4. 初始化配置与安全加固
现在打开浏览器访问http://your-server-ip:8080，会看到解锁界面。获取初始密码：
sudo cat /var/lib/jenkins/secrets/initialAdminPassword插件安装是个技术活：
- 新手建议先安装推荐插件
- 老手可以选自定义，我通常会额外勾选：
- Pipeline
- Blue Ocean
- Git
- Docker
创建管理员账户时，千万别用弱密码！去年有家公司的Jenkins被入侵，就是因为用了admin/123456这种密码。建议用密码管理器生成复杂密码。
完成基础配置后，立即做这几件事：
进入"Manage Jenkins" → "Security"：
- 启用矩阵权限（Matrix-based security）
- 禁止匿名用户执行任何操作
配置CSRF防护：
sudo sed -i 's/<useCrumbs>false<\/useCrumbs>/<useCrumbs>true<\/useCrumbs>/g' \ /var/lib/jenkins/config.xml sudo systemctl restart jenkins设置自动备份（避免血泪教训）：
sudo apt install rsync -y mkdir -p /backups/jenkins crontab -e # 添加：0 3 * * * rsync -a /var/lib/jenkins /backups/jenkins
5. 生产环境优化技巧
经过上百次部署经验，我总结出这些优化项能让Jenkins更稳定：
内存调优（/etc/default/jenkins）：
JAVA_ARGS="-Xms1g -Xmx2g -XX:MaxRAMPercentage=70.0"日志轮转（防止磁盘爆满）：
sudo tee /etc/logrotate.d/jenkins <<EOF /var/log/jenkins/*.log { daily missingok rotate 30 compress delaycompress notifempty create 0640 jenkins jenkins } EOF定期清理构建记录（在Jenkins脚本控制台执行）：
import hudson.model.* import jenkins.model.Jenkins Jenkins.instance.getAllItems(Job.class).each { job -> if(job.builds.number > 50) { job.builds.findAll { it.number <= job.builds.number - 50 }.each { it.delete() } } }对于团队协作场景，建议配置LDAP或OAuth集成。最近给一个20人团队部署时，用GitLab OAuth节省了大量账号管理时间。
6. 常见问题排错指南
问题1：Jenkins启动失败检查日志最有效：
journalctl -u jenkins -b --no-pager -n 50常见原因：
- Java版本不对（装11或17）
- 端口冲突（netstat -tulnp查看）
- 权限问题（chown -R jenkins:jenkins /var/lib/jenkins）
问题2：插件安装超时修改更新中心地址：
sudo sed -i 's/https:\/\/updates.jenkins.io\/update-center.json/https:\/\/mirrors.tuna.tsinghua.edu.cn\/jenkins\/updates\/update-center.json/g' \ /var/lib/jenkins/hudson.model.UpdateCenter.xml问题3：构建卡住检查节点状态：
curl -s http://localhost:8080/computer/api/json | jq .busyExecutors如果是内存不足，可以增加交换空间：
sudo fallocate -l 2G /swapfile sudo chmod 600 /swapfile sudo mkswap /swapfile sudo swapon /swapfile最后提醒：每次升级前一定要备份！有次我没备份就升级，结果插件全部不兼容，只能重装。现在我的习惯是：
sudo apt update sudo systemctl stop jenkins rsync -a /var/lib/jenkins{,.bak} sudo apt install --only-upgrade jenkins