如何安装debian jenkins

debian

小樊

2026-09-10 23:38:35

栏目: 智能运维

下面以 Debian 系统（如 Debian 11/12） 为例，介绍安装 Jenkins 的常见方式。推荐 官方仓库方式，稳定且易升级。

一、安装前准备

1. 更新系统

sudo apt update
sudo apt upgrade -y

2. 安装 Java（Jenkins 依赖）

Jenkins 需要 Java（推荐 Java 17 或 11）

sudo apt install -y openjdk-17-jdk

验证：

java -version

二、通过官方仓库安装 Jenkins（推荐）

1. 安装依赖

sudo apt install -y curl gnupg apt-transport-https

2. 导入 Jenkins GPG 密钥

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

3. 添加 Jenkins 软件源

echo "deb [signed-by=/etc/apt/keyrings/jenkins-keyring.asc] \
https://pkg.jenkins.io/debian-stable binary/" | \
sudo tee /etc/apt/sources.list.d/jenkins.list > /dev/null

4. 安装 Jenkins

sudo apt update
sudo apt install -y jenkins

三、启动并配置 Jenkins

1. 启动服务

sudo systemctl enable jenkins
sudo systemctl start jenkins

查看状态：

sudo systemctl status jenkins

2. 开放防火墙端口（如有）

sudo ufw allow 8080

四、完成初始化配置

1. 浏览器访问

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

2. 获取初始管理员密码

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

3. 按页面提示

安装推荐插件
创建管理员用户
完成配置

五、常见问题

Jenkins 无法启动？

检查 Java：

which java

如路径异常，可手动指定：

sudo systemctl edit jenkins

添加：

[Service]
Environment="JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64"

想用 Docker 安装？

也可以：

docker run -d \
  -p 8080:8080 -p 50000:50000 \
  -v jenkins_home:/var/jenkins_home \
  jenkins/jenkins:lts

如果你告诉我：

Debian 版本
是否用 Docker
是否用于 CI/CD / 局域网 / 公网

我可以给你更精确的配置方案。