ubuntu jenkins配置注意啥

在 Ubuntu 上配置 Jenkins，有几个常见坑和关键注意点，按“安装 → 安全 → 权限 → 构建环境 → 运维”整理给你：

一、安装方式选择

推荐：官方仓库安装（不要用 snap 旧版）

wget -q -O - https://pkg.jenkins.io/debian/jenkins.io.key | sudo apt-key add -
sudo sh -c 'echo deb http://pkg.jenkins.io/debian-stable binary/ > /etc/apt/sources.list.d/jenkins.list'
sudo apt update
sudo apt install jenkins

⚠️ 注意：

Ubuntu 22.04+ 可能默认 Java 11/17
Jenkins 2.4xx 需要 Java 17

java -version

二、用户与权限（非常重要）

1. Jenkins 默认用户

默认用户：jenkins
家目录：/var/lib/jenkins

2. 构建需要权限时

常见错误：

无法执行 docker
无法写 /var/www

解决示例（docker）：

sudo usermod -aG docker jenkins
sudo systemctl restart jenkins

⚠️ 改完必须重启 Jenkins

三、端口与防火墙

默认端口：8080

sudo ufw allow 8080

生产环境建议：

用 Nginx 反向代理
启用 HTTPS
不要直接暴露 8080

四、首次初始化注意

解锁密码：

cat /var/lib/jenkins/secrets/initialAdminPassword

插件安装：

新手选 Install suggested plugins
国内慢 → 换源：

# 管理 → 插件 → 高级 → 更新站点
https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json

五、构建环境坑点

1. 环境变量

Jenkins 不读你 shell 的 .bashrc 解决：

在 Manage Jenkins → Configure System 设置
或用 withEnv

2. Git / Node / Maven

用 Jenkins 工具自动安装
不要依赖系统 PATH

六、安全配置（必做）

启用 安全矩阵 / 角色插件
禁止匿名访问
使用 GitHub / GitLab OAuth
定期备份：

/var/lib/jenkins

七、服务管理

sudo systemctl status jenkins
sudo systemctl restart jenkins
sudo journalctl -u jenkins -f

八、常见错误速查

问题	原因
启动失败	Java 版本不对
构建没权限	jenkins 用户权限不足
插件装不上	网络/源问题
构建环境不对	环境变量未配置

如果你愿意，可以告诉我：

Ubuntu 版本
Jenkins 用途（Java / Node / Docker / K8s）
是否生产环境

我可以直接给你一套可复制的配置方案。