如何配置debian的jenkins

下面分常见场景给你一个完整、可操作的指南，讲解如何在 Debian 上配置 Jenkins。
如果你是 第一次安装，推荐直接看 方案一（官方仓库，最常用）。

一、方案一：使用 Jenkins 官方仓库（强烈推荐 ✅）

1️⃣ 安装 Java（Jenkins 依赖）

Jenkins 需要 Java 运行时（推荐 Java 17 或 11）。

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

验证：

java -version

2️⃣ 添加 Jenkins 官方仓库

sudo wget -O /usr/share/keyrings/jenkins-keyring.asc \
https://pkg.jenkins.io/debian-stable/jenkins.io-2023.key

添加源：

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

3️⃣ 安装 Jenkins

sudo apt update
sudo apt install -y jenkins

4️⃣ 启动并设置开机自启

sudo systemctl enable jenkins
sudo systemctl start jenkins

检查状态：

systemctl status jenkins

5️⃣ 防火墙放行 8080 端口（如有 UFW）

sudo ufw allow 8080
sudo ufw reload

6️⃣ 初始化 Jenkins

浏览器访问：

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

获取初始管理员密码：

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

按提示：

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

✅ Jenkins 基础配置完成

二、配置 Jenkins（常见重要配置）

✅ 修改 Jenkins 端口（可选）

编辑：

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

找到：

Environment="JENKINS_PORT=8080"

修改端口后执行：

sudo systemctl daemon-reload
sudo systemctl restart jenkins

✅ 配置 Jenkins 使用国内插件镜像（国内强烈推荐）

进入：

Jenkins → Manage Jenkins → Plugins → Advanced

修改 Update Site URL 为：

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

或手动修改：

sudo nano /var/lib/jenkins/hudson.model.UpdateCenter.xml

✅ 配置构建工具（示例）

Maven

sudo apt install maven

Jenkins → Global Tool Configuration → Maven

Git

sudo apt install git

三、方案二：使用 Docker 安装（快速 & 隔离）

如果你更偏好 Docker：

sudo apt install -y docker.io
sudo systemctl enable docker
sudo systemctl start docker

运行 Jenkins：

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

查看初始密码：

docker logs jenkins

四、常见问题排查

❌ Jenkins 无法启动

journalctl -u jenkins -xe

常见原因：

Java 未安装
端口被占用
权限问题

❌ 插件安装失败

✅ 检查网络
✅ 使用国内镜像
✅ 手动上传 .hpi 插件

五、推荐后续配置

✅ 配置 JDK / Maven / NodeJS
✅ 配置 凭据（Credentials）
✅ 配置 Pipeline（Jenkinsfile）
✅ 配置 Git Webhook
✅ 配置 权限管理（Role-based）

六、我可以继续帮你

你可以直接告诉我：

✅ Debian 版本（11 / 12）
✅ Jenkins 用途（Java / 前端 / CI / CD）
✅ 是否用 Docker
✅ 是否要配置流水线

我可以给你 定制级 Jenkins 配置方案 ✅