Debian用户如何自定义GitLab界面

Debian上自定义GitLab界面的实用做法

一 管理员侧品牌与主题

• 修改系统配置文件：编辑 /etc/gitlab/gitlab.rb，按需添加或修改以下键值，然后执行 sudo gitlab-ctl reconfigure && sudo gitlab-ctl restart 使配置生效。
  • 主题色：
    gitlab_rails[‘theme’] = ‘blue’ # 可选：blue、green、red、orange、purple、white
  • 品牌 Logo：
    gitlab_rails[‘logo_url’] = ‘https://example.com/logo.png’
  • 网站图标：
    gitlab_rails[‘favicon_url’] = ‘https://example.com/favicon.ico’
  • 界面语言（实例默认）：
    gitlab_rails[‘locale’] = ‘zh_CN’
    说明：上述键值为实例级配置，影响所有用户。Logo/Favicon 支持使用外链图片；若需本地静态资源，可结合“自定义静态资源”方式托管。执行 reconfigure 会应用资产变更。

二 用户级外观偏好

• 登录 GitLab 后，进入右上角头像 → Settings → Preferences → User Interface，可选择界面语言（如 Chinese Simplified）、调整字体大小与界面布局（如 Fluid 流式布局），点击 Save Preferences 立即生效。该方式仅影响当前登录用户的视图。

三 高级自定义 CSS 与 JS

• 通过配置注入自定义静态资源：
  1. 创建资源文件
     sudo nano /etc/gitlab/custom.css
     sudo nano /etc/gitlab/custom.js
  2. 在 /etc/gitlab/gitlab.rb 中声明资源路径
     gitlab_rails[‘custom_css’] = ‘/etc/gitlab/custom.css’
     gitlab_rails[‘custom_js’] = ‘/etc/gitlab/custom.js’
  3. 使配置生效
     sudo gitlab-ctl reconfigure
     sudo gitlab-ctl restart
  4. 如需托管在 GitLab Pages：将 CSS/JS 放入项目的 public/ 目录，配置 .gitlab-ci.yml 的 Pages 阶段发布，然后在 gitlab.rb 中用 Pages 公网 URL 作为资源地址。
     提示：自定义 JS 应遵循 CSP 策略；升级后请回归测试覆盖样式与脚本行为。

四 深度主题定制与注意事项

• 直接修改源码主题（仅限可维护场景）：
  1. 备份原始主题
     sudo cp -r /opt/gitlab/embedded/service/gitlab-rails/public/themes /opt/gitlab/embedded/service/gitlab-rails/public/themes_backup
  2. 复制默认主题并定制
     sudo mkdir -p /opt/gitlab/embedded/service/gitlab-rails/public/themes/custom
     sudo cp -r /opt/gitlab/embedded/service/gitlab-rails/public/themes/grey /opt/gitlab/embedded/service/gitlab-rails/public/themes/custom/grey
  3. 修改样式变量（示例）
     sudo nano /opt/gitlab/embedded/service/gitlab-rails/public/themes/custom/grey/scss/_variables.scss
     如：将 $brand-primary 改为 #007bff
  4. 重新编译静态资源并重启
     cd /opt/gitlab/embedded/service/gitlab-rails
     sudo bundle exec rake gitlab:assets:reconfigure RAILS_ENV=production
     sudo gitlab-ctl restart
     风险提示：该方式在 升级/重装 时可能被覆盖，务必保留备份与变更脚本；更推荐优先使用“管理员级配置 + 自定义 CSS/JS”的方式。