GitLab давно стал стандартом для команд, которым нужны репозитории кода, задачи и CI/CD в одном месте. Но за облачный аккаунт на gitlab.com приходится либо платить зарубежной картой, либо мириться с лимитами бесплатного тарифа. С 2022 года GitLab.com приостановил продажи новым бизнес-клиентам из России, а в 2026 добавились и чисто технические сложности: сайт периодически плохо открывается, оплата картой российского банка недоступна. Поэтому всё больше команд разворачивают GitLab на собственном сервере: код и данные остаются под контролем, лимитов на CI/CD-минуты нет, а зависимость от чужой инфраструктуры исчезает.
В этой статье разберём, как развернуть GitLab на VPS с нуля: какой сервер понадобится, что нужно установить, какие шаги пройти по порядку и какие ошибки обычно допускают новички. Инструкция подойдёт даже тем, кто раньше не администрировал серверы самостоятельно и никогда не работал с Linux в продакшене.
Что такое GitLab и зачем разворачивать его на своём сервере
GitLab — это платформа для совместной разработки, которая объединяет систему контроля версий Git, баг-трекер, вики и инструменты CI/CD в одном интерфейсе. По сути это среда, где команда хранит код, обсуждает задачи, ревьюит изменения через merge request и автоматически собирает и тестирует проект после каждого коммита. Например, разработчик отправляет изменения в репозиторий, а GitLab сам запускает сборку, прогоняет тесты и сообщает результат прямо в интерфейсе, без ручной проверки.
VPS в этом контексте — это виртуальный сервер, который арендуется у провайдера и работает как отдельный компьютер с собственным IP-адресом и ресурсами, но без необходимости покупать физическое железо. Именно на таком сервере и разворачивается GitLab в этой статье.
Есть два принципиально разных способа его использовать. Первый — 'это облачный аккаунт на gitlab.com, готовый сервис без забот об инфраструктуре, но с ограничениями бесплатного тарифа и зависимостью от условий конкретного провайдера. Второй — self-hosted установка, когда GitLab поднимается на вашем собственном сервере, будь то VPS, выделенная машина или инфраструктура компании.
Self-hosted вариант даёт полный контроль над данными: репозитории физически хранятся там, где вы их разместили, а не на серверах в другой юрисдикции. Это особенно важно, если действуют требования к хранению данных на территории РФ. Плюс исчезают лимиты по CI/CD-минутам и числу приватных проектов, а оплата привязана к обычной аренде сервера, а не к зарубежной подписке.
Из чего состоит GitLab и как он работает
Внутри GitLab работает не одна программа, а связка сервисов, и понимание этой структуры помогает быстрее разбираться в установке и типичных ошибках.
PostgreSQL хранит основную базу данных: пользователей, проекты, задачи, права доступа. Redis отвечает за очереди и кэш, через него проходят фоновые операции. Sidekiq обрабатывает задачи в фоне: отправку писем, обработку веб-хуков, индексацию поиска по коду. Puma — это сервер приложения, который непосредственно обслуживает веб-интерфейс и API. Gitaly хранит и обслуживает сами git-репозитории на уровне файловой системы. Nginx работает как веб-сервер и точка входа для HTTP и HTTPS запросов. Отдельно стоит упомянуть встроенный container registry, куда можно складывать Docker-образы прямо из CI/CD пайплайна, не поднимая для этого отдельный сервис.
Разворачивать всё это вручную по частям не нужно. У GitLab есть три официальных способа установки. Linux package, он же Omnibus, это готовый deb или rpm пакет, который включает все перечисленные компоненты и настраивает их одной командой. Это основной и самый зрелый способ, той же сборкой пользуется gitlab.com. Docker-вариант устанавливает тот же набор сервисов внутри контейнера, удобно для тех, кто уже привык к контейнеризации и хочет проще переносить установку между серверами. Helm chart и Operator существуют для развёртывания в Kubernetes, но требуют отдельных внешних баз данных и оправданы только для крупных инсталляций, для одиночного VPS это избыточно.
Какой VPS нужен для GitLab
Требования к серверу напрямую зависят от размера команды и нагрузки, и здесь разработчики GitLab дают конкретные цифры. Для установки без данных нужно закладывать не менее 40 ГБ дискового пространства, сам пакет весит около 2,5 ГБ, но добавляются база, логи и временные файлы. Дальше объём диска растёт вместе с размером репозиториев, поэтому если в планах хранить крупные бинарные файлы или много истории коммитов, стоит сразу закладывать запас. По процессору минимальный порог — 4 ядра для команд до 500 человек, а для нагрузки до 1000 пользователей или 20 запросов в секунду рекомендуют уже 8 vCPU. Похожая логика с памятью: от 4 ГБ для небольших команд до 16 ГБ при серьёзной нагрузке.
На практике для маленькой команды эти цифры можно немного урезать, но не слишком сильно. На 4 ГБ оперативной памяти GitLab запускается, но работает заметно медленнее, интерфейс подгружается с задержками, а фоновые задачи копятся в очереди. Комфортный старт для команды из нескольких человек — это 4 ядра CPU, 8 ГБ RAM и SSD-накопитель, диски с низкой скоростью отклика заметно сказываются на общей отзывчивости системы.
Отдельно стоит закладывать пропускную способность сети, если команда часто клонирует крупные репозитории или тянет Docker-образы из встроенного registry. Для небольшой команды хватает стандартного канала любого современного VPS, но при активной работе с большими артефактами сборки стоит уточнить у провайдера лимиты трафика.
| Размер команды | CPU | RAM | Диск | Комментарий |
|---|---|---|---|---|
| Pet-проект, 1-5 человек | 2 ядра (4 рекомендуется) | 4-8 ГБ | 40 ГБ SSD | Минимальный старт, возможны задержки в интерфейсе |
| Команда до 20 человек | 4 ядра | 8 ГБ | 60 ГБ SSD | Комфортная работа для большинства сценариев |
| Команда до 100 человек | 4-8 vCPU | 16 ГБ | от 100 ГБ SSD/NVMe | Активный CI/CD, важна скорость диска |
| От 100 человек | 8+ vCPU | 16+ ГБ | от 150 ГБ | Стоит опираться на референсные архитектуры GitLab, возможен вынос базы отдельно |
Таблица 1. Требования к серверу по размеру команды
Serverspace предлагает VPS-серверы с гибкой конфигурацией по CPU, RAM и диску, поэтому под любой из этих сценариев можно подобрать сервер без переплаты за лишние ресурсы, а при росте команды нарастить конфигурацию без переезда на новую площадку.
Как установить GitLab на VPS: пошаговая инструкция
Процесс укладывается в четыре последовательных шага: от подготовки сервера до первого рабочего входа в систему.
Шаг 1. Подготовка сервера
Первым делом нужен сам сервер. Для установки GitLab подходит VPS с Ubuntu 22.04 или 24.04, эти версии официально поддерживаются и чаще всего используются в гайдах. Арендовать такой сервер можно на Serverspace, выбрав конфигурацию под ожидаемую нагрузку команды.
После подключения по SSH систему стоит обновить:
Дальше ставим базовые зависимости, без которых установка GitLab не пройдёт корректно:
Если планируете, чтобы GitLab отправлял письма, например уведомления о задачах или сброс пароля, дополнительно можно поставить Postfix и выбрать при настройке режим Internet Site, указав хостнейм сервера. Заодно стоит открыть в файрволе только нужные порты, обычно это 80, 443 и 22 для SSH, остальное лучше держать закрытым.
Шаг 2. Установка GitLab
Установка через Linux package укладывается в две команды. Сначала добавляем официальный репозиторий GitLab:
Скрипт сам настроит нужный источник пакетов. После этого ставим саму Community Edition, сразу указывая адрес, по которому GitLab будет доступен:
Замените домен в примере на свой. Установка занимает от 5 до 10 минут, за это время автоматически настраиваются PostgreSQL, Redis, Nginx, Puma и Sidekiq, никаких дополнительных действий не требуется.
По завершении важно не потерять начальный пароль администратора. Он лежит в файле:
Этот файл автоматически удаляется через 24 часа после первого запуска настройки, поэтому пароль стоит сразу скопировать и сохранить в безопасном месте, а лучше сразу зайти и сменить его вручную.
Шаг 3. Домен, HTTPS и первый вход
Основные настройки хранятся в файле /etc/gitlab/gitlab.rb. Если нужно поменять адрес сервера или включить HTTPS позже, достаточно отредактировать значение external_url и применить изменения командой:
При указании HTTPS-адреса и настроенном домене GitLab способен автоматически получить сертификат Let's Encrypt, отдельно ничего заказывать не нужно, достаточно чтобы домен уже указывал на IP сервера.
После настройки заходим в браузере по указанному адресу под пользователем root и паролем из предыдущего шага. Первым делом стоит сменить пароль в настройках профиля и в административной панели отключить свободную регистрацию новых пользователей, если GitLab не предназначен для публичного доступа.
Шаг 4. Бэкапы и CI/CD раннер
Резервная копия создаётся одной командой:
Готовые архивы складываются в каталог /var/opt/gitlab/backups/, их стоит периодически копировать на отдельное хранилище, а не оставлять только на том же сервере, иначе при выходе диска из строя пропадёт и сама копия.
Если планируется использовать CI/CD, понадобится хотя бы один раннер, отдельный агент, который выполняет задачи из пайплайнов. Раннер можно поставить на тот же сервер или на отдельную машину, для этого GitLab предоставляет собственный пакет установки и токен регистрации, который берётся в административной панели проекта.
Отдельно стоит взять за привычку регулярно обновлять сам GitLab, новые версии выходят часто и закрывают не только баги, но и уязвимости безопасности. Обновление через Linux package делается той же командой apt upgrade, что и обновление остальной системы, только предварительно стоит свериться с документацией по поводу допустимых версий для перехода, чтобы не пропустить промежуточный релиз.
Плюсы, минусы и ограничения self-hosted GitLab
У self-hosted установки есть очевидные преимущества. Данные остаются на сервере, который контролируете вы, а не третья сторона. Нет искусственных лимитов на количество CI/CD-минут или приватных репозиториев. Оплата сводится к обычной аренде сервера, без привязки к зарубежным способам оплаты, и её проще планировать заранее.
Но есть и обратная сторона. Сервер придётся администрировать самостоятельно: следить за обновлениями, устанавливать патчи безопасности, настраивать резервное копирование и мониторинг нагрузки. Официальная техподдержка от GitLab доступна только на платных тарифах, на бесплатной Community Edition вопросы решаются через сообщество и документацию. Требования к ресурсам заметно выше, чем у более лёгких инструментов, а рост команды означает и рост арендуемой конфигурации сервера, это стоит учитывать при планировании бюджета на инфраструктуру.
Где пригодится свой GitLab: практические сценарии
Веб-студия хранит репозитории десятков клиентских проектов и не хочет, чтобы код лежал на стороннем сервисе с непрозрачными условиями доступа и возможными блокировками аккаунта.
Компания с требованиями к хранению персональных данных на территории РФ разворачивает GitLab внутри своей инфраструктуры, чтобы закрыть регуляторные вопросы без компромиссов по функциональности CI/CD и трекера задач.
DevOps-команда строит CI/CD с частыми сборками и не хочет упираться в лимиты бесплатного облачного тарифа по числу минут в месяц, особенно если пайплайны запускаются десятки раз в день.
Растущий стартап, где число разработчиков увеличивается каждый квартал, закладывает масштабируемую инфраструктуру под self-hosted GitLab заранее, чтобы не переплачивать за подписки позже и не мигрировать репозитории на ходу.
Разработчик поднимает GitLab для личных или учебных проектов, чтобы попробовать полноценный CI/CD и registry без ограничений бесплатного облачного тарифа и разобраться в инструменте на практике.
GitLab или более лёгкая альтернатива: когда что выбрать
Если сервер слабый, а команда небольшая, разумно присмотреться к более лёгким инструментам. Gitea и её форк Forgejo написаны на Go, требуют заметно меньше ресурсов и способны без проблем работать даже на скромном VPS. По функциональности они проще: базовый git-хостинг, задачи, вики и встроенный CI/CD, но без части возможностей полноценного DevOps-стека GitLab, вроде расширенных security-инструментов и сложных прав доступа для крупных организаций.
Для тех, кто ищет готовое решение без администрирования собственного сервера, существуют и российские сервисы. GitFlic предлагает и облачную версию, и бесплатную self-hosted Community Edition, что делает его гибким вариантом для команд разного размера. GitVerse от СберТех работает как облачная платформа с собственным ИИ-помощником, но своего сервера здесь не требуется вовсе, это принципиально другой сценарий по сравнению с self-hosted установкой.
Если задача в том, чтобы получить полноценный DevOps-стек с CI/CD, реестром контейнеров и гибкими правами доступа под полным контролем, GitLab CE на собственном VPS остаётся наиболее сбалансированным выбором.
Частые ошибки при установке и как их избежать
Нехватка памяти в момент reconfigure. Если на сервере слишком мало RAM, PostgreSQL не может выделить нужный объём разделяемой памяти, и настройка падает с ошибкой. Решение — увеличить объём RAM либо временно добавить swap на время установки.
Ошибка 502 при открытии больших diff. Если Workhorse не получает ответ в течение минуты, GitLab отдаёт страницу с 502. Обычно это происходит на очень крупных изменениях в коде, лечится увеличением тайм-аута через параметр proxy_headers_timeout в gitlab.rb.
Слишком длинный адрес сервера ломает Nginx. Если external_url длиннее стандартного лимита, Nginx перестаёт запускаться. Решение — вручную удвоить размер bucket в конфигурации и заново применить reconfigure.
Потерянный пароль администратора. Файл с начальным паролем удаляется через сутки после первого запуска. Если не успели его сохранить и не сменили пароль вручную, восстановить доступ можно только через консоль Rails на сервере.
Конфликт с уже установленным Nginx. GitLab разворачивает собственный веб-сервер, и если на VPS уже стоит другой Nginx на портах 80 и 443, один из них придётся остановить или перенастроить под совместную работу.
Непроверенные бэкапы. Резервную копию создают, но забывают хотя бы раз проверить восстановление на тестовом сервере. В итоге проблему обнаруживают только тогда, когда бэкап уже действительно нужен, а он оказывается неполным или битым.
Заключение
Развернуть GitLab на своём VPS реально даже без большого опыта администрирования, если двигаться по шагам: подготовить сервер, установить пакет, настроить домен и HTTPS, не забыть про бэкапы и раннер для CI/CD. Весь процесс занимает меньше часа активного времени, а результат — полноценная платформа для кода, задач и CI/CD под собственным контролем.
Начать стоит с минимальной конфигурации и постепенно увеличивать ресурсы сервера по мере роста команды, заранее заложив место под резервные копии и мониторинг. Арендовать подходящий VPS под установку можно на Serverspace, выбрав конфигурацию заранее под ожидаемую нагрузку.
Часто задаваемые вопросы (FAQ)
Какой VPS нужен для установки GitLab?
Для небольшой команды рекомендуется сервер с 4 ядрами CPU, 8 ГБ оперативной памяти и SSD-диском от 40–60 ГБ. GitLab может работать и на 4 ГБ RAM, но интерфейс и фоновые задачи будут заметно медленнее. При активном CI/CD и большом количестве репозиториев ресурсы лучше увеличить.
Можно ли установить GitLab на Ubuntu?
Да. Для self-hosted установки хорошо подходят Ubuntu 22.04 и Ubuntu 24.04. GitLab можно развернуть через официальный Linux package, который автоматически устанавливает и настраивает PostgreSQL, Redis, Nginx, Puma, Sidekiq и другие необходимые компоненты.
Нужен ли домен для установки GitLab на VPS?
Для самой установки домен не обязателен, но он рекомендуется для удобного доступа и настройки HTTPS. Домен должен указывать на IP-адрес VPS. После этого GitLab можно настроить на автоматическое получение бесплатного SSL-сертификата Let's Encrypt.
Где найти начальный пароль администратора GitLab?
После установки начальный пароль пользователя root хранится в файле `/etc/gitlab/initial_root_password`. Файл автоматически удаляется через 24 часа, поэтому пароль нужно сразу сохранить, войти в GitLab и заменить его в настройках профиля.
Как создавать резервные копии GitLab?
Резервная копия создаётся командой `sudo gitlab-backup create`. Архивы сохраняются в каталоге `/var/opt/gitlab/backups/`. Их необходимо регулярно переносить на отдельный сервер или объектное хранилище и периодически проверять восстановление на тестовой установке.
Нужен ли GitLab Runner для работы CI/CD?
Да. GitLab Runner выполняет задачи, указанные в CI/CD-пайплайнах: сборку, тестирование, развёртывание и другие команды. Его можно установить на тот же VPS, но при высокой нагрузке или работе с недоверенным кодом безопаснее использовать отдельный сервер.