温馨提示×

怎样部署debian jenkins

小樊
42
2026-10-19 16:25:45
栏目: 智能运维

下面按最常见场景给你讲:在 Debian 系统上部署 Jenkins(单机部署),适合 CI/CD 入门和一般企业使用。


一、环境准备

1. 系统要求

  • Debian 11 / 12(推荐)
  • 用户:root 或具备 sudo 权限
  • 内存:≥ 2GB(推荐 4GB)
  • Java:Jenkins 2.4xx 需要 Java 17

二、安装 Java

sudo apt update
sudo apt install -y openjdk-17-jdk

验证:

java -version

三、添加 Jenkins 官方仓库

sudo apt install -y wget gnupg
wget -q -O - https://pkg.jenkins.io/debian/jenkins.io.key | sudo gpg --dearmor -o /usr/share/keyrings/jenkins-keyring.gpg
echo "deb [signed-by=/usr/share/keyrings/jenkins-keyring.gpg] https://pkg.jenkins.io/debian binary/" | sudo tee /etc/apt/sources.list.d/jenkins.list

四、安装 Jenkins

sudo apt update
sudo apt install -y jenkins

五、启动 Jenkins

sudo systemctl enable jenkins
sudo systemctl start jenkins
sudo systemctl status jenkins

六、防火墙配置(如有)

sudo apt install -y ufw
sudo ufw allow 8080
sudo ufw enable

七、初始化 Jenkins

浏览器访问:

http://<服务器IP>:8080

获取管理员密码:

sudo cat /var/lib/jenkins/secrets/initialAdminPassword

按页面提示:

  1. 安装推荐插件
  2. 创建管理员账号
  3. 完成初始化

八、常见优化配置(可选)

1. 修改 Jenkins 端口

编辑:

sudo vim /etc/default/jenkins

修改:

HTTP_PORT=8080

重启:

sudo systemctl restart jenkins

2. 使用 Nginx 反向代理(推荐)

sudo apt install -y nginx

示例配置:

server {
    listen 80;
    server_name jenkins.example.com;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

3. 配置 Jenkins 用户权限(安全)

  • 使用 Role-based Authorization
  • 禁止匿名访问
  • 定期备份 /var/lib/jenkins

九、目录说明

路径 说明
/var/lib/jenkins Jenkins 主目录
/etc/default/jenkins 启动参数
/var/log/jenkins 日志

十、常见问题

Jenkins 启动失败?

journalctl -u jenkins -f

常见原因:

  • Java 版本不对
  • 端口被占用
  • 权限不足

如果你需要:

  • Docker 部署 Jenkins
  • Jenkins + GitLab / GitHub
  • Jenkins 流水线示例
  • 高可用 / 多节点 Agent

告诉我你的使用场景,我可以给你更具体的方案。

0 踩