Ubuntu 上部署完成后的 Jenkins 配置指南
一 初始化与安全加固
- 访问与解锁：在浏览器打开 http://<服务器IP>:8080，使用初始管理员密码解锁，密码位于 /var/lib/jenkins/secrets/initialAdminPassword。随后选择安装 推荐插件 并创建第一个管理员用户。为提升安全性，进入 Manage Jenkins → Configure Global Security：启用安全、选择授权策略（如 Project-based Matrix Authorization Strategy 或 Role-Based Strategy）、开启 CSRF 保护，并配置 LDAP/内置用户数据库 等安全领域。必要时在系统层面开启防火墙并放行 8080 端口（如使用 ufw allow 8080）。
二 系统与工具链配置
- 全局工具配置：进入 Manage Jenkins → Global Tool Configuration，配置 JDK（建议使用 OpenJDK 11/17 LTS）、Git、Maven 等工具路径；如使用系统包管理器安装，可直接填写如 /usr/bin/git 等可执行路径。若采用二进制包手动安装，需先在系统设置好 JAVA_HOME 等环境变量，再在 Jenkins 中指定工具路径。
- 常用插件建议：在 Manage Jenkins → Manage Plugins 安装 Git、Pipeline、Webhook、Locale（中文语言包）等插件，用于源码拉取、流水线编排、代码推送触发与界面中文本地化。安装完成后按需重启使插件生效。
三 网络与端口调整
- 端口冲突处理：若 8080 被占用，可修改 Jenkins 启动端口。常见方式包括：编辑 /usr/lib/systemd/system/jenkins.service 中的 Environment=“JENKINS_PORT=8088”，执行 systemctl daemon-reload && systemctl restart jenkins；或编辑 /etc/default/jenkins 修改 HTTP_PORT=8088 后重启服务。
- 防火墙放行：在 ufw 环境中执行 sudo ufw allow 8080/tcp 放行端口；如使用云服务器，还需在云平台安全组放行对应端口。
- 域名与 HTTPS：生产环境建议使用 Nginx 反向代理绑定域名并启用 SSL/TLS，对外提供 HTTPS 访问，提升安全性与可维护性。
四 构建与流水线实践
- 创建任务：新建 Freestyle 或 Pipeline 任务。Freestyle 任务中配置 源码管理（Git）、构建触发器（如 Webhook）、构建步骤（如执行 Shell/Maven 命令）；Pipeline 任务在 Pipeline 脚本中使用 Jenkinsfile 定义拉取代码、构建、测试、部署等阶段。
- 触发器与自动化：在代码托管平台（如 GitHub/GitLab）配置 Webhook，指向 Jenkins 任务，实现 push/merge 请求自动触发构建；必要时在 Jenkins 任务中配置 轮询 SCM 作为备选触发方式。
五 运维与故障排查
- 日志与诊断：通过 sudo journalctl -u jenkins.service -f 实时查看服务日志，定位插件安装、构建失败等问题；必要时在 Manage Jenkins → System Log 查看更详细运行信息。
- 插件管理：在 Manage Jenkins → Manage Plugins 执行安装、更新、卸载；插件下载慢可更换 Update Site URL 为 https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json；也可使用 Jenkins CLI 批量管理插件（如 install-plugin、update-plugin）。
- 备份与优化：定期备份 /var/lib/jenkins 目录（含任务配置、构建历史、插件等）；为提升稳定性与性能，建议启用 并行构建、减少不必要插件、定期清理旧构建、按需调整 JVM 参数，并考虑 分布式构建 扩展执行节点。