Linux GitLab如何快速配置

下面给你一个**“快速上手”的 Linux GitLab 配置方案（以 GitLab CE + Ubuntu / Debian 为例），适合本地服务器 / 内网 / 云服务器**快速部署。

一、准备环境（必要条件）

1️⃣ 系统要求

• Ubuntu 20.04 / 22.04（推荐）
• 最低配置
  • CPU：2 核
  • 内存：4GB 以上（建议 8GB）
  • 磁盘：20GB+

2️⃣ 更新系统

sudo apt update && sudo apt upgrade -y

二、快速安装 GitLab（官方推荐方式）

1️⃣ 安装依赖

sudo apt install -y curl openssh-server ca-certificates tzdata

2️⃣ 添加 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

3️⃣ 安装 GitLab CE

sudo apt update
sudo apt install -y gitlab-ce

三、核心配置（最关键）

1️⃣ 修改配置文件

sudo vim /etc/gitlab/gitlab.rb

✅ 最小可用配置

external_url 'http://gitlab.example.com'

如果是 IP 访问：

external_url 'http://192.168.1.100'

如果是 HTTPS（推荐）：

external_url 'https://gitlab.example.com'

2️⃣ 应用配置（必须执行）

sudo gitlab-ctl reconfigure

⚠️ 第一次会耗时 2–5 分钟

四、访问 GitLab

1️⃣ 浏览器访问

http://服务器IP

2️⃣ 获取 root 初始密码

sudo cat /etc/gitlab/initial_root_password

✅ 登录账号：

用户名：root
密码：上面输出的密码

五、常用快速配置（强烈建议）

1️⃣ 修改 root 密码

登录后：

右上角 → Preferences → Password

2️⃣ 配置中文界面

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

3️⃣ 关闭注册（内网推荐）

Admin → Settings → General → Sign-up restrictions

六、常用管理命令

# 查看状态
sudo gitlab-ctl status

# 重启
sudo gitlab-ctl restart

# 查看日志
sudo gitlab-ctl tail

# 停止
sudo gitlab-ctl stop

七、常见问题速查

❌ 访问慢 / 502

✅ 原因：内存不足
✅ 解决：

• 至少 4GB 内存
• 关闭其他服务

❌ 邮箱发不出去

gitlab_rails['smtp_enable'] = true
gitlab_rails['smtp_address'] = "smtp.qq.com"
gitlab_rails['smtp_port'] = 465
gitlab_rails['smtp_user_name'] = "xxx@qq.com"
gitlab_rails['smtp_password'] = "授权码"
gitlab_rails['smtp_domain'] = "qq.com"
gitlab_rails['smtp_authentication'] = "login"
gitlab_rails['smtp_enable_starttls_auto'] = true
gitlab_rails['smtp_tls'] = true

八、一键总结（最省事）

apt update
apt install -y curl
curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash
sudo EXTERNAL_URL="http://你的IP" apt install -y gitlab-ce

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

• ✅ 系统是 CentOS / Ubuntu / Rocky
• ✅ 是否 内网 / 云服务器
• ✅ 是否需要 HTTPS / SMTP / CI/CD

我可以直接给你一份定制版配置 ✅