如何在Debian配置Jenkins

下面是在 Debian 系统上配置 Jenkins 的完整流程（从安装到基本配置）。

一、安装 Jenkins（官方推荐方式）

1. 安装依赖

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

Jenkins 从 2.357+ 推荐使用 Java 17
如果你项目需要 Java 8/11，也可使用对应版本，但建议使用 17。

验证 Java：

java -version

2. 添加 Jenkins 官方仓库

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

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

二、启动并开启 Jenkins

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

如果看到 active (running) 说明启动成功。

三、配置防火墙（如有 UFW）

sudo ufw allow 8080
sudo ufw reload

Jenkins 默认端口：8080

四、初始化 Jenkins

1. 获取初始管理员密码

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

复制输出的密码。

2. 浏览器访问

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

输入刚才的密码 → 继续

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. 配置 Java（如果系统有多个 Java）

sudo update-alternatives --config java

确保 Jenkins 使用的是你期望的 Java 版本。

3. 配置 Jenkins 使用国内插件源（可选，国内推荐）

编辑：

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

替换为：

<?xml version='1.1' encoding='UTF-8'?>
<sites>
  <site>
    <id>default</id>
    <url>https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json</url>
  </site>
</sites>

重启 Jenkins：

sudo systemctl restart jenkins

六、常见后续配置

1. 安装常用插件

Git
GitHub
Docker
Pipeline
Blue Ocean

2. 配置 JDK / Maven / NodeJS

进入：

Manage Jenkins → Global Tool Configuration

3. 配置认证（Git / Docker / SSH）

Manage Jenkins → Credentials

七、卸载 Jenkins（如需要）

sudo apt remove jenkins
sudo apt purge jenkins

八、示例：Debian + Jenkins + Docker（简介）

如果你想用 Jenkins 构建 Docker 镜像：

sudo apt install docker.io
sudo usermod -aG docker jenkins
sudo systemctl restart jenkins

如果你需要：

✅ Jenkins + GitLab / GitHub
✅ Pipeline 示例
✅ Jenkins 自动化部署 Spring Boot / Node.js
✅ Jenkins 分布式（Agent）

可以告诉我你的具体使用场景，我可以给你定制配置方案。