如何自定义Linux Jenkins界面

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

一 前置准备与通用路径

• 确认 JENKINS_HOME 路径：常见为 /var/lib/jenkins（Debian/Ubuntu 常见）、/opt/jenkins 或自定义目录。所有静态资源建议放在 $JENKINS_HOME/userContent/ 下，通过 URL 访问（例如 /userContent/style.css）。
• 安装主题插件：进入 Manage Jenkins → Manage Plugins → Available，搜索并安装 Simple Theme Plugin（部分教程也写作 Theme Plugin，功能一致）。安装后可在系统配置中看到主题相关项。

二 使用 Simple Theme 插件快速换肤

• 在线主题
  • 进入 Manage Jenkins → Configure System → Theme，在 CSS URL 填入在线 CSS 地址，例如 http://afonsof.com/jenkins-material-theme/dist/material-blue.css，保存即可生效。
• 本地主题
  • 将自定义 custom.css 放到 $JENKINS_HOME/userContent/（如 /var/lib/jenkins/userContent/custom.css），在 Theme → CSS URL 填入 /userContent/custom.css 并保存。
• 使用主题定制工具
  • 通过 Jenkins Theme Customizer 选择配色与 Logo，下载生成的 jenkins-material-theme.css，放入 $JENKINS_HOME/userContent/material/，在 CSS URL 填入 /userContent/material/jenkins-material-theme.css 并保存。

三 进阶自定义 CSS 与 JS

• 放置静态资源
  • 在 $JENKINS_HOME/userContent/ 下创建 custom.css 与 custom.js，例如：
    • custom.css

      body { background-color: #f0f0f0; }
      

    • custom.js

      console.log("Custom JavaScript loaded!");
      

• 在页面中引入
  • 在 Manage Jenkins → Configure System → Theme 的 CSS URL 填入 /userContent/custom.css，如需脚本可配合 Script Security 插件与 Manage Jenkins → In-process Script Approval 批准内联脚本后使用（注意安全）。
• 安全提示
  • 仅在内网或受控环境开放自定义 JS；避免引入外部不可信资源，防止 XSS 与信息泄露。

四 使用 Blue Ocean 与仪表盘插件优化体验

• 安装 Blue Ocean 插件（现代 UI）：进入 Manage Jenkins → Manage Plugins → Available 搜索并安装，重启后在导航中可见 Blue Ocean 入口，提供更直观的流水线可视化与操作体验。
• 自定义仪表盘
  • 安装 Dashboard 类插件（如自定义视图/门户），通过 Manage Jenkins → Manage Plugins 安装后在 Manage Jenkins → Configure System 或相关视图配置中进行布局与小组件设置。

五 用 JCasC 将界面配置纳入代码管理

• 安装 Configuration as Code (JCasC) 插件，创建 jenkins.yaml，示例：

  jenkins:
    theme:
      name: "dark"
  systemMessage: "Welcome to Jenkins!"
  

• 在 Manage Jenkins → Configuration as Code 上传 YAML 并应用，即可将主题等界面相关配置纳入版本控制与自动化部署。