CentOS如何汉化GitLab

CentOS 系统上汉化 GitLab 主要有两种方式，推荐优先使用官方中文支持（适用于 GitLab 10.0+），如果官方汉化不满足需求，再考虑手动安装第三方汉化包。

以下分别介绍这两种方法。

方法一：启用 GitLab 官方中文（推荐）

从 GitLab 10.0 开始，官方已内置简体中文语言支持，无需修改源码。

1️⃣ 修改 GitLab 配置文件

编辑配置文件：

sudo vim /etc/gitlab/gitlab.rb

添加或修改以下内容：

gitlab_rails['default_locale'] = 'zh_CN'

2️⃣ 重新配置并重启 GitLab

sudo gitlab-ctl reconfigure
sudo gitlab-ctl restart

3️⃣ 用户级语言设置（可选）

登录 GitLab → 右上角头像 → Preferences → Localization → 简体中文

✅ 优点：

官方支持，稳定
升级不会破坏汉化
安全性高

❌ 缺点：

部分页面翻译不完整（尤其是新功能）

方法二：安装第三方汉化包（高级）

⚠️ 警告：

汉化包可能 与 GitLab 版本强耦合

升级 GitLab 很可能导致 页面报错或无法启动

生产环境不推荐

1️⃣ 查看 GitLab 版本

cat /opt/gitlab/version-manifest.txt | head -n 1

2️⃣ 下载对应版本的汉化包

以 GitLab 14.x 为例（请替换版本号）：

cd /tmp
git clone https://gitlab.com/xhang/gitlab.git -b v14.10.5-zh

汉化仓库：
https://gitlab.com/xhang/gitlab

3️⃣ 停止 GitLab 服务

sudo gitlab-ctl stop

4️⃣ 备份原文件（非常重要）

cp -r /opt/gitlab/embedded/service/gitlab-rails{,.bak}

5️⃣ 覆盖汉化文件

cp -rf /tmp/gitlab/* /opt/gitlab/embedded/service/gitlab-rails/

6️⃣ 重新配置并启动

sudo gitlab-ctl reconfigure
sudo gitlab-ctl start

常见问题

❓ 汉化后页面空白或 500 错误

汉化包与 GitLab 版本不匹配
建议回滚：

rm -rf /opt/gitlab/embedded/service/gitlab-rails
mv /opt/gitlab/embedded/service/gitlab-rails.bak \
   /opt/gitlab/embedded/service/gitlab-rails
gitlab-ctl restart

❓ 升级 GitLab 后中文失效

第三方汉化会被覆盖
官方中文不会失效

建议

场景	建议
生产环境	✅ 官方中文
学习 / 测试	⚠️ 可尝试汉化包
长期维护	✅ 官方中文

如果你愿意，可以告诉我：

GitLab 版本
是 CE 还是 EE
CentOS 7 还是 8 / Rocky / Alma

我可以给你一套完全对应你系统的汉化方案。