Быть в курсе
Аватарка автора Редакция Рег.облако
ИнструкцииОблако

Быстрый старт с Gitea: инструкция по установке и использованию

3 марта 2026

23 минуты

Телеграм

ВКонтакте

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

Gitea как раз отвечает этим запросам. В этой статье пошагово разберем, как установить и настроить Gitea на сервере, а также посмотрим на примеры ее использования.

Что такое Gitea

Gitea — это легкая система для хостинга Git-репозиториев, которую устанавливают на собственный сервер. Проект создан как более простая и нетребовательная альтернатива GitLab и GitHub, когда нужен контроль над кодом без лишней инфраструктуры.

Gitea позволяет:

  • хранить и версионировать исходный код;
  • работать с ветками, коммитами и тегами;
  • использовать пул-реквесты и код-ревью;
  • вести задачи и вики-проекты;
  • управлять доступами и ролями пользователей.

Gitea создавалась с прицелом на простоту. Она не перегружена лишними функциями, быстро устанавливается и стабильно работает даже на слабых серверах. Поэтому ее часто выбирают небольшие команды, стартапы и компании, которым нужен собственный Git-сервис без сложной инфраструктуры.

Gitea написана на Go, благодаря чему потребляет минимум ресурсов и запускается практически везде: на VPS, выделенных серверах и локальных машинах для внутреннего использования.

Источник: Freepik. Главный дашборд Gitea: обзор репозиториев, задач и активности команды в едином интерфейсе

Отличия от GitHub/GitLab

Если сравнивать Gitea с GitHub и GitLab, разница в первую очередь заключается не в возможностях Git как такового, а в философии продукта.

GitHub — это в первую очередь облачный сервис с упором на публичные репозитории, комьюнити и интеграцию с внешними сервисами. Он отлично подходит для открытых проектов, интеграций со сторонними сервисами и масштабных сообществ, но предполагает зависимость от внешнего сервиса и его правил.

GitLab позиционируется как универсальная DevOps-платформа. Помимо Git-репозиториев, он включает CI/CD, контейнерный реестр, мониторинг, безопасность и множество дополнительных модулей. Она удобна для крупных команд, но требует больше ресурсов, времени на настройку и администрирование.

Gitea, в отличие от них, не пытается закрыть все проблемы сразу, так как ориентирована на простоту, минимальные требования к ресурсам и полный контроль со стороны пользователя. Она запускается быстро, потребляет минимум памяти и процессорного времени, легко обновляется и подходит для небольших и средних команд, которым важна стабильность и предсказуемость, а не десятки встроенных инструментов.

Критерий Gitea GitHub GitLab
Формат использования Самостоятельный хостинг Облачный сервис Облако и самохостинг
Требования к серверу Низкие Не требуются Средние и высокие
Простота установки Очень высокая Не требуется Средняя
Функциональность из коробки Базовая Средняя, с упором на интеграции Расширенная (CI/CD, DevOps)
Подходит для небольших команд Да Да Не всегда
Подходит для крупных компаний Отчасти Да Да
Контроль над данными Полный Ограниченный Полный при самохостинге
Обновление и сопровождение Простое Не требуется Более сложное
Основной сценарий Внутренние проекты, приватные репозитории Открытые проекты Корпоративная разработка и DevOps

В итоге выбор зависит от задач. Gitea подходит, если нужен простой и независимый Git-сервер. GitHub подойдет для публичных проектов и работы с открытым кодом. GitLab оправдан там, где требуется единая DevOps-платформа с CI/CD и автоматизацией на уровне инфраструктуры.

Источник: Freepik. Сценарий для малых студий: развертывание легкого Git-сервера на одном VPS для команды до 20 человек

Как установить Gitea

Теперь рассмотрим установку Gitea на Ubuntu 24.04. Но тут стоит отметить, что в других дистрибутивах Linux процесс отличается незначительно: меняются отдельные команды и названия пакетов, но общая логика установки остается той же.

