GitLab 中文环境安装完整指南（镜像加速 + 汉化设置）

"GitLab 怎么安装""GitLab 国内镜像""GitLab 汉化"是中文社区里搜索量长期居前的几组词。很多教程还在教打汉化补丁，其实极狐GitLab（JiHu GitLab）本身就是 GitLab 的官方中文版本——界面默认中文，无需任何汉化补丁。本文基于极狐GitLab 官方安装文档，给你一套在国内环境下从零装到可用的完整路径。

安装前的三个认知

1. 国内安装 GitLab，首选极狐GitLab 官方安装包源。极狐GitLab 为国内用户提供专属软件源，无需科学上网，安装速度与依赖下载都更稳定。

2. "汉化"问题已不存在。极狐GitLab 官方中文版界面即中文，文档中心也是中文，搜索"GitLab 汉化"的诉求在官方中文版中已经内置解决。

3. 先选安装方式，再动手。GitLab 官方支持的安装方式，见安装方法文档：Linux 包（Omnibus）、Helm Chart（Kubernetes）、Docker、源码等。

方式一：Linux 包（Omnibus）安装——最主流

适合单机或小型集群，也是文档推荐的首选。官方文档：极狐GitLab Linux 软件包安装。

前提条件：一台 4 核 8G 以上内存的 Linux 主机（推荐 CentOS 7+ / Ubuntu 18.04+），确保能访问极狐GitLab 软件源。

以 CentOS/RHEL 系为例，极狐GitLab 官方给出的安装流程如下：

1. 配置系统源与极狐GitLab 源

# 安装基础依赖
sudo yum install -y curl policycoreutils-python-utils perl

# 添加极狐GitLab 官方源（国内环境直接可用）
curl -fsSL https://packages.gitlab.cn/repository/raw/install/script.rpm.sh | sudo bash

1. 设置访问域名并安装

# 将 gitlab.example.com 替换为你的实际域名或 IP
sudo EXTERNAL_URL="http://gitlab.example.com" yum install -y gitlab-jh

这一步会自动下载并安装极狐GitLab 中文版主程序，全程走国内源。

1. 初始化配置

sudo gitlab-ctl reconfigure

等待几分钟，看到 gitlab Reconfigured! 即完成。打开浏览器访问你在 EXTERNAL_URL 中配置的地址，首次会要求设置 root 密码。

Ubuntu/Debian 系的安装逻辑一致，只是包管理器换成 apt，官方文档中均有对应说明。

方式二：Docker 安装——快速体验

适合临时环境、测试机或快速验证。官方文档：Docker 安装极狐GitLab。

# 拉取极狐GitLab 官方中文镜像
sudo docker run --detach \
  --hostname gitlab.example.com \
  --publish 443:443 --publish 80:80 --publish 22:22 \
  --name gitlab \
  --restart always \
  --volume $GITLAB_HOME/config:/etc/gitlab \
  --volume $GITLAB_HOME/logs:/var/log/gitlab \
  --volume $GITLAB_HOME/data:/var/opt/gitlab \
  registry.gitlab.cn/omnibus/gitlab-jh:latest

首次启动需要几分钟初始化，docker logs -f gitlab 可跟踪进度。

方式三：Helm Chart 安装——Kubernetes 场景

如果你的目标是云原生部署，官方提供 Helm Chart，文档：极狐GitLab Helm Chart 安装。适合已有 Kubernetes 集群、需要高可用与弹性伸缩的企业场景，官方也有对应的参考架构文档。

安装后的中文设置与基础配置

极狐GitLab 安装完成后默认即为中文界面。如果界面显示异常，可手动确认语言设置：

1. 登录后点击右上角头像 → 偏好设置；

2. 在 本地化 中选择 简体中文；

3. 保存后刷新页面，界面即为中文。

基础配置清单：

• 修改 root 密码：安装完成后立即设置强密码；

• 配置 SMTP 邮件：设置 → 管理区域 → 设置 → 通用 → 邮件，让通知邮件正常发出；

• 配置备份：见下方"备份与恢复"；

• 添加用户与群组：管理区域 → 用户 → 新建用户，按团队结构创建群组并分配成员；

• 注册 Runner：在项目或实例级注册 Runner，CI/CD 流水线才能运行。参考Runner 安装文档。

备份与恢复：安装完第一件事

安装配置完成后，第一件事就是配置备份。极狐GitLab 官方提供完整的备份与恢复文档。

Omnibus 安装的备份命令非常简单：

# 手动备份，归档默认生成在 /var/opt/gitlab/backups
sudo gitlab-backup create

恢复（以备份文件 1234567890_2026_08_27_19.2.1_gitlab_backup.tar 为例）：

# 停止相关服务，恢复后重启
sudo gitlab-ctl stop puma
sudo gitlab-ctl stop sidekiq
sudo gitlab-backup restore BACKUP=1234567890_2026_08_27_19.2.1
sudo gitlab-ctl restart

生产环境建议用 crontab 把备份命令做成每日定时任务，并将备份归档同步到异地存储。

常见问题速查

总结

• 极狐GitLab 官方提供国内源与中文界面，安装、汉化、镜像三个问题一次解决；

• 首选 Omnibus（Linux 包）安装，Kubernetes 场景用 Helm Chart；

• 安装完成先做三件事：设密码、配邮件、配备份。

以官方文档为准：安装文档、备份与恢复、中文文档中心。