Новости
Обновление услуги LLM: управление API-ключами, моделями и расходами
AA
Artemy Arhipov
июля 25, 2026
Обновлено августа 3, 2026

Как развернуть GitLab на VPS

Как развернуть GitLab на VPS

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 систему стоит обновить:

sudo apt update && sudo apt upgrade -y

Дальше ставим базовые зависимости, без которых установка GitLab не пройдёт корректно:

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

Если планируете, чтобы GitLab отправлял письма, например уведомления о задачах или сброс пароля, дополнительно можно поставить Postfix и выбрать при настройке режим Internet Site, указав хостнейм сервера. Заодно стоит открыть в файрволе только нужные порты, обычно это 80, 443 и 22 для SSH, остальное лучше держать закрытым.

Шаг 2. Установка GitLab

Установка через Linux package укладывается в две команды. Сначала добавляем официальный репозиторий GitLab:

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

Скрипт сам настроит нужный источник пакетов. После этого ставим саму Community Edition, сразу указывая адрес, по которому GitLab будет доступен:

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

Замените домен в примере на свой. Установка занимает от 5 до 10 минут, за это время автоматически настраиваются PostgreSQL, Redis, Nginx, Puma и Sidekiq, никаких дополнительных действий не требуется.

По завершении важно не потерять начальный пароль администратора. Он лежит в файле:

cat /etc/gitlab/initial_root_password

Этот файл автоматически удаляется через 24 часа после первого запуска настройки, поэтому пароль стоит сразу скопировать и сохранить в безопасном месте, а лучше сразу зайти и сменить его вручную.

Шаг 3. Домен, HTTPS и первый вход

Основные настройки хранятся в файле /etc/gitlab/gitlab.rb. Если нужно поменять адрес сервера или включить HTTPS позже, достаточно отредактировать значение external_url и применить изменения командой:

sudo gitlab-ctl reconfigure

При указании HTTPS-адреса и настроенном домене GitLab способен автоматически получить сертификат Let's Encrypt, отдельно ничего заказывать не нужно, достаточно чтобы домен уже указывал на IP сервера.

После настройки заходим в браузере по указанному адресу под пользователем root и паролем из предыдущего шага. Первым делом стоит сменить пароль в настройках профиля и в административной панели отключить свободную регистрацию новых пользователей, если GitLab не предназначен для публичного доступа.

Шаг 4. Бэкапы и CI/CD раннер

Резервная копия создаётся одной командой:

sudo gitlab-backup create

Готовые архивы складываются в каталог /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, но при высокой нагрузке или работе с недоверенным кодом безопаснее использовать отдельный сервер.

Вам также может быть интересно...