Перед началом установки потребуется сервер — это может быть как физическое оборудование, так и виртуальная машина. На нем будет развернут Git-сервис, к которому смогут подключаться пользователи и команды разработчиков. Если у вас пока нет готовой инфраструктуры, можно быстро развернуть сервер в облаке.

Например, с этим поможет Рег.облако — сервис, который предлагает облачные решения и IT‑инфраструктуру для бизнеса. С ним легко протестировать новые идеи, запустить проекты любой сложности и получить профессиональную поддержку на всех этапах.

Шаг 1. Подготовка к установке

Для работы Gitea потребуется база данных — в ней будут храниться репозитории, пользователи, настройки и история изменений. В качестве СУБД используем MariaDB — она хорошо зарекомендовала себя по производительности, стабильности и полностью совместима с MySQL.

Перед установкой первого пакета стоит обновить данные из репозиториев:

Это исключит проблемы при установке пакета из-за отсутствия данных в локальном кеше.

MariaDB устанавливается из стандартных репозиториев Ubuntu. Достаточно выполнить команду:

Система установит сервер базы данных и все необходимые зависимости.

Далее стоит заняться базовой безопасностью MariaDB. Запустите встроенный скрипт безопасной настройки базы данных:

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

Теперь выполните вход в консоль MariaDB под пользователем root:

Введите пароль, который вы задали на предыдущем шаге.

Внутри консоли создайте отдельного пользователя для Gitea. Пример можно изменить под свои требования, ниже используется пользователь gitea_user и пароль StrongPass_2026:

Символ % означает, что пользователь может подключаться к базе с любого хоста. Пароль обязательно замените на собственный и используйте сложную комбинацию.

Создайте базу данных, которая будет использоваться Gitea. В примере используется имя gitea_database:

Кодировка utf8mb4 подходит для хранения текста на любом языке и корректно работает с эмодзи и спецсимволами, если они понадобятся в комментариях или описаниях.

Выдайте пользователю права на работу с созданной базой данных:

Примените изменения прав:

На этом подготовка базы данных завершена. Для выхода из консоли MariaDB используйте сочетание клавиш CTRL+D или команду exit. Сервер базы данных готов к использованию, можно переходить к установке и настройке самой Gitea.

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

Скачайте последнюю стабильную версию Gitea с официального сайта проекта. В нашем примере используется версия 1.22.3 — если нужно, вы можете заменить ее на более актуальную:

Полный список доступных версий можно найти на официальном сайте Gitea.

Сделайте загруженный файл исполняемым:

Затем проверьте, установлен ли Git на сервере. Он необходим для работы Gitea, так как именно Git отвечает за управление репозиториями:

Если Git не установлен, система сообщит об этом, и его потребуется установить:

Чтобы повысить безопасность, мы рекомендуем запускать Gitea от отдельного системного пользователя. Создайте его следующей командой:

В результате будет создан системный пользователь git с домашним каталогом /home/git, под которым в дальнейшем будет работать сервис Gitea. Это изолирует приложение от остальных процессов и упростит администрирование.

Шаг 3. Подготовка директорий Gitea

Для корректной работы Gitea необходимо заранее подготовить структуру каталогов, в которых будут храниться данные, конфигурационные файлы и логи.

Создайте необходимые директории и задайте правильные права доступа.

Выполните команды:

Каталог /var/lib/gitea будет использоваться как основная рабочая директория. В нем хранятся репозитории, вложения, кэш и логи.

Создайте каталог для конфигурационного файла:

Каталог /etc/gitea предназначен для хранения app.ini. Доступ к нему ограничен пользователем root и группой git, что повышает безопасность.

Источник: Freepik. Gitea может запускаться при старте системы

Шаг 4. Размещение исполняемого файла Gitea

Теперь укажите рабочую директорию Gitea и скопируйте бинарный файл в системный каталог, доступный из любого окружения.

Установите переменную окружения для рабочей директории:

