在腾讯云轻量应用服务器上安装 Jenkins 是一个常见的 DevOps 实践,可以用于自动化构建、测试和部署应用。以下是详细的安装步骤(以 Ubuntu 系统为例):
✅ 前提条件
- 腾讯云轻量应用服务器已创建(推荐系统:Ubuntu 20.04/22.04)
- 已通过 SSH 登录到服务器
- 服务器已开放必要的端口(如 8080,Jenkins 默认端口)
🛠️ 步骤一:更新系统并安装 Java
Jenkins 依赖 Java 环境,需先安装 JDK。
sudo apt update
sudo apt upgrade -y
# 安装 OpenJDK 17(推荐,Jenkins 官方支持)
sudo apt install openjdk-17-jdk -y
验证 Java 是否安装成功:
java -version
输出应类似:
openjdk version "17.0.8" 2023-07-18
OpenJDK Runtime Environment (build 17.0.8+7-Ubuntu-122.04)
OpenJDK 64-Bit Server VM (build 17.0.8+7-Ubuntu-122.04, mixed mode)
🛠️ 步骤二:添加 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 仓库
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
# 更新包列表
sudo apt update
# 安装 Jenkins
sudo apt install jenkins -y
🛠️ 步骤三:启动 Jenkins 服务
# 启动 Jenkins
sudo systemctl start jenkins
# 设置开机自启
sudo systemctl enable jenkins
# 查看状态
sudo systemctl status jenkins
确保状态显示为 active (running)。
🛠️ 步骤四:配置防火墙和安全组
1. 腾讯云控制台配置安全组
- 登录 腾讯云轻量应用服务器控制台
- 找到你的实例,进入「防火墙」设置
- 添加规则:
- 协议类型:自定义 TCP
- 端口:
8080 - 源 IP:
0.0.0.0/0(或限制为你的 IP)
2. 本地防火墙(可选,Ubuntu 默认用 ufw)
sudo ufw allow 8080
🌐 步骤五:访问 Jenkins Web 界面
在浏览器中访问:
http://<你的服务器公网IP>:8080
首次访问会提示你输入初始管理员密码。
获取初始密码:
sudo cat /var/lib/jenkins/secrets/initialAdminPassword
复制输出的密码,粘贴到网页中。
🧩 步骤六:完成 Jenkins 初始化设置
- 推荐选择 “Install suggested plugins”(安装推荐插件)
- 创建第一个管理员用户(建议设置用户名、密码)
- 实例配置:使用默认 URL(
http://<IP>:8080) - 完成设置,进入 Jenkins 主界面
✅ 可选优化
1. 配置 Nginx 反向X_X(可选)
如果你希望使用域名或 80 端口访问:
sudo apt install nginx -y
配置 /etc/nginx/sites-available/jenkins:
server {
listen 80;
server_name your-domain.com; # 替换为你的域名或 IP
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
2. 修改 Jenkins 端口(可选)
编辑配置文件:
sudo nano /etc/default/jenkins
修改 HTTP_PORT=8080 为其他端口(如 8081),然后重启:
sudo systemctl restart jenkins
🧹 常见问题排查
| 问题 | 解决方法 |
|---|---|
无法访问 8080 端口 |
检查腾讯云防火墙和本地防火墙 |
| Jenkins 启动失败 | 查看日志 sudo journalctl -u jenkins |
| Java 版本不兼容 | 确保使用 Java 11 或 17 |
📚 参考文档
- Jenkins 官方安装指南:https://www.jenkins.io/doc/book/installing/linux/
- 腾讯云轻量服务器文档:https://cloud.tencent.com/document/product/1207
如需进一步配置 Jenkins(如对接 Git、Docker、部署项目),欢迎继续提问!
秒懂云