如何解决Linux GitLab卡顿

Linux 上的 GitLab 卡顿通常由 资源不足、配置不合理或访问量大 导致。可以从 服务器资源、GitLab 配置、访问方式、系统层面 四个方向排查和优化。

一、先确认卡顿原因（非常关键）

1️⃣ 查看服务器资源

top
htop
free -h
df -h

重点看：

• CPU 是否长期 > 80%
• 内存是否接近耗尽（swap 被大量使用）
• 磁盘是否满（尤其是 /var 分区）

✅ GitLab 官方最低要求：

• CPU：4 核+
• 内存：8GB 起步（强烈建议 16GB）

二、最常见原因 & 解决方案

✅ 1. 内存不足（最常见）

GitLab 非常吃内存（gitlab-rails、sidekiq、gitaly 等）。

临时释放内存

sync && echo 3 > /proc/sys/vm/drop_caches

永久优化（推荐）

编辑 GitLab 配置：

vim /etc/gitlab/gitlab.rb

限制部分服务内存（示例）：

sidekiq['max_concurrency'] = 10
gitlab_rails['env'] = {
  'MALLOC_ARENA_MAX' => '2'
}

然后：

gitlab-ctl reconfigure
gitlab-ctl restart

✅ 2. GitLab 配置不合理（默认配置太重）

减少 Unicorn / Puma 进程数

GitLab 13+ 默认使用 Puma

puma['worker_processes'] = 2   # 根据 CPU 核数调整
puma['min_threads'] = 1
puma['max_threads'] = 2

4 核 8G 建议 worker = 2~3

✅ 3. Gitaly 占用 CPU 高

Gitaly 负责 Git 操作，仓库多时很吃资源。

优化建议

• 减少大仓库数量
• 启用 GitLab 的 Gitaly 集群（企业版）
• 限制并发：

gitaly['concurrency'] = [
  { "rpc" => "GetTreeEntries", "max" => 5 }
]

✅ 4. Sidekiq 队列堆积（后台任务卡）

查看队列：

gitlab-ctl tail sidekiq

重启 Sidekiq：

gitlab-ctl restart sidekiq

三、数据库 & 存储优化

1️⃣ PostgreSQL 卡顿

检查慢查询：

gitlab-ctl pg-ctl status

优化：

postgresql['shared_buffers'] = "512MB"
postgresql['max_connections'] = 200

2️⃣ 磁盘 IO 瓶颈（非常常见）

检查 IO

iostat -x 1

优化建议

• Git 仓库目录放到 SSD
• 避免 /var/opt/gitlab 在机械盘
• 关闭 swap（如果内存够）：

swapoff -a

四、网络 & 访问层面

1️⃣ Git Clone 很慢

• 使用 SSH 而不是 HTTPS
• 避免 clone 整个历史：

git clone --depth=1

2️⃣ 大量 CI/CD 导致卡顿

• 减少并发 Runner
• 限制 CI 任务数量

gitlab_ci['max_active_pipelines'] = 10

五、系统级优化（Linux）

1️⃣ 文件句柄数

ulimit -n

建议：

echo "fs.file-max = 100000" >> /etc/sysctl.conf
sysctl -p

2️⃣ 禁用不必要的服务

gitlab-ctl status

关闭不需要的组件（如 Mattermost、Prometheus）：

mattermost['enable'] = false
prometheus_monitoring['enable'] = false

六、快速排查清单（推荐）

✅ 内存 ≥ 8G
✅ CPU ≥ 4 核
✅ 磁盘不是机械盘
✅ Puma worker 不过高
✅ 没有大量 CI 并发
✅ 没有 swap 被大量使用

七、如果还是卡

你可以把下面信息发我，我可以帮你精确定位：

1. 服务器配置（CPU / 内存 / 磁盘类型）
2. GitLab 版本
3. 是 页面卡、Git 操作慢、还是 CI 卡
4. top 或 htop 截图
5. 是否使用 Docker / K8s

我可以直接给你 一份针对你环境的 gitlab.rb 优化配置。