如何自定义Jenkins在CentOS上的界面

在 CentOS 上自定义 Jenkins 界面的实用方案

一 前置准备与访问

• 确保 Jenkins 已安装并运行，默认端口为 8080。在浏览器访问 http://服务器IP:8080。
• 首次进入按向导设置管理员账户；如需命令行查看初始密码，可执行：cat /var/lib/jenkins/secrets/initialAdminPassword。
• 插件管理路径为：Manage Jenkins → Manage Plugins，后续界面定制大多在此完成。

二 使用 Simple Theme 插件快速换肤

• 安装插件：进入 Manage Jenkins → Manage Plugins → Available，搜索并安装 Simple Theme Plugin，安装完成后重启 Jenkins。
• 准备主题 CSS：
  • 方式 A（在线 CDN）：使用流行的 Material Theme 配色，例如 http://afonsof.com/jenkins-material-theme/dist/material-blue.css。
  • 方式 B（本地托管）：将自定义 CSS 放入 $JENKINS_HOME/userContent/（常见路径为 /var/lib/jenkins/userContent/），例如创建 /var/lib/jenkins/userContent/custom.css，之后通过 /userContent/custom.css 访问。
• 应用主题：进入 Manage Jenkins → Configure System → Theme，在 CSS URL 填入上面的 CSS 地址；如需叠加效果，可同时配置 JS URL。保存后即可生效。

三 进阶自定义 CSS 与 JS

• 放置资源：在 $JENKINS_HOME/userContent/ 下创建资源文件，例如 custom.css、custom.js。示例：
  • custom.css

    /* 示例：整体背景与顶部条颜色 */
    body { background-color: #f5f5f5 !important; }
    #header { background-color: #263238 !important; }
    

  • custom.js

    // 示例：控制台输出提示
    console.log("Custom JS loaded.");
    

• 引用方式：在 Manage Jenkins → Configure System → Theme 的 CSS URL / JS URL 中分别填入 /userContent/custom.css 与 /userContent/custom.js。
• 安全与生效：
  • 若页面出现样式被过滤或无法加载，请在 Manage Jenkins → Global Security → Markup Formatter 选择 Safe HTML（注意仅对受信内容启用）。
  • 修改后保存，必要时重启 Jenkins 以清除浏览器缓存查看效果。

四 使用 JCasC 将界面定制纳入代码管理

• 安装插件：在 Manage Jenkins → Manage Plugins 安装 Configuration as Code (JCasC)。
• 创建配置文件（例如 jenkins.yaml），示例：

  jenkins:
    systemMessage: "Welcome to Jenkins (Customized)"
  theme:
    name: "dark"
  

  也可在 JCasC 中管理 Simple Theme 的 cssUrl / jsUrl 等字段（具体字段以插件与版本支持为准）。
• 应用配置：进入 Manage Jenkins → Configuration as Code，上传或粘贴 YAML 并保存；如提示需要重启，按界面指引执行。

五 Docker 部署场景的要点

• 资源路径映射：运行容器时需将宿主机的 $JENKINS_HOME/userContent 挂载到容器内相同路径，例如：

  docker run -d \
    -p 8080:8080 \
    -v /var/lib/jenkins:/var/lib/jenkins \
    -v /var/lib/jenkins/userContent:/var/lib/jenkins/userContent \
    jenkins/jenkins:lts
  

  这样在容器内也能通过 /userContent/ 访问你在宿主机放置的 custom.css / custom.js。
• 其余步骤（安装插件、配置 Theme → CSS/JS URL）与裸机部署一致。