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.
Как войти
Откройте адрес из письма о готовности. Его можно получить из IP сервера: замените точки на дефисы и добавьте
.fatmetal.net, например45.15.159.206->https://45-15-159-206.fatmetal.net.Администратор уже создан: логин
admin, пароль - пароль этого сервера из личного кабинета Fatmetal, тот же, что для входа по SSH.После входа откройте настройки своего профиля, смените пароль и укажите свою почту. Нажмите
+->Создать репозиторий, задайте имя и оставьте репозиторий приватным; для первого проекта отметьте создание README.Скопируйте 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 с сертификатом. Если нужен собственный домен:
- Создайте у своего DNS-провайдера
A-запись домена на публичный IP этого сервера. - Дождитесь, чтобы
ping ваш-доменпоказывал IP сервера; обновление DNS может занять несколько минут. - По SSH в
/etc/gitea-mp/params.envзамените значениеDOMAINна свое имя безhttps://и пути. Например:sudo sed -i "s/^DOMAIN=.*/DOMAIN='git.example.ru'/" /etc/gitea-mp/params.env. - Выполните
sudo bash /opt/gitea-mp/install.shи дождитесь сообщения о готовности: рецепт обновит адрес Gitea и проверит HTTPS для нового имени. Если он сообщает, что сертификат еще ожидается, сверьте показанный IP с A-записью и дождитесь обновления DNS; Caddy выпустит сертификат автоматически. - Откройте
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 может сокращать срок хранения артефактов, но не увеличивать серверный предел. Нужные результаты сохраняйте отдельно.