Linux下GitLab怎么设置

在 Linux 下设置 GitLab（CE 社区版，生产环境常用），一般推荐 Omnibus 安装方式，简单、稳定。下面按 步骤 + 常见配置 给你一套完整说明（示例以 Ubuntu / Debian 为主，CentOS/RHEL 也有说明）。

一、准备环境（非常重要）

1️⃣ 系统要求

内存：至少 4GB（2GB 会很卡）
CPU：2 核及以上
磁盘：至少 20GB

2️⃣ 系统更新

# Ubuntu / Debian
sudo apt update && sudo apt upgrade -y

# CentOS / RHEL
sudo yum update -y

二、安装 GitLab（Omnibus）

✅ Ubuntu / Debian

1️⃣ 安装依赖

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

2️⃣ 添加 GitLab 官方源

curl 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

sudo apt update
sudo apt install -y gitlab-ce

✅ CentOS / RHEL

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

curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.rpm.sh | sudo bash
sudo yum install -y gitlab-ce

三、初始化配置（最关键）

1️⃣ 修改 GitLab 配置文件

sudo vim /etc/gitlab/gitlab.rb

必改项：访问地址

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

⚠️ 如果是 IP：

external_url 'http://192.168.1.100'

2️⃣ 应用配置

sudo gitlab-ctl reconfigure

⚠️ 第一次执行会较长时间（几分钟）

四、访问 GitLab

浏览器访问：

http://服务器IP

设置 root 密码

首次访问会要求设置 root 用户密码。

登录：

用户名：root
密码：你刚设置的

五、常用 GitLab 管理命令

# 查看状态
sudo gitlab-ctl status

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

# 查看日志
sudo gitlab-ctl tail

六、常见配置调整（非常实用）

✅ 修改端口（如 8080）

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

然后执行：

sudo gitlab-ctl reconfigure

✅ 配置邮箱（SMTP）

gitlab_rails['smtp_enable'] = true
gitlab_rails['smtp_address'] = "smtp.qq.com"
gitlab_rails['smtp_port'] = 465
gitlab_rails['smtp_user_name'] = "123456@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

✅ 允许 HTTPS（SSL）

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

七、防火墙 & 端口

Ubuntu

sudo ufw allow 80
sudo ufw allow 22

CentOS

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

八、卸载 GitLab（如有需要）

sudo gitlab-ctl uninstall
sudo apt remove gitlab-ce -y

九、你接下来可能关心的

我可以帮你进一步讲：

✅ GitLab 和 GitLab Runner 配置（CI/CD）
✅ GitLab 迁移 / 备份 / 恢复
✅ LDAP / 邮箱 / 权限管理
✅ 内网私有 GitLab 最佳实践
✅ Docker 方式部署 GitLab

告诉我你现在是 学习 / 公司内网 / 生产环境 用？我可以按场景给你一套更合适的配置 ✅