Debian怎么配置Jenkins

下面是在 Debian 上配置 Jenkins 的完整流程，适用于 Debian 11 / 12（其他版本也类似）。

一、安装 Jenkins

1. 安装 Java（Jenkins 依赖）

Jenkins 依赖 Java（推荐 Java 11 或 17）：

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

验证：

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

1. 启动 Jenkins

sudo systemctl enable jenkins
sudo systemctl start jenkins

查看状态：

sudo systemctl status jenkins

2. 开放端口（默认 8080）

如果启用了防火墙（ufw）：

sudo ufw allow 8080
sudo ufw reload

云服务器记得在安全组里放行 8080

三、初始化 Jenkins

1. 浏览器访问

http://<服务器IP>: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=8081"

然后：

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

重启 Jenkins：

sudo systemctl restart jenkins

五、配置 Jenkins 与 Git / 构建工具

1. 安装常用插件

• Git Plugin
• Pipeline
• Docker Pipeline
• NodeJS Plugin
• Maven Integration

2. 配置 JDK / Maven / NodeJS

进入：

Manage Jenkins → Global Tool Configuration

• JDK：自动安装或指定 JAVA_HOME
• Maven / NodeJS：可自动安装

六、常见问题

1. Jenkins 无法启动

检查 Java 是否正确安装：

which java
java -version

2. 权限问题

Jenkins 默认以 jenkins 用户运行：

sudo usermod -aG docker jenkins
sudo systemctl restart jenkins

七、目录说明

如果你需要：

• ✅ Jenkins + Docker
• ✅ Jenkins Pipeline 示例
• ✅ Jenkins + GitLab / GitHub
• ✅ Jenkins 自动化部署 Spring Boot / Node.js

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