Скопируйте бинарный файл в /usr/local/bin, чтобы Gitea была доступна как системная команда:

Шаг 5. Настройка и запуск systemd

Чтобы Gitea автоматически запускалась при старте системы, создайте сервисный файл systemd:

Добавьте следующую конфигурацию:

Этот сервис запускает Gitea от имени пользователя git, задает рабочую директорию и указывает путь к конфигурационному файлу.

Активируйте его и запустите:

Проверьте состояние сервиса и убедитесь, что он запущен без ошибок:

Если статус отображается как active (running), сервер Gitea успешно запущен.

Шаг 6. Завершение установки через веб-интерфейс

Сервис Gitea уже запущен, осталось выполнить финальную настройку через браузер. Откройте адрес http://IP_СЕРВЕРА:3000 — на экране появится мастер установки.

  1. В блоке параметров базы данных укажите значения:
  • Database Type — MySQL
  • Host — оставьте значение по умолчанию
  • Username — gitea_user
  • Password — StrongPass_2026 (или тот пароль, который вы задали)
  • Database Name — gitea_database

Эти данные должны полностью совпадать с параметрами пользователя и базы данных, созданными ранее.

  1. В разделе General Settings допустимо оставить значения по умолчанию. Здесь задаются рабочие пути, базовый URL и сетевые параметры. Их можно изменить позже напрямую в файле app.ini, если потребуется адаптация под домен или прокси-сервер.
  1. В блоке Administrator Account Settings создайте административную учетную запись. Укажите имя пользователя администратора, надежный пароль и контактный email. Этот аккаунт будет использоваться для входа в систему, управления репозиториями, пользователями и настройками Gitea.
  1. В конце нажмите Install Gitea. Система применит указанные параметры, создаст конфигурационный файл и инициализирует базу данных. Страница установки сменится формой входа, где можно авторизоваться под созданным администратором.

На этом установка Gitea завершена.

Источник: Freepik. Настройка Nginx и SSL обеспечит защищенное соединение, шифрование данных и корректную работу Gitea на собственном домене

Как настроить Gitea

Один из первых и самых важных шагов — настройка веб-сервера и HTTPS. Gitea по умолчанию работает на порту 3000 и не предназначена для прямой публикации в интернет без прокси. Оптимальный вариант — использовать Nginx в роли обратного прокси и установить SSL-сертификат.

Настройка доступа к Gitea через домен

Чтобы вы могли работать с Gitea на собственном домене и по защищенному соединению, рекомендуется настроить Nginx и SSL-сертификат. Этот шаг обеспечит шифрование данных, корректную работу веб-интерфейса и нормальное отображение ссылок внутри системы.

Установите Nginx на сервер:

Создайте конфигурационный файл для вашего домена. Имя файла может быть любым:

Добавьте конфигурацию, заменив домен на свой:

Активируйте конфигурацию, создав символическую ссылку:

Чтобы включить HTTPS, установите Certbot и плагин для Nginx:

Запустите Certbot для выпуска SSL-сертификата. В нашем примере используется email admin@example.ru и домен gitea.example.ru — замените их на свои значения:

Certbot автоматически получит сертификат, обновит конфигурацию Nginx и включит HTTPS.

Перезапустите Nginx для применения изменений:

На этом этапе веб-интерфейс Gitea станет доступен по защищенному адресу https://ваш_домен.

Дополнительно рекомендуется откорректировать файл /etc/gitea/app.ini.

В разделе [server] укажите ваш домен вместо IP-адреса в параметрах DOMAIN, SSH_DOMAIN и ROOT_URL.

В разделе [service] можно установить DISABLE_REGISTRATION = true, чтобы закрыть публичную регистрацию пользователей.

Изменив конфигурацию, перезапустите сервис:

Настройка брандмауэра UFW

UFW позволяет централизованно управлять доступом к сервисам и минимизировать поверхность атаки. Настройка займет несколько минут, но существенно повысит безопасность сервера.

