Debian配置Jenkins要注意啥

在 Debian 上配置 Jenkins，有几个容易踩坑但很关键的点。下面按“安装前 → 安装中 → 安装后 → 日常维护”给你梳理一下。

一、安装前要注意

1. Java 版本要匹配

Jenkins 对 Java 版本要求比较严格：

Jenkins 2.4xx：Java 17 或 Java 21
老版本可能只支持 Java 11（已不推荐）

✅ 推荐：

sudo apt install openjdk-17-jdk
java -version

⚠️ 不要用 default-jdk 然后才发现是 Java 11/8

2. 用户权限问题（非常重要）

Jenkins 默认使用 jenkins 系统用户运行：

没有 sudo 权限
家目录：/var/lib/jenkins
不能直接用 root 跑（安全风险）

如果你要让 Jenkins：

执行 Docker
部署到服务器
操作系统文件

需要：

sudo usermod -aG docker jenkins
sudo systemctl restart jenkins

二、安装 Jenkins（推荐方式）

官方仓库安装（最稳）

sudo apt update
sudo apt install -y curl gnupg
curl -fsSL https://pkg.jenkins.io/debian/jenkins.io.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 binary/ | sudo tee \
  /etc/apt/sources.list.d/jenkins.list > /dev/null

sudo apt update
sudo apt install jenkins

启动：

sudo systemctl enable jenkins
sudo systemctl start jenkins

三、首次配置注意点

1. 解锁密码位置

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

⚠️ 不要用 vim 改它，只是复制

2. 插件安装建议

✅ 新手：Install suggested plugins
⚠️ 生产环境：只装需要的（Git、Pipeline、Credentials）

常见必装：

Git
Pipeline
Credentials Binding
Docker / Kubernetes（按需）

3. 修改默认端口（可选）

默认是 8080，容易冲突：

sudo nano /etc/default/jenkins

改：

JENKINS_PORT=9090

然后：

sudo systemctl restart jenkins

四、安全和生产建议（很重要）

1. 不要直接暴露 8080 到公网

✅ 正确做法：

Nginx 反代
加 HTTPS
限制 IP

示例 Nginx：

location / {
    proxy_pass http://127.0.0.1:8080;
}

2. 开启权限控制

用 Matrix Authorization 或 Role Strategy
禁止匿名用户有构建权限

3. 定期备份

重点目录：

/var/lib/jenkins

可用：

jenkins-cli
ThinBackup 插件
rsync 定时备份

五、常见问题

1. Jenkins 启动不了

检查：

systemctl status jenkins
journalctl -u jenkins

常见原因：

Java 版本不对
端口被占
/var/lib/jenkins 权限错误

2. 构建时 Permission denied

用户是 jenkins
不是你登录的 user

解决：

sudo chown -R jenkins:jenkins /your/path

六、一句话总结

Debian 上跑 Jenkins，核心就三件事：
Java 版本对、jenkins 用户权限清楚、别裸奔暴露端口

如果你愿意，我可以：

给你一套 Jenkins + Docker + Nginx 的完整配置
或帮你写 Pipeline 示例
或针对你服务器用途（CI / CD / 自动化）给建议