debian装gitlab要注意什么

在 Debian 上安装 GitLab（通常指 GitLab CE / EE 官方 Omnibus 包）时，有几个非常关键的点容易踩坑。下面按「重要性 + 实操建议」给你总结。

一、安装前的核心注意事项（最重要）

1️⃣ 系统版本要匹配

GitLab 对 Debian 版本要求严格：

✅ 推荐：Debian 12 (bookworm)
❌ 不推荐：Debian 9 / 旧系统

检查：

cat /etc/os-release

2️⃣ 服务器配置不能太低（非常常见坑）

GitLab 非常吃资源：

⚠️ 内存 < 4G 基本跑不动（会 OOM）

查看内存：

free -h

3️⃣ 端口冲突（80 / 443 / 22）

GitLab 默认占用：

• 80 → Web
• 443 → HTTPS
• 22 → SSH

如果你已有：

• Nginx
• Apache
• SSH 改过端口

⚠️ 会直接冲突

解决方式：

• 改 GitLab 端口
• 或用反向代理（推荐）

二、安装方式推荐（Omnibus 最省事）

✅ 官方 Omnibus（强烈推荐）

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

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

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

安装完：

sudo gitlab-ctl reconfigure

三、安装后必须做的事

1️⃣ 修改 root 密码

sudo gitlab-rake "gitlab:password:reset[root]"

2️⃣ 配置域名（非常重要）

编辑：

sudo nano /etc/gitlab/gitlab.rb

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

然后：

sudo gitlab-ctl reconfigure

3️⃣ 防火墙 & 安全组

放行：

sudo ufw allow 80
sudo ufw allow 443
sudo ufw allow 22

云服务器还要开安全组

四、HTTPS（强烈建议）

自动证书（推荐）

letsencrypt['enable'] = true
letsencrypt['contact_emails'] = ['admin@example.com']

五、常见坑总结（血泪经验）

❌ 用 Docker 但不映射 volume → 数据全丢
❌ 内存太小 → 502 / 500
❌ 改了 SSH 端口但 GitLab 没改
❌ 没备份就升级
❌ 用 root 跑 GitLab（本身没问题，但服务器不安全）

六、备份与升级（必须知道）

备份

sudo gitlab-rake gitlab:backup:create

升级顺序（很重要）

不能跨大版本升级

15 → 16 → 17

七、什么时候不该用 GitLab？

• 只是想托管代码 → Gitea 更轻
• 服务器 < 2G → 不推荐
• 纯学习 → 可用 Docker 版

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

• Debian 版本
• 服务器配置
• 是否用域名 / HTTPS
• 是否已有 Nginx

我可以直接给你一份可直接用的配置。