Сбросьте текущие правила брандмауэра:

Задайте политики по умолчанию: запретите входящие соединения и разрешите исходящие:

Разрешите доступ к стандартным портам, которые используются для работы сервера и администрирования:

Порт 22 используется для SSH-доступа, а порты 80 и 443 — для работы веб-интерфейса Gitea через Nginx.

Ограничьте доступ к порту 3000, на котором Gitea работает локально. Он должен быть доступен только с самого сервера, а не из внешней сети:

Это гарантирует, что пользователи смогут подключаться к Gitea только через Nginx и HTTPS, а прямой доступ по ip:3000 будет закрыт.

Активируйте брандмауэр и проверьте его статус:

В списке правил должны отображаться разрешенные порты 80, 443 и 22, а также запрет внешнего доступа к порту 3000.

Источник: Freepik. Регулярное резервное копирование данных Gitea обеспечит быстрое восстановление системы при сбоях

Резервное копирование в Gitea

Регулярное резервное копирование — обязательная практика для сохранности репозиториев и служебных данных Gitea. Бэкапы позволяют быстро восстановить систему при сбое, ошибке обновления или человеческом факторе.

Не хотите разбираться с железом? Разверните готовую виртуальную машину в Рег.облако за пару минут. Выберите конфигурацию под свои задачи — от легкой для маленькой команды до мощной для корпоративного использования. Все ресурсы под вашим полным контролем.

Готовый архив с бекапом Gitea можно автоматически загружать в Объектное хранилище S3 от Рег.облако. Это гарантирует сохранность вашего кода и данных даже в случае сбоя основного сервера.

Создание бэкапа

Чтобы сделать резервную копию, воспользуйтесь встроенным инструментом Gitea. Он автоматически соберет все важные данные в один архив — вручную копировать папки не придется.

Переключитесь на пользователя, под которым работает сервис:

Перейдите в каталог, где будет сохранен архив. Мы используем /home/git, вы можете выбрать любой удобный путь:

Запустите создание резервной копии с указанием конфигурационного файла:

Команда создаст архив с полным дампом данных Gitea. Полученный файл окажется в текущей папке — его можно сразу перенести на внешний сервер или загрузить в облачное хранилище.

В состав резервной копии входят:

  • app.ini — конфигурационный файл Gitea (если он расположен вне стандартного каталога custom/);
  • custom/ — пользовательские настройки и кастомизации;
  • data/ — данные приложения, включая вложения, аватары и служебные файлы;
  • repos/ — все Git-репозитории;
  • gitea-db.sql — дамп базы данных;
  • log/ — журналы работы сервиса, не обязательны для восстановления, но полезны для анализа.

Рекомендуется хранить резервные копии вне основного сервера и настраивать их регулярное создание через cron. Это минимизирует риск потери данных и упрощает восстановление системы при любых сбоях.

Восстановление Gitea из резервной копии

Восстановление данных позволяет вернуть Gitea в рабочее состояние при сбое или перенести систему на новый сервер.

Начните с распаковки архива резервной копии. В примере используется файл gitea-dump-id.zip — имя будет отличаться в зависимости от времени создания бэкапа:

Перейдите в каталог с распакованными данными:

Далее восстановите основные компоненты системы.

Конфигурационный файл

Данные приложения

Логи

Git-репозитории

Затем обновите владельца и права доступа. В стандартной конфигурации сервис работает от пользователя git:

Импортируйте дамп базы данных в MariaDB / MySQL. Замените значения переменных на реальные данные вашей базы:

Где $USER — пользователь базы данных, $PASS — пароль пользователя, а $DATABASE — имя базы данных Gitea.

Завершив восстановление файлов и базы данных, запустите сервис Gitea. Если все данные восстановлены корректно, система загрузится в том состоянии, в котором была на момент создания резервной копии.

Источник: Freepik. Gitea позволяет компаниям с регламентами безопасности хранить код в собственной инфраструктуре

Примеры использования Gitea

