如何修改GitLab字体族？自部署GitLab-ee阿拉伯字体问题求助

方法一：通过管理员后台自定义CSS（推荐） #

• 登录GitLab管理员后台，进入外观设置页面
• 在「自定义CSS」输入框中添加以下代码，将字体替换为你需要的阿拉伯语字体（示例使用Amiri和Noto Naskh Arabic，可根据需求调整）：

body, .gl-font-family-base {
  font-family: 'Amiri', 'Noto Naskh Arabic', sans-serif !important;
}
/* 针对RTL布局的阿拉伯语元素单独优化 */
.gl-text-direction-rtl {
  font-family: 'Amiri', 'Noto Naskh Arabic', serif !important;
}

• 保存设置后，强制刷新浏览器页面（Ctrl+F5）查看效果

方法二：修改GitLab配置文件持久化设置 #

• 编辑GitLab主配置文件/etc/gitlab/gitlab.rb，添加以下配置段：

gitlab_rails['extra_css'] = <<~CSS
  body, .gl-font-family-base {
    font-family: 'Amiri', 'Noto Naskh Arabic', sans-serif !important;
  }
  .gl-text-direction-rtl {
    font-family: 'Amiri', 'Noto Naskh Arabic', serif !important;
  }
CSS

• 执行配置重载命令：

sudo gitlab-ctl reconfigure

• 重启GitLab服务使配置生效：

sudo gitlab-ctl restart

方法三：确保服务器安装了兼容的阿拉伯字体 #

如果服务器缺少合适的阿拉伯语字体，即使设置CSS也无法生效，可按以下步骤安装：

• Debian/Ubuntu系统：

sudo apt install fonts-amiri fonts-noto-arabic

• CentOS/RHEL系统：

sudo dnf install amiri-fonts google-noto-naskh-arabic-fonts

• 安装完成后重启GitLab服务即可

注意事项 #

• 优先选择系统预装或开源免费的阿拉伯字体，避免版权纠纷
• 若自定义CSS未生效，检查浏览器缓存，或尝试使用无痕模式访问
• GitLab版本升级后，后台自定义CSS可能需要重新确认，通过gitlab.rb配置的设置会自动保留

内容的提问来源于stack exchange，提问作者raedshari