debian Jenkins如何配置

下面按**“在 Debian 上安装 Jenkins → 基础配置 → 常用设置”**的顺序，给你一份实用的 Debian Jenkins 配置指南（适用于 Debian 11/12）。

一、在 Debian 上安装 Jenkins

1. 安装 Java（Jenkins 依赖）

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

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

验证：

java -version

2. 添加 Jenkins 官方仓库

sudo apt install -y wget gnupg
wget -q -O - https://pkg.jenkins.io/debian/jenkins.io.key | sudo gpg --dearmor -o /usr/share/keyrings/jenkins.gpg

echo "deb [signed-by=/usr/share/keyrings/jenkins.gpg] https://pkg.jenkins.io/debian binary/" | sudo tee /etc/apt/sources.list.d/jenkins.list

3. 安装 Jenkins

sudo apt update
sudo apt install -y jenkins

4. 启动并设置开机自启

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

二、初次访问与解锁

1. 查看初始管理员密码

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

2. 浏览器访问

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

• 输入密码
• 选择 Install suggested plugins
• 创建管理员账号

三、基础配置（Web 界面）

1. 系统配置

Manage Jenkins → System

常见配置项：

• Jenkins URL
• 邮件通知（SMTP）
• 全局环境变量

2. 配置 JDK / Maven / Git

Manage Jenkins → Global Tool Configuration

• JDK
  • 勾选 “Install automatically” 或指定路径
• Git
  • 默认一般已安装
• Maven / Gradle（按需）

3. 配置用户权限（推荐）

Manage Jenkins → Security

• 启用 Logged-in users can do anything
• 或安装 Role-based Authorization Strategy 插件做细粒度控制

四、创建第一个任务（Freestyle）

1. New Item → Freestyle project
2. 源码管理：
   • Git → 填写仓库地址
3. 构建触发器：
   • Poll SCM
   • 或 GitHub Webhook
4. 构建步骤：
   • Execute shell

   mvn clean package
   

5. 保存并 Build Now

五、常见配置示例

1. 修改 Jenkins 端口

编辑：

sudo nano /etc/default/jenkins

修改：

JENKINS_PORT=9090

重启：

sudo systemctl restart jenkins

2. 使用 Nginx 反向代理（推荐）

server {
    listen 80;
    server_name jenkins.example.com;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

3. 防火墙放行

sudo ufw allow 8080

六、常见问题

Jenkins 起不来？

journalctl -u jenkins -f

常见原因：

• Java 版本不对
• 端口被占用
• 权限问题（/var/lib/jenkins）

如果你需要：

• Jenkins + Docker
• Jenkins Pipeline 示例
• Jenkins 多节点（Agent）
• GitLab / GitHub 自动构建

告诉我你的使用场景，我可以直接给你配置示例。