在腾讯云轻量应用服务器上安装 Jenkins 是一个常见需求,尤其适用于 CI/CD 自动化部署。以下是详细的安装步骤(以 Ubuntu 系统为例):
✅ 前提条件
- 腾讯云轻量应用服务器已创建(推荐 Ubuntu 20.04/22.04)
- 已通过 SSH 登录服务器
- 服务器开放了所需端口(默认 Jenkins 使用 8080)
🔧 步骤 1:更新系统包
sudo apt update && sudo apt upgrade -y
🔧 步骤 2:安装 Java(Jenkins 依赖)
Jenkins 需要 Java 环境,推荐使用 OpenJDK 17 或 11。
sudo apt install openjdk-17-jre -y
验证安装:
java -version
输出应类似:
openjdk version "17.0.8" 2023-07-18
OpenJDK Runtime Environment (build 17.0.8+7-Ubuntu-1ubuntu1)
OpenJDK 64-Bit Server VM (build 17.0.8+7-Ubuntu-1ubuntu1, mixed mode)
🔧 步骤 3:添加 Jenkins 官方仓库并安装
- 导入 Jenkins GPG 密钥:
curl -fsSL https://pkg.jenkins.io/debian-stable/jenkins.io-2023.key | sudo tee
/usr/share/keyrings/jenkins-keyring.asc > /dev/null
- 添加 Jenkins 仓库到 sources.list:
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
- 更新包索引并安装 Jenkins:
sudo apt update
sudo apt install jenkins -y
🔧 步骤 4:启动 Jenkins 服务
sudo systemctl enable jenkins
sudo systemctl start jenkins
检查状态:
sudo systemctl status jenkins
🔧 步骤 5:配置防火墙(开放 8080 端口)
腾讯云轻量服务器需要在 控制台 配置安全组规则:
- 登录 腾讯云轻量应用服务器控制台
- 找到你的实例
- 进入「防火墙」设置
- 添加规则:
- 协议:TCP
- 端口:8080
- 源 IP:0.0.0.0/0(或限制为你的 IP)
- 描述:Jenkins
⚠️ 注意:开放 8080 后,可通过
http://<服务器公网IP>:8080访问
🔧 步骤 6:初始化 Jenkins
- 打开浏览器访问:
http://<你的服务器公网IP>:8080
- 首次启动会要求输入初始管理员密码:
sudo cat /var/lib/jenkins/secrets/initialAdminPassword
复制输出的密码,粘贴到网页中。
-
选择「安装推荐的插件」,等待安装完成。
-
设置管理员账户(建议记录用户名和密码)。
-
设置 Jenkins URL(默认即可,如
http://<IP>:8080/)
✅ 可选优化
1. 使用 Nginx 反向X_X(绑定域名 + HTTPS)
安装 Nginx:
sudo apt install nginx -y
配置反向X_X(示例 /etc/nginx/sites-available/jenkins):
server {
listen 80;
server_name jenkins.yourdomain.com;
location / {
proxy_pass http://127.0.0.1:8080;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}
启用站点并重启 Nginx:
sudo ln -s /etc/nginx/sites-available/jenkins /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl restart nginx
再通过腾讯云 DNS 解析域名,并可使用 Let’s Encrypt 配置 HTTPS。
🛠 常见问题排查
| 问题 | 解决方法 |
|---|---|
| 无法访问 8080 | 检查腾讯云防火墙是否放行 |
| Jenkins 启动失败 | 查看日志 sudo journalctl -u jenkins |
| Java 版本不兼容 | 确保使用 Java 11 或 17 |
| 插件安装慢 | 更换 Jenkins 插件源(修改 /var/lib/jenkins/hudson.model.UpdateCenter.xml) |
✅ 总结
你已经成功在腾讯云轻量服务器上部署 Jenkins,可用于:
- 自动构建项目(Maven、Node.js、Python 等)
- 持续集成与部署(CI/CD)
- 配合 Git、Docker、K8s 使用
如需进一步配置(如对接 GitHub Webhook、构建 Docker 镜像等),可以继续扩展 Jenkins 插件和流水线脚本。
需要我提供 Jenkinsfile 示例或自动化部署脚本吗?欢迎继续提问!
云服务器