Linux如何初始化GitLab

在 Linux 上初始化 GitLab，通常指安装并首次配置 GitLab（CE/EE），下面按最常见、最稳妥的方式给你一个完整流程（以 Ubuntu / Debian 为主，CentOS/RHEL 也会说明）。

一、准备环境

1️⃣ 系统要求（建议）

内存：≥ 4GB（2GB 会非常卡）
CPU：≥ 2 核
磁盘：≥ 20GB
系统：
- Ubuntu 20.04 / 22.04 ✅
- Debian 10 / 11 ✅
- CentOS 7 / Rocky / Alma ✅

二、安装 GitLab（Omnibus 方式，推荐）

✅ Ubuntu / Debian

1. 安装依赖

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

2. 添加 GitLab APT 源

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

✅ CentOS / Rocky / Alma

sudo yum install -y curl policycoreutils openssh-server
sudo systemctl enable sshd
sudo systemctl start sshd

curl -fsSL https://packages.gitlab.com/gpg.key | sudo gpg --dearmor -o /etc/pki/rpm-gpg/gitlab-gpgkey

sudo tee /etc/yum.repos.d/gitlab_gitlab-ce.repo <<EOF
[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=file:///etc/pki/rpm-gpg/gitlab-gpgkey
EOF

sudo yum install -y gitlab-ce

三、初始化 GitLab（关键步骤）

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️⃣ 初始化 GitLab

sudo gitlab-ctl reconfigure

⚠️ 这一步会：

初始化数据库
配置 Nginx
启动所有服务
第一次会比较慢（2–5 分钟）

四、首次访问 GitLab

1️⃣ 查看初始 root 密码

sudo cat /etc/gitlab/initial_root_password

⚠️ 密码只保留 24 小时

2️⃣ 浏览器访问

http://服务器IP

登录：

用户名：root
密码：上面查到的密码

五、初始化后的基本配置（强烈建议）

✅ 1. 修改 root 密码

登录后：

右上角 → Preferences → Password

✅ 2. 配置中文界面

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

✅ 3. 关闭注册（可选）

Admin → Settings → General → Sign-up restrictions

取消 ✅ Sign-up enabled

六、常用 GitLab 管理命令

# 查看状态
sudo gitlab-ctl status

# 启动 / 停止 / 重启
sudo gitlab-ctl start
sudo gitlab-ctl stop
sudo gitlab-ctl restart

# 查看日志
sudo gitlab-ctl tail

七、常见问题

❌ 访问 502

原因：

内存不足
服务未完全启动

解决：

sudo gitlab-ctl restart
free -h

❌ 端口冲突（80 / 8080）

修改端口：

external_url 'http://ip:8080'
nginx['listen_port'] = 8080

然后：

sudo gitlab-ctl reconfigure

八、进阶（可选）

✅ 使用 Docker 安装
✅ 配置 HTTPS + Let’s Encrypt
✅ 配置邮件（SMTP）
✅ 迁移 GitLab 到新服务器
✅ 配置 CI/CD Runner

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

✅ 系统版本
✅ 是否用 Docker
✅ 是否要 HTTPS
✅ 是否内网 / 公网

我可以给你完全定制化的 GitLab 初始化方案。