在腾讯云轻量应用服务器上安装 Jenkins 是一个常见且实用的操作,适用于自动化构建、测试和部署。以下是详细的安装步骤(以 Ubuntu 系统为例):
✅ 一、准备工作
-
登录腾讯云轻量应用服务器
- 使用 SSH 登录你的轻量服务器:
ssh root@<你的服务器公网IP>
- 使用 SSH 登录你的轻量服务器:
-
更新系统包
sudo apt update && sudo apt upgrade -y -
安装 Java(Jenkins 依赖)
Jenkins 需要 Java 运行环境,推荐安装 OpenJDK 11 或 17。sudo apt install openjdk-11-jdk -y验证 Java 是否安装成功:
java -version输出应类似:
openjdk version "11.0.20" 2023-04-18
✅ 二、安装 Jenkins
-
添加 Jenkins 官方仓库密钥
wget -q -O - https://pkg.jenkins.io/debian-stable/jenkins.io.key | sudo gpg --dearmor -o /usr/share/keyrings/jenkins-keyring.gpg -
添加 Jenkins 仓库到 sources.list.d
echo "deb [signed-by=/usr/share/keyrings/jenkins-keyring.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 start jenkins
sudo systemctl enable jenkins
检查状态:
sudo systemctl status jenkins
看到 active (running) 表示启动成功。
✅ 四、配置防火墙(安全组)
-
腾讯云控制台配置安全组
- 登录 腾讯云轻量应用服务器控制台
- 找到你的实例,进入「防火墙」或「安全组」设置
- 添加规则,放行 端口 8080(Jenkins 默认端口)
- 协议:TCP
- 端口:8080
- 源 IP:0.0.0.0/0(或限制为你的 IP)
-
(可选)如果服务器本地有 ufw 防火墙,也放行端口
sudo ufw allow 8080
✅ 五、访问 Jenkins Web 界面
打开浏览器,访问:
http://<你的服务器公网IP>:8080
首次访问会提示你输入初始管理员密码。
-
查看初始密码:
sudo cat /var/lib/jenkins/secrets/initialAdminPassword -
复制该密码,粘贴到网页中。
-
选择「安装推荐的插件」或「自定义」,建议新手选推荐插件。
-
设置管理员账号(建议记录好用户名和密码)。
-
设置 Jenkins URL(通常默认即可)。
✅ 六、(可选)配置 Nginx 反向X_X + 域名 + HTTPS
如果你有域名,可以配置 Nginx 反向X_X,实现通过域名访问(如 jenkins.yourdomain.com),并启用 HTTPS。
示例 Nginx 配置:
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;
}
}
然后使用 Certbot 配置 HTTPS:
sudo apt install certbot python3-certbot-nginx -y
sudo certbot --nginx -d jenkins.yourdomain.com
✅ 七、常见问题排查
| 问题 | 解决方法 |
|---|---|
无法访问 8080 端口 |
检查腾讯云安全组是否放行 8080 |
| Jenkins 启动失败 | 检查 sudo journalctl -u jenkins 日志 |
| Java 未安装 | 确保 java -version 有输出 |
| 初始密码找不到 | 检查 /var/lib/jenkins/secrets/initialAdminPassword |
✅ 八、后续建议
- 定期备份
/var/lib/jenkins目录(包含所有配置和构建历史) - 安装常用插件:Git、Pipeline、SSH、Credentials Binding 等
- 使用 Webhook 实现 GitHub/GitLab 自动触发构建
✅ 完成!你现在已经在腾讯云轻量服务器上成功部署 Jenkins,可以开始配置 CI/CD 流程了。
如有需要,我也可以提供 Docker 安装 Jenkins 的方式,更加轻量灵活。需要的话请告诉我。
CDNK博客