centos装jenkins注意什么

在 CentOS 上安装 Jenkins 时，有几个关键点和常见坑需要注意，下面按「系统准备 → 安装 → 配置 → 常见问题」给你梳理一下。

一、系统环境注意事项

1️⃣ 系统版本

CentOS 7 / 8 / Stream 都支持
CentOS 6 不推荐（已 EOL，很多依赖装不了）

2️⃣ Java 版本（非常重要）

Jenkins 对 Java 有明确要求：

Jenkins 版本	推荐 Java
2.346+	Java 11
2.357+	Java 11 / 17
最新版	Java 17（部分支持 21）

⚠️ 不要用 Java 8 装新版本 Jenkins，否则会启动失败

java -version

推荐安装：

yum install -y java-11-openjdk-devel

二、安装方式选择

✅ 推荐方式：官方 yum 源（稳定）

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.key

yum install -y jenkins

⚠️ 不推荐

直接下载 war 包（适合测试，不适合生产）
Docker（除非你很熟，否则权限和网络问题多）

三、启动与防火墙

1️⃣ 启动 Jenkins

systemctl enable jenkins
systemctl start jenkins

2️⃣ 端口

默认端口：8080

firewall-cmd --permanent --add-port=8080/tcp
firewall-cmd --reload

如果云服务器，记得安全组放行 8080

四、初始化注意事项

1️⃣ 初始密码位置

cat /var/lib/jenkins/secrets/initialAdminPassword

2️⃣ 插件安装

新手：选“安装推荐插件”
生产环境：后期再手动装，避免网络失败

⚠️ 国内网络插件可能很慢，可换镜像：

https://mirrors.tuna.tsinghua.edu.cn/jenkins/

五、权限与目录

1️⃣ Jenkins 用户

默认用户：jenkins
家目录：/var/lib/jenkins

不要随便改目录权限：

chown -R jenkins:jenkins /var/lib/jenkins

2️⃣ 构建任务权限

如果 Jenkins 要：

执行 docker
操作 git
部署到服务器

需要把 jenkins 用户加入对应组或配置 sudo

六、常见坑总结 ⚠️

❌ 启动失败

常见原因：

Java 版本不对
端口被占用
/var/lib/jenkins 权限错误

看日志：

journalctl -u jenkins -f

❌ 插件装不上

网络问题
使用国内 Jenkins 镜像

❌ 构建时 git / maven 找不到

Jenkins 不会自动用你 root 的环境
需要在 Jenkins 全局工具里配置

七、生产环境建议

✅ 使用 Nginx 反向代理
✅ 配置 HTTPS
✅ 定期备份 /var/lib/jenkins
✅ 控制插件数量

如果你愿意，可以告诉我：

CentOS 版本
Jenkins 用途（构建 / 部署 / CI）
是否用 Docker / Maven / Git

我可以给你一套更针对性的安装方案。