GitLab Linux配置教程有吗

当然有！下面给你一份**在 Linux 服务器上安装和配置 GitLab（CE 社区版）**的实操教程，适用于 Ubuntu / Debian / CentOS / Rocky / AlmaLinux 等常见发行版。

一、环境准备

推荐配置

⚠️ GitLab 比较吃内存，不建议低于 4GB。

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

1️⃣ 安装依赖

Ubuntu / Debian

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

CentOS / Rocky / AlmaLinux

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

2️⃣ 添加 GitLab 官方仓库

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

3️⃣ 安装 GitLab CE

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

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

方式二：使用服务器 IP

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

示例 IP 换成你自己的服务器 IP

三、初始化配置

1️⃣ 重新配置 GitLab

sudo gitlab-ctl reconfigure

⏳ 第一次会稍慢（1–3 分钟）

2️⃣ 查看服务状态

sudo gitlab-ctl status

3️⃣ 访问 GitLab

浏览器访问：

http://服务器IP

或

http://你的域名

四、设置管理员密码

1️⃣ 进入控制台

sudo gitlab-rails console

2️⃣ 设置 root 密码

user = User.where(id: 1).first
user.password = 'StrongPassword123'
user.password_confirmation = 'StrongPassword123'
user.save!
exit

登录账号：

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

五、常用配置（重点）

1️⃣ 修改外部访问地址

sudo vim /etc/gitlab/gitlab.rb

修改：

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

重新配置：

sudo gitlab-ctl reconfigure

2️⃣ 配置 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

3️⃣ 修改端口（如 8080）

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

六、常用管理命令

七、防火墙 & 端口

Ubuntu

sudo ufw allow 80
sudo ufw allow 22

CentOS

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

八、常见问题

❌ 502 错误

• 内存不足
• nginx 端口冲突
• gitlab-ctl reconfigure 未完成

❌ 访问很慢

• 服务器内存 < 4GB
• 未关闭 Swap
• 使用 SSD

九、进阶（可选）

✅ GitLab CI/CD
✅ Runner 配置
✅ HTTPS（Let’s Encrypt）
✅ LDAP / 单点登录
✅ Docker 安装方式

如果你愿意，我可以：

• ✅ 针对 Ubuntu 22.04 / CentOS 9 写专属版本
• ✅ 给你 Docker 安装 GitLab 教程
• ✅ 教你 GitLab CI/CD 从零配置

你现在是 学习 / 公司内网 / 生产环境 用？