Gitea выбирают, когда нужен собственный Git-сервис без лишней нагрузки на инфраструктуру и без зависимости от внешних платформ. Рассмотрим конкретные случаи:

Внутренний Git-сервер для небольшой команды

Сценарий для студии, агентства или продуктовой команды на 3-20 человек, где важны приватность и простое администрирование. Gitea закрывает базовые потребности: репозитории, ветки, пул-реквесты, задачи, вики и права доступа. Сервис можно развернуть на одном VPS, а доступ ограничить через домен, SSL и правила брандмауэра.

Подходит, если:

  • код и документация должны храниться внутри компании;
  • требуется быстрый старт без сложной инфраструктуры;
  • есть администратор, который не хочет тратить время на тяжелую DevOps-платформу.

Корпоративная разработка с контролем доступа

В компаниях с регламентами безопасности часто важно держать код в собственной инфраструктуре и контролировать доступы на уровне пользователей и команд. Gitea позволяет создавать организации, команды и выдавать права на репозитории по ролям.

Подходит, если:

  • есть требование хранить репозитории на своих серверах;
  • нужна понятная модель ролей и изоляции проектов;
  • необходимо быстро поднять сервис в закрытой сети.

Git-сервис для учебных проектов и лабораторных работ

Для учебных курсов Gitea удобна как локальная альтернатива публичным платформам. Преподаватель создает организацию и репозитории для групп, выдает доступ студентам и принимает задания через пул-реквесты. В задачах можно вести вопросы и замечания, а в вики — методички.

Подходит, если:

  • важна автономность и простая эксплуатация;
  • нужен единый сервер для группы/курса;
  • требуется структура «организация → команды → репозитории».

Хостинг приватных репозиториев для фрилансера или небольшой студии

Фрилансеры и маленькие команды часто сталкиваются с ситуацией, когда клиент просит хранить код отдельно, или есть несколько проектов с разными доступами. Gitea позволяет держать все репозитории у себя и выдавать доступ точечно, без участия сторонних сервисов.

Подходит, если:

  • нужно разделять проекты между клиентами;
  • требуется приватность и контроль;
  • нужен легкий Git-сервис без подписок и ограничений.

Открытая площадка внутри сообщества

Не все сообщества хотят размещать проекты на крупных платформах. Gitea подходит как независимая площадка: можно публиковать репозитории, принимать пул-реквесты, вести задачи, документировать проект в вики и выпускать релизы. При этом инфраструктура остается под контролем сообщества.

Подходит, если:

  • хочется независимости от внешних условий платформ;
  • нужен собственный домен и единые правила для проектов;
  • важны простота и предсказуемость в администрировании.

Сервер для CI/CD-процессов через внешние инструменты

Gitea не стремится быть универсальной DevOps-платформой, и в этом ее практическое преимущество. Во многих проектах Gitea используют исключительно как хранилище кода, а сборку, тестирование и деплой выносят во внешние инструменты: Jenkins, GitHub Actions Runner (в частных сценариях), Drone CI, GitLab Runner, TeamCity.

Используете Gitea как хранилище кода? Доверьте сборку, тестирование и деплой управляемому Kubernetes от Рег.облако. Получите отказоустойчивый и масштабируемый CI/CD-пайплайн без головной боли с администрированием инфраструктуры.

Подходит, если:

  • CI/CD уже настроен и стабильно работает;
  • требуется сохранить привычные инструменты сборки и деплоя;
  • Gitea нужна только как Git-сервер и интерфейс для команды;
  • важна минимальная нагрузка на сервер и простая архитектура.

Зеркалирование репозиториев и миграция с GitHub/GitLab

Gitea часто используют как резервную площадку или промежуточный этап миграции. Можно перенести репозитории, историю и ветки, а затем настроить зеркалирование. Это снижает риски при переезде и помогает сохранить копию критичных проектов.

