debian jenkins怎么配置

下面按**“在 Debian 上安装并配置 Jenkins”**的完整流程给你讲，适合新手，也涵盖常见配置点。

一、环境准备

1. 系统要求

Debian 10 / 11 / 12（推荐 11+）
已安装 Java（Jenkins 需要 JRE）

查看 Java：

java -version

如果没有 Java：

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

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

1. 导入 Jenkins 官方 GPG Key

sudo apt update
sudo apt install -y wget gnupg2
wget -O - https://pkg.jenkins.io/debian/jenkins.io.key | sudo apt-key add -

2. 添加 Jenkins 源

echo "deb http://pkg.jenkins.io/debian-stable binary/" | \
sudo tee /etc/apt/sources.list.d/jenkins.list

3. 安装 Jenkins

sudo apt update
sudo apt install -y jenkins

三、启动并设置开机自启

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

默认端口：8080

四、初始配置

1. 获取初始管理员密码

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

浏览器访问：

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

粘贴密码 → 继续

2. 安装插件

新手推荐：Install suggested plugins
后续可手动安装（Git、Pipeline、Docker 等）

3. 创建管理员用户

用户名
密码
邮箱

完成后进入 Jenkins 主页

五、基础系统配置（Manage Jenkins）

1. 全局工具配置

路径：

Manage Jenkins → Global Tool Configuration

常用配置：

JDK
Git
Maven / Gradle
NodeJS（前端项目）

示例（Git）：

Name: Default Git
Path: /usr/bin/git

2. 配置凭据（Credentials）

路径：

Manage Jenkins → Credentials

常用：

Git 账号密码 / SSH Key
Docker Hub
服务器 SSH

六、创建第一个任务（Job）

1. 新建 Item

名称：demo-pipeline
类型：Pipeline

2. Pipeline 示例

pipeline {
    agent any
    stages {
        stage('Clone') {
            steps {
                git 'https://github.com/your/repo.git'
            }
        }
        stage('Build') {
            steps {
                sh 'mvn clean package'
            }
        }
    }
}

保存 → Build Now

七、常见配置 & 问题

1. 修改 Jenkins 端口

编辑：

sudo nano /etc/default/jenkins

修改：

HTTP_PORT=8081

重启：

sudo systemctl restart jenkins

2. 防火墙放行

sudo ufw allow 8080

3. Jenkins 用户权限问题

Jenkins 默认使用 jenkins 用户：

sudo usermod -aG docker jenkins
sudo systemctl restart jenkins

八、生产建议（重要）

✅ Nginx 反向代理（HTTPS）
✅ 定期备份 /var/lib/jenkins
✅ 使用 Pipeline 而非 Freestyle
✅ 限制匿名访问

如果你愿意，我可以继续帮你：

✅ 配 Nginx + HTTPS
✅ 写 Docker 部署 Jenkins
✅ 配置 GitLab / GitHub Webhook
✅ 写 完整 CI/CD 示例

你现在是学习用还是公司服务器部署？