Jenkins服务器搭建实操：Linux环境从零部署到验证

在 Linux 服务器上搭建 Jenkins，核心流程只有四步：装好 Java 运行环境、添加 Jenkins 软件源并安装、放行 8080 端口并启动服务、用初始密码完成网页初始化。
只要系统能联网、有 root 或 sudo 权限，半小时内基本可以跑通。
下面按实际操作顺序展开。

先确认服务器条件

Jenkins 是 Java 应用，没有 JDK 或 JRE 就无法启动。
先登录服务器，用一条命令看当前 Java 版本：

java -version

如果提示 command not found，说明需要先装 Java。
Debian/Ubuntu 系统执行：

sudo apt update
sudo apt install -y fontconfig openjdk-17-jre

CentOS/RHEL 系统执行：

yum install -y fontconfig java-17-openjdk

装完再次执行 java -version，能看到版本号输出即通过。
另外确认服务器内存不低于 1GB，低于这个值 Jenkins 容易在启动阶段被系统杀掉进程。

安装 Jenkins 并启动服务

不建议手动下载 war 包长期运行，用系统包管理器安装更利于后续升级。

Debian/Ubuntu 操作步骤：

sudo wget -O /usr/share/keyrings/jenkins-keyring.asc \
  https://pkg.jenkins.io/debian-stable/jenkins.io-2023.key
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 -y jenkins

CentOS/RHEL 操作步骤：

sudo wget -O /etc/yum.repos.d/jenkins.repo \
  https://pkg.jenkins.io/redhat-stable/jenkins.repo
sudo rpm --import https://pkg.jenkins.io/redhat-stable/jenkins.io-2023.key
sudo yum install -y jenkins

安装完成后启动并设为开机自启：

sudo systemctl start jenkins
sudo systemctl enable jenkins
sudo systemctl status jenkins

看到 active (running) 说明服务已经跑起来。
如果状态是 failed，先执行 journalctl -u jenkins -n 50 查看最近日志，多数是 Java 路径或端口冲突导致。

放行端口与完成网页初始化

Jenkins 默认监听 8080 端口。
如果服务器开了防火墙，需要放行：

sudo ufw allow 8080
# 或 CentOS 使用
sudo firewall-cmd --permanent --add-port=8080/tcp
sudo firewall-cmd --reload

浏览器访问 http://服务器IP:8080，会看到解锁页面。
初始密码存放在服务器文件中，执行：

sudo cat /var/lib/jenkins/secrets/initialAdminPassword

把输出的一串字符粘贴到网页输入框，点击继续。
下一步选择“安装推荐的插件”，等待插件下载完成。
如果卡在插件下载，通常是网络访问国外源慢，可以稍后重试或在插件管理中更换镜像源。

插件装完后创建第一个管理员账号，建议不要跳过，否则后续权限管理会很麻烦。
完成后 Jenkins 就可以正常使用了。

几个容易踩的坑

端口被占用：
如果 8080 已被其他程序使用，
可编辑 /etc/default/jenkins（Debian 系）或 /etc/sysconfig/jenkins（RHEL 系），
修改 HTTP_PORT 后重启服务。

Java 版本不兼容：Jenkins 较新版本对 Java 版本有要求，装完启动失败时优先核对 Java 版本是否满足当前 Jenkins 的要求，不要盲目重装。

内存不足：小内存服务器可适当调整 JVM 参数，但要结合实际负载，不要照搬大内存机器的配置。

权限问题：Jenkins 默认以 jenkins 用户运行，如果后续构建脚本要操作某些目录，注意该用户是否有对应读写权限，不要图省事直接改成 root 运行。

验证搭建是否成功

重新访问 http://服务器IP:8080，能正常登录并看到仪表盘，说明搭建完成。
再进入“系统管理”查看节点状态，没有红色告警即基本正常。
此时可以尝试新建一个自由风格任务，执行一条简单 shell 命令，能成功输出结果就证明构建链路是通的。

如果你正在处理 Jenkins 服务器搭建，建议先按本文步骤完整执行，再根据自己的系统版本和网络环境做微调；
遇到异常时优先回看避坑部分和日志输出。