Ubuntu上自定义 GitLab 界面的实用做法
一 用户级外观与语言
- 登录后点击右上角头像 → Settings → Preferences，在 Appearance 中选择 Navigation theme（导航主题，含 dark 等）与 Customize theme（代码高亮风格，共 5 种）。
- 在同一页面的 Language 中选择 中文（简体） 并保存，刷新页面即可生效。
- 这些设置为“用户级”，仅影响当前账户。
二 管理员级品牌与界面元素
- 使用管理员账号进入 Admin Area（管理区域），在左侧找到 Appearance。
- 可上传 Logo、设置 Favicon、配置界面文案（如 Sign-in page text）等，完成后保存并刷新。
- 该方式适合统一全站品牌呈现；具体可配置项会随版本略有差异。
三 实例级自定义 CSS 与 JS（Omnibus 包）
- 准备自定义资源：在 Ubuntu 上创建目录并放置文件，例如
- 自定义 CSS：/opt/gitlab/embedded/custom/custom.css
- 自定义 JS：/opt/gitlab/embedded/custom/custom.js
- 编辑 GitLab 配置：
- 打开 /etc/gitlab/gitlab.rb
- 添加或修改：
- gitlab_rails[‘custom_css’] = “/opt/gitlab/embedded/custom/custom.css”
- gitlab_rails[‘custom_js’] = “/opt/gitlab/embedded/custom/custom.js”
- 使配置生效：
- 执行：sudo gitlab-ctl reconfigure
- 必要时重启：sudo gitlab-ctl restart
- 说明：该方法适用于 Omnibus 安装；修改后若未生效，检查路径、权限并再次 reconfigure/restart。升级 GitLab 时，自定义资源可能需要重新应用。
四 使用 Docker 部署时的做法
- 将自定义 CSS/JS 挂载到容器内可访问路径，例如：
- docker-compose.yml 片段：
- volumes:
- ./custom:/opt/gitlab/embedded/custom:ro
- 在容器内编辑 /etc/gitlab/gitlab.rb，设置与上述相同的 custom_css/custom_js 路径。
- 执行容器内或宿主机上的 gitlab-ctl reconfigure 与 gitlab-ctl restart 使变更生效。
五 注意事项与排错
- 变更前备份：备份 /etc/gitlab/gitlab.rb 与自定义资源；升级后按需复核自定义内容。
- 生效路径：完成配置后务必执行 gitlab-ctl reconfigure，必要时 gitlab-ctl restart。
- 不建议直接修改 /var/opt/gitlab/gitlab-ce/public/assets/ 下的生成文件，升级会被覆盖；优先使用 gitlab_rails[‘custom_css’] / [‘custom_js’]。
- 若自定义 CSS/JS 未生效，检查：文件路径与权限（GitLab 运行用户可读）、配置是否写入 gitlab.rb、是否已执行 reconfigure/restart。
