Linux GitLab如何设置

在 Linux 服务器上部署和设置 GitLab，常见有两种方式：
✅ Omnibus 包安装（官方推荐，最常用）
✅ Docker 安装（适合容器化环境）

下面我以 最主流的 Ubuntu / Debian / CentOS 为例，给你一套完整、可操作的 GitLab 安装与基础配置流程。

一、准备工作

1️⃣ 系统要求（建议）

内存：≥ 4GB（2GB 勉强，但会很卡）
CPU：≥ 2 核
磁盘：≥ 20GB
系统：
- Ubuntu 20.04 / 22.04
- Debian 10+
- CentOS 7 / Rocky / AlmaLinux

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

✅ 1. 安装依赖

# Ubuntu / Debian
sudo apt update
sudo apt install -y curl openssh-server ca-certificates tzdata

# CentOS / Rocky
sudo yum install -y curl policycoreutils openssh-server

✅ 2. 添加 GitLab 官方仓库

curl -fsSL https://packages.gitlab.com/setup.sh | sudo bash

✅ 3. 安装 GitLab（重点）

方式一：使用域名（推荐）

sudo EXTERNAL_URL="http://gitlab.example.com" apt install gitlab-ee

替换成你自己的域名或 IP，例如：

sudo EXTERNAL_URL="http://192.168.1.100" apt install gitlab-ee

方式二：先安装后配置

sudo apt install gitlab-ee

✅ 4. 初始化配置

sudo gitlab-ctl reconfigure

⚠️ 这一步时间较长，耐心等待。

三、访问 GitLab

浏览器访问：

http://服务器IP

首次登录：

用户名：root
密码查看方式：

sudo cat /etc/gitlab/initial_root_password

⚠️ 密码只在 24 小时内有效，建议登录后立即修改

四、基础配置（非常重要）

✅ 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'] = "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

修改后执行：

sudo gitlab-ctl reconfigure

五、常用 GitLab 管理命令

# 查看状态
sudo gitlab-ctl status

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

# 查看日志
sudo gitlab-ctl tail

六、Docker 方式安装（可选）

docker run -d \
  --hostname gitlab.example.com \
  --publish 443:443 --publish 80:80 --publish 22:22 \
  --name gitlab \
  --restart always \
  --volume /srv/gitlab/config:/etc/gitlab \
  --volume /srv/gitlab/logs:/var/log/gitlab \
  --volume /srv/gitlab/data:/var/opt/gitlab \
  gitlab/gitlab-ee:latest

七、常见设置建议

✅ 关闭注册（防止乱注册）
Admin → Settings → General → Sign-up restrictions

✅ 配置 SSH / HTTPS
✅ 定期备份：

sudo gitlab-backup create

八、常见问题

❓ 访问慢 / 卡

内存不足
未关闭 Prometheus（可禁用）

❓ 502 错误

gitlab-ctl reconfigure
端口冲突（80 / 8080）

九、我可以继续帮你

你可以直接告诉我： 1️⃣ 你的 Linux 发行版
2️⃣ 是 内网 / 公网 使用
3️⃣ 是否需要 HTTPS / 邮箱 / CI/CD

我可以给你 定制版 GitLab 安装方案 ✅