Подходит, если:

  • планируется миграция, но нужен переходный период;
  • требуется резервная копия репозиториев в другой инфраструктуре;
  • нужно хранить проекты в закрытом контуре.

Заключение

В статье мы разобрали установку Gitea на Ubuntu, первичную настройку через веб-интерфейс, подключение домена и HTTPS, базовые меры безопасности, резервное копирование и восстановление данных. Также рассмотрели реальные сценарии использования — от внутреннего Git-сервера для команды до работы в связке с внешними CI/CD-системами.

Gitea хорошо подходит для:

  • небольших и средних команд;
  • компаний с требованиями к контролю данных;
  • учебных и внутренних проектов;
  • случаев, когда нужен легкий Git-сервер.

Если вам важны автономность, предсказуемость и полный контроль над инфраструктурой, Gitea становится логичным выбором. Она не навязывает лишние инструменты, легко встраивается в существующие процессы и масштабируется ровно настолько, насколько это действительно нужно.

Источник: Freepik. Gitea подходит для небольших и средних компаний

FAQ

Чем Gitea отличается от GitHub?

Gitea и GitHub решают одну задачу — работу с Git-репозиториями, но подходят к ней по-разному:

  • Размещение. Gitea устанавливается на ваш сервер, GitHub — облачный сервис.
  • Контроль данных. В Gitea все данные хранятся у вас, в GitHub — на стороне платформы.
  • Сложность. Gitea проще в настройке и эксплуатации, GitHub ориентирован на масштаб и экосистему.
  • Функциональность. GitHub предлагает больше интеграций и сервисов, Gitea — только необходимый минимум.
  • Зависимость. Gitea не привязывает к внешнему провайдеру и его правилам.

Если нужен полный контроль над кодом и инфраструктурой — выбирают Gitea; если важны облачный сервис, экосистема и работа с публичными проектами — используют GitHub.

Подходит ли Gitea для бизнеса?

Да, Gitea подходит для бизнеса. Это легкое и экономичное решение с открытым кодом, позволяющее разместить систему управления репозиториями на собственном сервере. Оно обеспечивает контроль над данными, просто в установке и обслуживании, дает базовый набор функций для командной разработки.

Для небольших и средних компаний — хороший вариант; крупным предприятиям может потребоваться доработка или более масштабируемые решения.

Насколько безопасна Gitea?

Уровень защиты напрямую зависит от конфигурации: использование HTTPS, ограничение доступа к сервису, настройка прав пользователей, закрытие служебных портов и регулярные обновления. При соблюдении этих мер Gitea подходит для коммерческого и корпоративного использования.

Какие ограничения есть у Gitea?

Основные из них:

  • нет встроенного CI/CD из коробки, автоматизацию нужно подключать через внешние инструменты;
  • функциональность проще, чем у крупных платформ, отсутствуют продвинутые DevOps-возможности;
  • масштабирование и отказоустойчивость требуют ручной настройки инфраструктуры;
  • экосистема плагинов и интеграций меньше, чем у GitHub или GitLab;
  • администрирование и обновления полностью ложатся на владельца сервера.

Gitea хорошо справляется с задачей Git-сервера, но не предназначена для замены комплексных DevOps-платформ.

Для кого Gitea — лучший выбор?

Gitea — лучший выбор для тех, кому нужен легкий, автономный и управляемый Git-сервер без лишних зависимостей. Она хорошо подходит:

  • небольшим и средним командам, стартапам, студиям и агентствам;
  • компаниям, которым важно хранить код и данные только у себя;
  • внутренним проектам, где не требуется сложная DevOps-инфраструктура;
  • учебным организациям для проведения курсов и лабораторных работ;
  • фрилансерам и разработчикам, которым нужны приватные репозитории без подписки;
  • тем, кто хочет независимости от облачных платформ и гибкости в настройке доступа;
  • командам, где CI/CD уже реализован отдельными инструментами.

Если нужен простой, предсказуемый и автономный Git-сервис, Gitea закрывает эту задачу лучше всего.

Новые статьи