Debian如何优化GitLab

在 Debian 系统上优化 GitLab，核心目标是在保证服务稳定的前提下，降低资源占用、提升响应速度。下面从 系统、GitLab 配置、数据库、存储、缓存、监控 等方面给你一套实用优化方案。

一、系统层面优化（Debian）

1. 使用官方推荐系统配置

GitLab 官方建议：

用户数	CPU	内存
< 100	2 核	4 GB
100–500	4 核	8 GB
> 500	8 核+	16 GB+

⚠️ 内存 < 4GB 体验会很差

2. 关闭不必要的系统服务

systemctl disable bluetooth
systemctl disable cups
systemctl disable avahi-daemon

3. 调整系统文件描述符

echo "fs.file-max = 100000" >> /etc/sysctl.conf
echo "* soft nofile 65535" >> /etc/security/limits.conf
echo "* hard nofile 65535" >> /etc/security/limits.conf
sysctl -p

二、GitLab 核心配置优化（重点）

编辑配置文件：

vim /etc/gitlab/gitlab.rb

1. 降低并发（低配服务器最重要）

# 减少 Puma（GitLab Web）
puma['worker_processes'] = 2
puma['min_threads'] = 2
puma['max_threads'] = 4

# 减少 Sidekiq（后台任务）
sidekiq['max_concurrency'] = 10

默认配置很高，小机器会直接卡死

2. 禁用不需要的服务

gitlab_rails['gitlab_email_enabled'] = false
gitlab_rails['usage_ping_enabled'] = false
gitlab_rails['sentry_enabled'] = false

# 不使用 GitLab CI Runner
gitlab_ci['runner_token'] = nil

如果你 不用容器镜像库：

gitlab_rails['registry_enabled'] = false

3. 禁用 Prometheus（可选）

如果你的服务器内存 < 8GB：

prometheus_monitoring['enable'] = false

三、数据库优化（PostgreSQL）

1. 限制内存使用

postgresql['shared_buffers'] = "256MB"
postgresql['work_mem'] = "8MB"
postgresql['maintenance_work_mem'] = "32MB"
postgresql['max_worker_processes'] = 2

四、GitLab 存储优化

1. 使用 SSD（强烈推荐）

GitLab 对磁盘 IO 非常敏感。

2. 分离 Git 数据目录

git_data_dirs({
  "default" => {
    "path" => "/data/gitlab/git-data"
  }
})

五、缓存与性能优化

1. 启用 Gitaly 缓存

gitaly['configuration'] = {
  storage: [
    {
      name: "default",
      path: "/var/opt/gitlab/git-data/repositories"
    }
  ]
}

2. 使用 Redis 本地缓存

默认已启用，无需额外配置
可检查：

gitlab-rails console
> Redis.new.info

六、GitLab 常用优化命令

# 重新加载配置
gitlab-ctl reconfigure

# 重启服务
gitlab-ctl restart

# 查看资源占用
gitlab-ctl status
htop

七、监控 GitLab 性能

1. 查看慢请求

gitlab-ctl tail gitlab-rails

2. 查看 Sidekiq 队列

gitlab-rails console
> Sidekiq::Queue.new.size

八、推荐的最小化配置示例（2C4G）

puma['worker_processes'] = 2
sidekiq['max_concurrency'] = 8
postgresql['shared_buffers'] = "256MB"
prometheus_monitoring['enable'] = false
gitlab_rails['registry_enabled'] = false

九、如果不满足条件怎么办？

✅ 推荐替代方案

使用 Gitea（轻量 Git 服务）
使用 Forgejo
GitLab 仅用于 CI/CD，不用 Web UI

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

Debian 版本
服务器配置（CPU / 内存 / 磁盘类型）
用户数量 & 用途（CI / 代码托管 / 镜像仓库）

我可以给你一套 完全定制的 GitLab 优化配置。