Jenkins在Debian怎么配

下面给你一份在 Debian 上安装并配置 Jenkins 的实用指南，从安装到基础配置，适合新手也能直接用。

一、环境准备

1. 系统要求

Debian 11 / 12（推荐）
已安装 Java（Jenkins 依赖 Java）

查看 Java：

java -version

如果没有 Java：

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

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

1. 导入 Jenkins GPG 密钥

sudo apt update
sudo apt install -y curl gnupg
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://pkg.jenkins.io/debian-stable/jenkins.io-2023.key | sudo tee /etc/apt/keyrings/jenkins-keyring.asc > /dev/null

2. 添加 Jenkins 源

echo "deb [signed-by=/etc/apt/keyrings/jenkins-keyring.asc] https://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

看到 active (running) 说明成功。

四、防火墙（如有）

sudo ufw allow 8080

默认端口是 8080。

五、初始配置

1. 获取管理员密码

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

2. 浏览器访问

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

粘贴密码 → 点击 Continue

3. 安装插件

推荐：Install suggested plugins
或自定义（Git、Pipeline、SSH 等）

4. 创建管理员用户

按提示设置用户名、密码、邮箱。

六、基础目录说明

路径	说明
`/var/lib/jenkins`	Jenkins 主目录
`/var/log/jenkins`	日志
`/etc/default/jenkins`	启动参数
`/usr/lib/systemd/system/jenkins.service`	systemd 配置

七、修改端口（可选）

编辑：

sudo nano /usr/lib/systemd/system/jenkins.service

修改：

Environment="JENKINS_PORT=9090"

然后：

sudo systemctl daemon-reload
sudo systemctl restart jenkins

八、常见问题

1. Jenkins 启动失败

查看日志：

journalctl -u jenkins -n 50

2. Java 版本不对

Jenkins 需要 Java 11 或 17。

3. 权限问题

不要手动改 /var/lib/jenkins 权限，使用：

sudo chown -R jenkins:jenkins /var/lib/jenkins

九、下一步你可以做什么

配置 Git + Pipeline
配置 SSH 到目标服务器
集成 Docker / Maven / Node
配置 Webhook 自动构建

如果你愿意，可以告诉我： ✅ 用途（前端 / 后端 / Docker） ✅ Debian 版本 ✅ 是否内网 / 云服务器

我可以直接给你一套可用 Jenkinsfile 示例。