温馨提示×

怎么给Debian配Jenkins

小樊
36
2026-07-17 02:26:43
栏目: 智能运维

下面给你一份在 Debian 上安装并配置 Jenkins 的完整流程,适用于 Debian 11/12,适用于初次搭建或从零开始配置。


一、准备工作

1️⃣ 更新系统

sudo apt update
sudo apt upgrade -y

2️⃣ 安装 Java(Jenkins 必须)

Jenkins 需要 Java 11 或 Java 17(推荐 17)

安装 OpenJDK 17

sudo apt install openjdk-17-jdk -y

验证 Java

java -version

二、安装 Jenkins

1️⃣ 添加 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 APT 源

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

2️⃣ 安装 Jenkins

sudo apt update
sudo apt install jenkins -y

三、启动并配置 Jenkins

1️⃣ 启动 Jenkins

sudo systemctl enable jenkins
sudo systemctl start jenkins

查看状态:

sudo systemctl status jenkins

2️⃣ 开放防火墙端口(如有 UFW)

Jenkins 默认使用 8080

sudo ufw allow 8080
sudo ufw reload

四、初始化 Jenkins

1️⃣ 浏览器访问

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

例如:

http://192.168.1.100:8080

2️⃣ 获取初始管理员密码

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

复制并在浏览器中输入。


3️⃣ 安装插件

  • 选择 “Install suggested plugins”(推荐)
  • 等待安装完成

4️⃣ 创建管理员用户

按提示填写:

  • 用户名
  • 密码
  • 邮箱

五、Jenkins 常用配置

1️⃣ 修改 Jenkins 端口(可选)

编辑配置文件:

sudo nano /usr/lib/systemd/system/jenkins.service

找到:

Environment="JENKINS_PORT=8080"

修改后:

sudo systemctl daemon-reload
sudo systemctl restart jenkins

2️⃣ 配置 Jenkins 使用国内插件源(国内服务器强烈推荐)

进入:

Jenkins → Manage Jenkins → Plugins → Advanced

Update Site 改为:

https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json

或直接修改服务器文件:

sudo sed -i 's#https://updates.jenkins.io#https://mirrors.tuna.tsinghua.edu.cn/jenkins#g' \
/var/lib/jenkins/hudson.model.UpdateCenter.xml
sudo systemctl restart jenkins

3️⃣ 配置构建工具(示例)

  • JDK
  • Git
  • Maven / Gradle / NodeJS

安装方式:

Manage Jenkins → Global Tool Configuration

示例安装 Git:

sudo apt install git -y

六、常见问题排查

1️⃣ Jenkins 无法启动

journalctl -u jenkins -xe

2️⃣ Java 版本不对

update-alternatives --config java

3️⃣ 端口被占用

ss -lntp | grep 8080

七、可选增强(生产环境推荐)

✅ 使用 Nginx 反向代理 + HTTPS
✅ 配置 Systemd 自动重启
✅ 使用 Docker 安装 Jenkins(如果你需要)


如果你愿意,我可以继续帮你:

  • ✅ 配置 Jenkins + Git + Maven 自动构建
  • ✅ 配置 Jenkins Pipeline
  • Docker 方式部署 Jenkins
  • Jenkins 与 GitHub / Gitee 联动

你现在用的是 Debian 几?物理机 / 云服务器 / Docker?

0