怎样配置Linux GitLab

下面以 Linux（Ubuntu / CentOS 为例） 说明如何配置 GitLab（CE 社区版），包括安装、基础配置和常用设置。

一、安装 GitLab（以 GitLab CE 为例）

1️⃣ 准备环境

推荐配置

• CPU：2 核以上
• 内存：4GB 以上（最低 2GB）
• 磁盘：20GB+
• 系统：Ubuntu 20.04 / 22.04 或 CentOS 7/8

2️⃣ Ubuntu 安装 GitLab

# 安装依赖
sudo apt update
sudo apt install -y curl openssh-server ca-certificates tzdata

# 添加 GitLab 仓库
curl -fsSL https://packages.gitlab.com/gpg.key | sudo gpg --dearmor -o /usr/share/keyrings/gitlab-archive-keyring.gpg

echo "deb [signed-by=/usr/share/keyrings/gitlab-archive-keyring.gpg] https://packages.gitlab.com/gitlab/gitlab-ce/ubuntu $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/gitlab_gitlab-ce.list

# 安装 GitLab
sudo apt update
sudo apt install -y gitlab-ce

3️⃣ CentOS 安装 GitLab

# 安装依赖
sudo yum install -y curl policycoreutils-python openssh-server

# 添加 GitLab 仓库
curl -fsSL https://packages.gitlab.com/gpg.key | sudo gpg --dearmor -o /usr/share/keyrings/gitlab-archive-keyring.gpg

cat <<EOF | sudo tee /etc/yum.repos.d/gitlab_gitlab-ce.repo
[gitlab_gitlab-ce]
name=gitlab_gitlab-ce
baseurl=https://packages.gitlab.com/gitlab/gitlab-ce/el/7/\$basearch
repo_gpgcheck=1
gpgcheck=1
enabled=1
gpgkey=https://packages.gitlab.com/gitlab/gitlab-ce/gpgkey
EOF

# 安装
sudo yum install -y gitlab-ce

二、配置 GitLab

1️⃣ 修改配置文件

sudo vim /etc/gitlab/gitlab.rb

常用配置项

# 访问地址（必须）
external_url 'http://gitlab.example.com'

# 邮箱配置（可选）
gitlab_rails['smtp_enable'] = true
gitlab_rails['smtp_address'] = "smtp.qq.com"
gitlab_rails['smtp_port'] = 465
gitlab_rails['smtp_user_name'] = "your@qq.com"
gitlab_rails['smtp_password'] = "password"
gitlab_rails['smtp_domain'] = "qq.com"
gitlab_rails['smtp_authentication'] = "login"
gitlab_rails['smtp_enable_starttls_auto'] = true
gitlab_rails['smtp_tls'] = true

2️⃣ 应用配置

sudo gitlab-ctl reconfigure

⚠️ 第一次执行时间较长，耐心等待。

三、启动与访问 GitLab

1️⃣ 常用命令

sudo gitlab-ctl start
sudo gitlab-ctl stop
sudo gitlab-ctl restart
sudo gitlab-ctl status

2️⃣ 访问 Web 界面

浏览器访问：

http://服务器IP

首次登录会要求设置 root 密码

四、配置防火墙（如开启）

Ubuntu（UFW）

sudo ufw allow 80
sudo ufw allow 22
sudo ufw reload

CentOS（firewalld）

sudo firewall-cmd --permanent --add-service=http
sudo firewall-cmd --reload

五、常用配置优化

1️⃣ 中文界面

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

2️⃣ 关闭注册（企业内网）

gitlab_rails['gitlab_signup_enabled'] = false

3️⃣ 配置 HTTPS（推荐）

external_url 'https://gitlab.example.com'
letsencrypt['enable'] = true
letsencrypt['contact_emails'] = ['admin@example.com']

然后执行：

sudo gitlab-ctl reconfigure

六、备份与恢复

备份

sudo gitlab-backup create

恢复

sudo gitlab-backup restore BACKUP=timestamp

七、故障排查

# 查看日志
sudo gitlab-ctl tail

# 检查配置
sudo gitlab-rake gitlab:check

如果你需要：

• ✅ Docker 方式部署 GitLab
• ✅ GitLab + Nginx 反向代理
• ✅ GitLab Runner（CI/CD）配置
• ✅ 内网离线安装

可以告诉我你的 Linux 版本和使用场景，我可以给你更精准的配置方案。