温馨提示×

Jenkins配置Debian步骤是啥

小樊
36
2026-07-17 02:19:41
栏目: 智能运维

下面给你一份在 Debian 系统上安装和配置 Jenkins 的完整步骤(基于 Debian 11/12,也适用于大多数 Debian 系发行版)。


一、前置条件

  • 一台 Debian 服务器(root 或 sudo 权限)
  • 已安装 Java(Jenkins 依赖 Java)

1️⃣ 安装 Java(推荐 JDK 17)

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

验证:

java -version

二、添加 Jenkins 官方仓库(推荐方式)

2️⃣ 导入 Jenkins GPG 密钥

curl -fsSL https://pkg.jenkins.io/debian-stable/jenkins.io-2023.key | sudo tee \
  /usr/share/keyrings/jenkins-keyring.asc > /dev/null

3️⃣ 添加 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

三、安装 Jenkins

sudo apt update
sudo apt install -y jenkins

四、启动并设置开机自启

sudo systemctl enable jenkins
sudo systemctl start jenkins

查看状态:

sudo systemctl status jenkins

五、配置防火墙(如果有 UFW)

sudo ufw allow 8080
sudo ufw reload

Jenkins 默认端口:8080


六、初始化 Jenkins

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

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

7️⃣ 浏览器访问

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

粘贴上面获取的密码 → 继续


七、插件与用户配置

  1. 选择 Install suggested plugins(推荐插件)
  2. 创建管理员用户
  3. 实例配置(默认即可)

八、Jenkins 基础配置(推荐)

修改 Jenkins 端口(可选)

编辑:

sudo nano /etc/default/jenkins

修改:

HTTP_PORT=8081

重启:

sudo systemctl restart jenkins

九、常见目录说明

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

十、常见问题排查

Jenkins 无法启动

journalctl -u jenkins -xe

Java 版本问题

update-alternatives --config java

如果你需要:

  • Jenkins + Docker
  • Jenkins + GitLab / GitHub
  • Jenkins 流水线(Pipeline)
  • 用 Nginx 反向代理 Jenkins

告诉我你的使用场景,我可以给你更针对性的配置方案。

0