Debian Jenkins如何设置

下面分 Debian 系统上安装与基本配置 Jenkins 的常见做法说明，适用于 Debian 11/12（Bullseye / Bookworm）。

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

1. 安装 Java（Jenkins 依赖）

Jenkins 需要 Java 11 或 Java 17

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

验证：

java -version

2. 添加 Jenkins 官方仓库（推荐）

Debian 默认仓库中的 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

二、启动并设置开机自启

sudo systemctl enable jenkins
sudo systemctl start jenkins

查看状态：

systemctl status jenkins

三、开放端口（默认 8080）

如果使用 UFW：

sudo ufw allow 8080
sudo ufw reload

如果使用 iptables：

sudo iptables -A INPUT -p tcp --dport 8080 -j ACCEPT

四、初始化 Jenkins

1. 浏览器访问

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

2. 获取初始管理员密码

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

复制密码 → 粘贴到网页 → 继续

3. 安装插件

建议选择 Install suggested plugins
常见插件：
- Git
- Pipeline
- Docker
- SSH

4. 创建管理员用户

完成后即可进入 Jenkins 主界面。

五、Jenkins 目录与配置文件（Debian）

项目	路径
主目录	`/var/lib/jenkins`
配置文件	`/etc/default/jenkins`
日志	`/var/log/jenkins/jenkins.log`
服务	`systemctl status jenkins`

六、修改 Jenkins 端口（可选）

编辑：

sudo nano /etc/default/jenkins

修改：

HTTP_PORT=8081

重启：

sudo systemctl restart jenkins

七、配置 Jenkins 使用 Git / 构建示例

1. 安装 Git

sudo apt install git

2. 全局工具配置

Manage Jenkins → Global Tool Configuration → Git

3. 创建 Pipeline 示例

pipeline {
    agent any
    stages {
        stage('Build') {
            steps {
                git 'https://github.com/example/project.git'
                sh 'make'
            }
        }
    }
}

八、常见问题

1. Jenkins 启动失败

查看日志：

sudo journalctl -u jenkins
sudo tail -f /var/log/jenkins/jenkins.log

2. Java 版本错误

sudo update-alternatives --config java

九、生产环境建议

✅ 使用 Nginx 反向代理
✅ 启用 HTTPS
✅ 定期备份 /var/lib/jenkins
✅ 限制 Jenkins 用户权限

如果你需要：

✅ Docker 方式安装 Jenkins
✅ Jenkins + Nginx + HTTPS
✅ Jenkins 流水线（Pipeline）实战
✅ Jenkins 与 GitLab / GitHub 集成

可以直接告诉我你的使用场景。