怎么在Debian搭建GitLab

在 Debian 上搭建 GitLab（官方推荐方式）主要有两种选择：
✅ Omnibus 包安装（最常用、最简单）
✅ Docker 安装（适合容器化环境）

下面我先给你 最推荐、最稳定 的 Omnibus 安装方式，适合生产环境。

一、准备工作

1️⃣ 系统要求（官方建议）

• Debian 11 (Bullseye) 或 Debian 12 (Bookworm)
• 最低配置
  • CPU：2 核
  • 内存：4GB 以上（强烈建议 8GB）
  • 磁盘：20GB 以上（视仓库大小而定）

⚠️ GitLab 本身比较吃内存，低于 4GB 会非常卡

2️⃣ 更新系统

sudo apt update
sudo apt upgrade -y

二、安装依赖

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

三、安装 GitLab（Omnibus）

1️⃣ 添加 GitLab 官方仓库

curl https://packages.gitlab.com/gpg.key | sudo apt-key add -

curl -fsSL https://packages.gitlab.com/install/repositories/gitlab/gitlab-ee/script.deb.sh | sudo bash

如果你想要 CE（社区版），把 gitlab-ee 改成 gitlab-ce

2️⃣ 设置域名并安装

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

✅ 改成你自己的域名或 IP 示例：

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

四、配置 GitLab

1️⃣ 初始化配置

sudo gitlab-ctl reconfigure

⏳ 这一步时间较长，耐心等待

2️⃣ 查看初始密码

sudo cat /etc/gitlab/initial_root_password

✅ 只显示一次
默认用户名：root

3️⃣ 访问 GitLab

在浏览器中打开：

http://你的IP或域名

登录：

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

五、常用管理命令

查看状态

sudo gitlab-ctl status

重启 GitLab

sudo gitlab-ctl restart

查看日志

sudo gitlab-ctl tail

六、可选配置

✅ 修改监听端口

编辑：

sudo nano /etc/gitlab/gitlab.rb

修改：

external_url 'http://your-ip:8080'

然后：

sudo gitlab-ctl reconfigure

✅ 开启 HTTPS（推荐）

sudo nano /etc/gitlab/gitlab.rb

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

七、Docker 安装方式（可选）

如果你更熟悉 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

八、常见问题

❌ 内存不足

• 推荐 8GB RAM
• 或修改配置减少 Sidekiq / Puma 进程

❌ 访问慢

• 关闭 Swap
• 检查 DNS
• 使用 SSD

九、适合你吗？

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

• Debian 版本
• 是 本地 / 云服务器
• 是否需要 HTTPS / 邮箱 / CI/CD

我可以直接给你一份 定制安装方案 ✅