CentOS 上安装 Jenkins 失败的原因通常集中在网络、源、Java 环境、权限、系统版本这几个方面。下面按常见原因给你梳理,并给出排查办法。
Jenkins 必须依赖 Java:
❌ 常见错误:
jenkins: command not found
Failed to start Jenkins
✅ 检查:
java -version
✅ 安装(推荐):
yum install -y java-11-openjdk-devel
CentOS 默认用 yum,但 Jenkins 源在境外。
❌ 症状:
Could not retrieve mirrorlist
Timeout
404 Not Found
✅ 换国内镜像(推荐清华):
sudo tee /etc/yum.repos.d/jenkins.repo <<'EOF'
[jenkins]
name=Jenkins
baseurl=https://mirrors.tuna.tsinghua.edu.cn/jenkins/redhat/
gpgcheck=0
EOF
然后:
yum clean all
yum makecache
❌ 症状:
No package jenkins available
✅ 解决方案:
Jenkins 默认端口:8080
firewall-cmd --add-port=8080/tcp --permanent
firewall-cmd --reload
或临时关闭:
systemctl stop firewalld
查看真实错误:
systemctl status jenkins
journalctl -xe
常见问题:
/var/lib/jenkins 权限不足✅ 修复权限:
chown -R jenkins:jenkins /var/lib/jenkins
Jenkins 启动直接 OOM。
✅ 临时解决:
free -m
加 swap 或升配置。
# 1. 安装 Java
yum install -y java-11-openjdk-devel
# 2. 添加 Jenkins 源
sudo tee /etc/yum.repos.d/jenkins.repo <<'EOF'
[jenkins]
name=Jenkins
baseurl=https://mirrors.tuna.tsinghua.edu.cn/jenkins/redhat/
gpgcheck=0
EOF
# 3. 安装
yum install -y jenkins
# 4. 启动
systemctl enable jenkins
systemctl start jenkins
# 5. 查看状态
systemctl status jenkins
你可以把具体报错信息贴出来,比如:
yum install 的报错systemctl status jenkins 输出journalctl -xe 的关键行我可以直接告诉你是哪一步失败、怎么改。