在腾讯云轻量应用服务器上安装 Jenkins 是一个常见的 DevOps 实践,适用于自动化构建、测试和部署。以下是详细的步骤指导,帮助你在腾讯云轻量应用服务器(Ubuntu 系统为例)上成功安装并运行 Jenkins。
✅ 前提条件
- 已购买腾讯云轻量应用服务器(建议配置至少 2GB 内存,Jenkins 对内存有一定要求)
- 操作系统:Ubuntu 20.04 / 22.04 LTS(推荐)
- 已开放相应端口:
- 在腾讯云控制台的「防火墙」中放行 8080 端口(Jenkins 默认端口)
- 可选:放行 SSH(22)、HTTP(80)、HTTPS(443)
📦 步骤一:更新系统并安装 Java
Jenkins 是基于 Java 的应用,需要先安装 JDK。
sudo apt update
sudo apt upgrade -y
安装 OpenJDK 17(Jenkins 推荐版本):
sudo apt install openjdk-17-jdk -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)
📦 步骤二:添加 Jenkins 仓库并安装
- 导入 Jenkins GPG 密钥:
wget -q -O - https://pkg.jenkins.io/debian-stable/jenkins.io.key | sudo gpg --dearmor -o /usr/share/keyrings/jenkins.gpg
- 添加 Jenkins 仓库到 sources.list.d:
echo "deb [signed-by=/usr/share/keyrings/jenkins.gpg] https://pkg.jenkins.io/debian-stable binary/" | sudo tee /etc/apt/sources.list.d/jenkins.list
- 更新包索引并安装 Jenkins:
sudo apt update
sudo apt install jenkins -y
⚙️ 步骤三:启动 Jenkins 服务
sudo systemctl enable jenkins
sudo systemctl start jenkins
查看状态:
sudo systemctl status jenkins
如果显示 active (running),说明已成功启动。
🔐 步骤四:获取初始管理员密码
Jenkins 首次启动后会生成一个初始管理员密码:
sudo cat /var/lib/jenkins/secrets/initialAdminPassword
复制输出的密码(32位字符串),稍后用于 Web 初始化。
🔌 步骤五:配置防火墙(腾讯云控制台)
登录 腾讯云轻量应用服务器控制台:
- 进入你的实例详情页
- 找到「防火墙」设置
- 添加规则,允许 TCP 8080 端口(来源 IP 可设为
0.0.0.0/0或你自己的 IP)
注意:不要在系统防火墙(如 ufw)中阻止 8080,除非你明确配置了。
🌐 步骤六:访问 Jenkins Web 界面
在浏览器中访问:
http://<你的服务器公网IP>:8080
例如:
http://123.45.67.89:8080
等待页面加载,输入刚才获取的 初始管理员密码。
🛠️ 步骤七:完成 Jenkins 初始化设置
- 选择插件安装方式:
- 推荐选择 “Install suggested plugins”(安装推荐插件)
- 创建第一个管理员用户(建议记录用户名密码)
- 设置 Jenkins URL(可使用默认
http://<IP>:8080)
完成设置后即可进入 Jenkins 主界面。
✅ 可选优化建议
-
配置域名 + Nginx 反向X_X(可选)
- 使用 Nginx 将 80/443 映射到 8080
- 配置 HTTPS(Let’s Encrypt 免费证书)
-
增加交换空间(Swap)
轻量服务器内存小,可添加 Swap 防止 OOM:sudo fallocate -l 2G /swapfile sudo chmod 600 /swapfile sudo mkswap /swapfile sudo swapon /swapfile echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab -
定期备份
/var/lib/jenkins目录
❌ 常见问题排查
| 问题 | 解决方法 |
|---|---|
访问 8080 页面无法打开 |
检查腾讯云防火墙是否放行 8080 |
| Jenkins 启动失败 | 查看日志 sudo journalctl -u jenkins |
| Java 版本不兼容 | 确保使用 Java 17 或以上 |
| 初始密码为空 | 等待 Jenkins 首次启动完成(首次启动较慢) |
🎉 总结
你已经成功在腾讯云轻量应用服务器上部署了 Jenkins!现在可以开始创建任务、集成 Git、配置 CI/CD 流水线等操作。
如需进一步集成(如 GitHub Webhook、Docker 构建、Kubernetes 部署),欢迎继续提问!
📌 提示:轻量服务器性能有限,建议仅用于学习或小型项目。生产环境建议使用标准 CVM 并做高可用部署。
轻量云Cloud