Giteav28.3.0

Git-хостинг для команды: репозитории, задачи, ревью кода и релизы - альтернатива GitHub и GitLab.

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

После создания сервера установка поднимает Gitea со встроенной базой, заводит администратора и выпускает сертификат Let's Encrypt для адреса сервера. Ориентир по проверке 28.2.0 - около пяти минут; дождитесь уведомления о готовности. О ходе установки приходят уведомления; журнал на сервере - /var/log/gitea-mp.log.

Что внутри

Gitea 28.3.0
репозитории, задачи, ревью изменений, вики, релизы и реестр пакетов; журнал действий команды включен и доступен в бесплатной редакции.
Git 2.54.0 в образе Gitea
прием и выдача кода по HTTPS и SSH; для Git SSH используется порт 2222, для управления сервером остается 22.
SQLite 3
встроенная база пользователей, задач и настроек; отдельный сервер базы данных не требуется.
Caddy 2.11.7
HTTPS, выпуск и продление сертификата Let's Encrypt; веб-порт Gitea 3000 доступен только на 127.0.0.1.

Работают два контейнера: Gitea и Caddy. Русский язык стоит первым в списке языков; часть новых строк интерфейса остается на английском.

Безопасность

  • Администратор создан установкоймастер установки заблокирован, посторонний не займет учетную запись, открыв адрес первым.
  • Регистрация и просмотр без входа закрытыучастников создает администратор, анонимный посетитель не получает доступ к содержимому сервера.
  • Собственные ключи шифрованиягенерируются при первом запуске и сохраняются при повторном; файлы с параметрами и секретами доступны только root.
  • Защита SSH через fail2banпосле пяти неудачных попыток входа в SSH самой VM адрес блокируется на час.
  • HTTPS с автопродлениемCaddy шифрует соединение браузера и Git HTTPS; включены HSTS, запрет определения типа содержимого браузером и ограничение передачи Referer.
  • Ограничения исходящих Git-запросовштатный режим не разрешает импорт с внутренних адресов; импорт с loopback отклонен при проверке рецепта.
  • Аудит действий включенсобытия записываются в базу, чтобы администратор мог разобрать изменения и действия пользователей.
  • Версия 28.3.0 с исправлениями безопасностизакрыта CVE-2026-113429 (high, CVSS 8.7): при открытии прямой ссылки на подложенный артефакт Actions в браузере посетителя мог выполниться чужой код. Для атаки требовалась возможность загрузить артефакт через Actions.

Как войти

  1. Откройте адрес из письма о готовности. Его можно получить из IP сервера: замените точки на дефисы и добавьте .fatmetal.net, например 45.15.159.206 -> https://45-15-159-206.fatmetal.net.

  2. Администратор уже создан: логин admin, пароль - пароль этого сервера из личного кабинета Fatmetal, тот же, что для входа по SSH.

  3. После входа откройте настройки своего профиля, смените пароль и укажите свою почту. Нажмите + -> Создать репозиторий, задайте имя и оставьте репозиторий приватным; для первого проекта отметьте создание README.

  4. Скопируйте HTTPS-адрес репозитория из интерфейса. Для SSH сначала добавьте свой открытый ключ в настройках профиля, раздел ключей SSH, затем используйте адрес с портом 2222 из репозитория.

Важно

Для писем Gitea задайте параметры своего почтового провайдера командой sudo nano /etc/gitea-mp/params.env: SMTP_HOST, SMTP_PORT, SMTP_USER, SMTP_PASSWORD, SMTP_FROM. Рецепт использует STARTTLS, порт по умолчанию 587. После изменения выполните sudo bash /opt/gitea-mp/install.sh и отправьте тестовое письмо из администрирования Gitea. Без настроенного SMTP уведомления о задачах и восстановление пароля по почте не работают. Уведомления о ходе установки отправляются отдельно и не требуют этого SMTP.

Настройте регулярную резервную копию всего /opt/gitea, включая gitea, app.env и secrets.env. Перед файловой копией остановите контейнеры командой cd /opt/gitea && sudo docker compose stop, после копии запустите sudo docker compose up -d --wait из того же каталога. Архив содержит ключи и пароли, храните его в закрытом месте отдельно от сервера. Команды создания архива и восстановления приведены в разборе.

Лицензия

Gitea OSS распространяется по MIT. Лицензионный ключ и покупка мест для участников не нужны; коммерческая поддержка и функции Enterprise в эту установку не входят.

Свой домен

Сразу после установки доступен адрес из IP с сертификатом. Если нужен собственный домен:

  1. Создайте у своего DNS-провайдера A-запись домена на публичный IP этого сервера.
  2. Дождитесь, чтобы ping ваш-домен показывал IP сервера; обновление DNS может занять несколько минут.
  3. По SSH в /etc/gitea-mp/params.env замените значение DOMAIN на свое имя без https:// и пути. Например: sudo sed -i "s/^DOMAIN=.*/DOMAIN='git.example.ru'/" /etc/gitea-mp/params.env.
  4. Выполните sudo bash /opt/gitea-mp/install.sh и дождитесь сообщения о готовности: рецепт обновит адрес Gitea и проверит HTTPS для нового имени. Если он сообщает, что сертификат еще ожидается, сверьте показанный IP с A-записью и дождитесь обновления DNS; Caddy выпустит сертификат автоматически.
  5. Откройте https://ваш-домен. Логин admin, пароль прежний: пароль сервера из личного кабинета либо тот, на который вы сменили его в Gitea. Репозитории и задачи сохраняются; скопируйте новые HTTPS/SSH-адреса из интерфейса и обновите Git remote на своих компьютерах.

Требования

Тариф CPU2-RAM4-DISK50 подходит для начала работы с кодом, задачами и ревью без исполнителя сборок. В замере Gitea 28.1.0 в простое занимала около 95 МиБ RAM, Caddy - еще 21 МиБ; импорт полной истории Caddy поднял наблюдаемую память Gitea до 114 МиБ. Это проверка одного пользователя, а не предел вместимости команды.

Если требуется больше памяти для тяжелых операций с репозиториями или нескольких одновременных задач, выбирайте CPU4-RAM8-DISK100. Ресурсы исполнителя CI рассчитывайте отдельно по своим сборкам.

Подробный разбор с замерами и рабочим циклом команды в Базе знаний →

CI/CD

Сервер Gitea Actions включен. Для выполнения workflow подключите отдельный Gitea Runner к публичному HTTPS-адресу Gitea; исполнитель в рецепт не входит. Токен регистрации получите по SSH командой cd /opt/gitea && sudo docker compose exec -T -u git server gitea actions generate-runner-token, зарегистрируйте исполнитель этим токеном и настройте метки окружения для своих заданий. В разборе показан рабочий цикл от ветки до результата сборки.

Для задач из недоверенных веток используйте изолированного исполнителя без доступа к Docker самого Git-сервера. Завершенные запуски Actions удаляются через 400 дней вместе с оставшимися логами и артефактами; у логов и артефактов есть отдельные, более короткие сроки хранения. Значение retention-days в workflow может сокращать срок хранения артефактов, но не увеличивать серверный предел. Нужные результаты сохраняйте отдельно.

Gitea585 ₽/месЗапустить →