Gitea
Gitea - аналог GitHub для команды, которая хочет хранить код, вести задачи и обсуждать изменения на своем сервере. Развернули 28.1.0 на Fatmetal Cloud Server, замерили память и проверили Git, запросы на слияние и результат сборки.
Вердикт
- команде, которой нужны приватный код, обсуждение изменений и задачи вместо сложной платформы GitLab
- разработчику, который хочет забирать репозитории с GitHub на собственную машину
- отделу, который рассчитывает переехать с GitLab без изменения процессов
- заказчику, который ждет готовые исполнители сборок вместе с Git-сервером
Что Gitea заменяет в ежедневной разработке
Разработчик отправляет ветку, открывает запрос на слияние, коллега смотрит diff и обсуждает строки. Рядом живут задачи, релизы и результаты сборок. Для такого цикла полноценный GitLab нужен не каждой команде.
Новые продажи GitLab Premium в России приостановлены. Gitea OSS не требует покупки зарубежной лицензии и платы за каждого участника; оплачивать и обслуживать нужно свой сервер и копии.
На стенде создали приватный репозиторий, отправили изменения по HTTPS и SSH, связали задачу с запросом на слияние. В интерфейсе видны файлы и история, а доступ к Git не зависит от веб-редактора.
Gitea написана на Go и распространяется под MIT. Коммерческая поддержка продается отдельно.
Gitea, GitLab и платный GitHub
Начните со списка необходимых процессов. Если команда использует Git, задачи и ревью, сравнивайте именно их. Функции платных редакций GitLab не появляются автоматически от замены сервера.
| Продукт | Оплата | Что учесть |
|---|---|---|
| Gitea OSS | Лицензия 0; наш сервер 500 руб/мес | Код и копии обслуживаете сами |
| GitLab CE | Лицензия 0; своя инфраструктура | Более широкая платформа; исполнитель CI также отдельный |
| GitLab Premium | 29 $ за пользователя в месяц, оплата за год | Международный прайс, новые продажи в РФ приостановлены |
| GitHub Team | 4 $ за пользователя в месяц, условие первых 12 месяцев | Данные в облаке; существует бесплатный план |
Цены проверены 15 октября 2026 по GitLab и GitHub. GitHub не объявлял общего запрета для всех жителей России. Условия санкций и оплаты проверяйте для своей организации; российский VPS оплачивается в рублях.
Здесь нет обещания экономии подписки: GitLab CE и бесплатный GitHub тоже стоят ноль. Свой сервер выбирают ради места хранения и достаточного набора процессов.
Сервер хранит код, исполнитель запускает сборки
В этой установке работают два контейнера: Gitea со встроенной SQLite и Caddy для HTTPS. Репозитории, база и конфигурация лежат в каталоге /opt/gitea/gitea. Внешняя база для показанного сценария не нужна.
Gitea Actions хранит описание workflow, очередь, журнал и артефакты. Задания забирает отдельная программа Gitea Runner. Серверное приложение не выполняет произвольные команды проекта само по себе.
Подключенный на стенде Runner 5.1.0 выполнил проверку README и сохранил файл результата. Этот файл скачали из интерфейса. Для рабочих сборок выделите исполнителю отдельную машину: доступ к Docker дает широкие права на ее содержимое.
Какой сервер выбрать
Для самостоятельной установки возьмите CPU2-RAM4-DISK50: 2 vCPU, 4 ГБ RAM и 50 ГБ диска за 500 руб/мес. На этом тарифе проверены код, ревью и импорт полноценного проекта.
Образы Gitea и Caddy занимают около 354 МБ вместе. Чистый сервер после установки занял 2,1 ГБ диска. Остальное место остается под репозитории и резервные копии, которые следует хранить также вне этой машины.
Сервер сборок считайте отдельно от Git-хостинга: его потребление определяют компилятор, зависимости и одновременные задания. Сложность сборки не определяется размером самого Git-сервера.
В маркетплейсе Fatmetal
Не хотите ставить руками?
Этот стек есть в маркетплейсе Fatmetal - можно не повторять установку из этого разбора вручную. Заказываете сервер, за пару минут получаете рабочий домен, валидный TLS и файл с доступами.
Рекомендуемая конфигурация: CPU2-RAM4-DISK50
Развертывание на Fatmetal Cloud Server
Нужны чистая Debian 13, доменное имя и доступ root. После входа по SSH выполните sudo -i. Команды ниже создают сервер без открытой регистрации и без почты; установщик в браузере не требуется.
Перед заказом готового приложения сверьте его версию: ниже используется 28.1.0, а сервер с 1.27.3 требует обновления.
Установите Docker из репозитория Debian
Начните с чистой Debian 13 и выполняйте команды от root. Официальный репозиторий нужен для Engine и плагина Compose; пакеты Docker из разных источников не смешивайте.
apt-get update && apt-get install -y ca-certificates curl openssl install -m0755 -d /etc/apt/keyrings curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc chmod a+r /etc/apt/keyrings/docker.asc echo 'deb [signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian trixie stable' > /etc/apt/sources.list.d/docker.list apt-get update && apt-get install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin systemctl enable --now dockerЗадайте домен и создайте секреты
Замените ваш-домен своим именем с A-записью на сервер. Откройте TCP 80, 443 и 2222. Пароль администратора и ключи будут храниться в закрытых файлах каталога установки.
mkdir -p /opt/gitea && cd /opt/gitea DOMAIN=ваш-домен umask 077 printf 'DOMAIN=%s\n' "$DOMAIN" > .env printf 'GITEA__security__SECRET_KEY=%s\nGITEA__security__INTERNAL_TOKEN=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 64)" > secrets.env openssl rand -base64 24 > admin-passwordСохраните состав сервера
Запишите compose.yml целиком. Gitea хранит данные в ./gitea, порт веба доступен только локально. Адрес шлюза сети задан явно: аудит доверяет только этому прокси. Подсеть 172.30.50.0/24 должна быть свободна на сервере.
cat > compose.yml <<'YAML' services: server: image: docker.gitea.com/gitea:28.1.0 container_name: gitea restart: unless-stopped env_file: secrets.env environment: - GITEA__database__DB_TYPE=sqlite3 - GITEA__security__INSTALL_LOCK=true - GITEA__security__EGRESS_MODE=lax - GITEA__security__REVERSE_PROXY_TRUSTED_PROXIES=127.0.0.0/8,::1/128,172.30.50.1/32 - GITEA__server__ROOT_URL=https://${DOMAIN}/ - GITEA__server__SSH_DOMAIN=${DOMAIN} - GITEA__server__SSH_PORT=2222 - GITEA__service__DISABLE_REGISTRATION=true - GITEA__repository__DEFAULT_PRIVATE=private - GITEA__audit__RECORD_OUTPUT=database - GITEA__actions__RUN_RETENTION_DAYS=400 ports: ["127.0.0.1:3000:3000", "2222:22"] volumes: ["./gitea:/data"] caddy: image: caddy:2.11.7 restart: unless-stopped network_mode: host volumes: ["./Caddyfile:/etc/caddy/Caddyfile:ro", "caddy_data:/data"] healthcheck: test: ["CMD", "wget", "-q", "--spider", "https://${DOMAIN}/api/v1/version"] interval: 3s timeout: 5s retries: 40 volumes: {caddy_data: {}} networks: default: ipam: {config: [{subnet: 172.30.50.0/24, gateway: 172.30.50.1}]} YAMLВключите HTTPS и поднимите контейнеры
Caddy получает сертификат автоматически и передает WebSocket без специальных правил. Проверка здоровья дожидается ответа Gitea через публичный HTTPS: просто запущенный контейнер еще не означает готовый сервис.
printf '%s {\n reverse_proxy 127.0.0.1:3000\n}\n' "$DOMAIN" > Caddyfile docker compose pull docker compose up -d --wait --wait-timeout 180Создайте администратора и войдите
Установщик заблокирован заранее, поэтому случайный посетитель не станет владельцем. Команда создает admin; последняя строка показывает его случайный пароль. Откройте https://ваш-домен/user/login, войдите и создайте приватный репозиторий demo с README.
docker compose exec -T -u git server gitea admin user create --admin --username admin --password "$(cat admin-password)" --email admin@example.org --must-change-password=false cat admin-password
В настройках учетной записи выберите русский язык и добавьте публичный SSH-ключ. Для созданного demo команда клонирования выглядит так:
git clone ssh://git@ваш-домен:2222/admin/demo.gitВход на сам VPS остается на порту 22; порт 2222 обслуживает Git. Данные репозитория сохраняются при пересоздании контейнера, поскольку находятся в примонтированном каталоге.
Память и рост на реальном репозитории
Замеры сняты на CPU2-RAM4-DISK50 с Debian 13.3, Docker 29.9.1 и Compose 5.6.0. Тестовый исполнитель остановлен; память Caddy указана отдельно от Gitea.
| Gitea в простое | 95 МиБ |
| Caddy | 21 МиБ |
| Вся машина с ОС и Docker | 644 МиБ |
| Холодное скачивание Gitea + Caddy | 12 секунд |
| Первый ответ после запуска | 11 секунд |
| От готовой чистой Debian до HTTPS и администратора | 59 секунд |
| Повторный запуск с данными | около 2 секунд |
| Отклик главной через публичный HTTPS | 54 мс |
Импортировали Caddy с полной историей: 15 783 коммита по всем веткам и тегам, 734 файла в текущем дереве. Импорт занял 9 секунд, клонирование обратно по HTTPS - 3 секунды.
Каталог данных вырос на 37 МиБ, SQLite - на 24 КиБ. Память Gitea достигала 114 МиБ, после импорта оставалась на 109 МиБ. В этом сценарии место расходуется прежде всего на Git-объекты.
Проверено на версии v28.1.0, 15 октября 2026. На новых версиях результаты могут отличаться.
Как связать задачу и изменение
Создайте задачу с критерием приемки, отправьте отдельную ветку и откройте запрос на слияние. Номер задачи в описании связывает обсуждение с измененными файлами.
В запросе откройте «Измененные файлы»: здесь видны добавленные строки и кнопка рецензии. Сначала обсуждайте изменение в ветке, затем принимайте его в основную ветку, чтобы история оставалась понятной.
На стенде задача о восстановлении связана с изменением RESTORE.md. В карточке задачи видны переход к запросу, участники и затраченное время, поэтому отдельный трекер для такого списка работ не обязателен.
Где может сломаться
Причина. Gitea 28 проверяет исходящие Git-соединения. Режим lax разрешает публичные адреса, но блокирует loopback и внутренние сети.
Решение. Для внутреннего источника разрешите конкретный адрес в GITEA__security__ALLOWED_HOST_LIST, затем выполните docker compose up -d. Не открывайте все внутренние сети ради одного импорта.
Причина. Приложение не доверяет заголовку X-Forwarded-For от прокси за Docker-сетью.
Решение. В инструкции указан фиксированный шлюз 172.30.50.1 и доверие только к нему. При другой сети узнайте адрес командой docker inspect gitea и замените REVERSE_PROXY_TRUSTED_PROXIES, сохранив ограничение одним адресом.
Причина. Интерфейс подтверждает постановку в очередь. На стенде SMTP-соединение завершилось таймаутом до проверки сертификата.
Решение. Найдите ошибку: docker compose logs server | grep -i smtp. В secrets.env задайте GITEA__mailer__SMTP_ADDR и SMTP_PORT=587 с префиксом GITEA__mailer__, PROTOCOL=smtp+starttls, ENABLED=true, USER, PASSWD и FROM. Выполните docker compose up -d server и подтвердите доставку письмом в ящике.
Как сохранить данные и обновить сервер
Остановка сервера перед архивом дает согласованную SQLite. Команды сохраняют весь каталог: Git, базу, app.ini, секреты и состав контейнеров. Архив содержит доступы; перенесите его на отдельное защищенное хранилище.
cd /opt/gitea
docker compose stop
tar -C /opt -czf /root/gitea-backup.tgz gitea
docker compose up -d --waitДля восстановления остановите контейнеры, отложите текущий каталог и распакуйте архив. Возвращайте весь набор файлов, а не одну базу:
cd /opt/gitea
docker compose down
mv /opt/gitea /opt/gitea.before-restore
tar -C /opt -xzf /root/gitea-backup.tgz
cd /opt/gitea
docker compose up -d --waitПосле восстановления войдите, откройте репозиторий и проверьте последний коммит. Для обновления сначала сделайте такую копию, замените тег Gitea в compose.yml и выполните:
cd /opt/gitea
docker compose pull server
docker compose up -d --wait
docker compose exec -T server gitea --versionВстроенный аудит включен строкой RECORD_OUTPUT=database. Он доступен в «Мониторинг → Audit Log» по адресу /-/admin/monitor/audit_logs. По умолчанию события хранятся 30 дней.
Уязвимости прошлых версий
Инструкция ставит 28.1.0 с исправлениями 29 CVE. На старом сервере выполните обновление с резервной копией по командам выше; одного закрытого установщика недостаточно.
| Идентификатор | Уровень | Затронуты | Исправлено | Риск для владельца |
|---|---|---|---|---|
| CVE-2026-104626, CVE-2026-104632 | critical | <= 1.27.3 | 28.0.0 | Запуск кода неодобренного PR |
| CVE-2026-103667 | critical | <= 1.27.3 | 28.0.0 | Захват аккаунта через OCI/XSS |
| CVE-2026-103059 | critical | <= 1.27.3 | 28.0.0 | Чужой RSA-ключ: встроенный SSH + SQLite |
| CVE-2026-95106 | critical | <= 1.27.3 | 28.0.0 | Скрытый от ревью вредоносный файл |
| CVE-2026-103670, CVE-2026-94205 | high | <= 1.27.3 | 28.0.0 | Обход согласования заданий Actions |
| CVE-2026-89430, CVE-2026-101027, CVE-2026-101029, CVE-2026-70357 | high | <= 1.27.3 | 28.0.0 | Доступ Git-зеркала к внутренней сети |
| CVE-2026-96399 | high | <= 1.27.3 | 28.0.0 | Падение процесса из-за шаблона трекера |
| CVE-2026-96404 | high | <= 1.27.3 | 28.0.0 | Вход администратором через открытый установщик |
| CVE-2026-97208 | high | <= 28.0.0 | 28.1.0 | Обход запрета создания push-зеркал |
| CVE-2026-86684 | high | >= 1.18.0, <= 28.0.0 | 28.1.0 | Неверная проверка права локального импорта |
| CVE-2026-96594 | high | <= 28.0.0 | 28.1.0 | Выполнение HTML на домене сервиса |
| CVE-2026-79960, CVE-2026-103504, CVE-2026-96589 | medium | <= 1.27.3 | 28.0.0 | Лишние права ключей, команд, получателей |
| CVE-2026-104636, CVE-2026-96400 | medium | <= 1.27.3 | 28.0.0 | Обход ограничений исходящих адресов |
| CVE-2026-96580, CVE-2026-95112 | medium | <= 1.27.3 | 28.0.0 | Исчерпание памяти или процессора |
| CVE-2026-105268, CVE-2026-105267, CVE-2026-101023, CVE-2026-104633, CVE-2026-97626 | medium | <= 28.0.0 | 28.1.0 | Ошибки прав, токенов, импорта, раскрытие активности |
| CVE-2026-89182 | medium | >= 1.27.0, <= 28.0.0 | 28.1.0 | Публикация вопреки FORCE_PRIVATE |
CVE-2026-103059 касается встроенного SSH, а инструкция использует OpenSSH. Уровень critical взят из API бюллетеня; его текст называет high.
Отдельный GHSA-rqhx-647v-wx32 имеет неопределенный статус исправления. Версия 28.1.0 сама по себе не доказывает его закрытие.
Что изменилось с прошлого разбора
После 1.27.3 нумерация стала 28.1.0: префикс «1.» убран. Одновременно изменились сетевые проверки Git и конфигурация сервера. DOMAIN больше не задает адрес приложения: используется ROOT_URL.
Уведомления передаются через WebSocket /-/ws. В проверке через публичный HTTPS браузер получил событие таймера. Требуемая версия Git теперь не ниже 2.25; в образе 28.1.0 установлен Git 2.54.
Аудит доступен в OSS и отдельно включается конфигурацией. Утверждение прошлого разбора «аудит только Enterprise» больше не верно. Закрытые critical/high перечислены в таблице уязвимостей.
Actions удаляет завершенные запуски через 400 дней вместе с остатками логов и артефактов. При этом отдельные сроки короче: логи 365 дней, артефакты 90. Чтобы сохранять запуски бессрочно, задайте RUN_RETENTION_DAYS=0; сроки логов и артефактов меняются отдельно.
Когда это НЕ ваш выбор
Требуется полный перенос GitLab. Вложенная иерархия групп, групповые процессы и SAML в бесплатной сборке не заменяются этим набором; .gitlab-ci.yml также не становится workflow Gitea автоматически.
Планируется исполнять чужие сборки на Git-сервере. Исполнитель с Docker нуждается в отдельной изоляции. Простой тест задания не является доказательством безопасной общей CI-площадки.
Команда работает только с русским интерфейсом. Перевод частичный: новые экраны аудита и Actions содержат английские названия. Это видно на живых скриншотах.
В бесплатном облаке уже все устраивает. Переезд ради нулевой лицензии ничего не экономит: добавятся сервер, обновления и обязанность восстанавливать копии.
Частые вопросы
Gitea бесплатна для коммерческой команды?
Да, OSS распространяется под MIT. Подписка не нужна для показанных репозиториев, задач, ревью и аудита.
Почему Git clone по SSH идет не на порт 22?
На 22 находится управление VPS. Git обслуживает порт 2222: добавьте ключ в настройки учетной записи и используйте ssh://git@ваш-домен:2222/admin/demo.git.
Где хранятся репозитории?
На хосте /opt/gitea/gitea/git/repositories; база и app.ini находятся рядом в том же каталоге данных. Архивируйте весь /opt/gitea.
Что подключать, когда заканчивается диск?
Для обычных Git-репозиториев добавьте файловый диск под каталог данных. Увеличение CPU и RAM ради места не требуется. LFS, пакеты и вложения поддерживают отдельное S3-совместимое хранилище.
Как устроить собственные сборки?
Подключите Gitea Runner к публичному адресу сервера. Токен регистрации создается командой docker compose exec -T -u git server gitea actions generate-runner-token. В базовую установку исполнитель не входит.
Где искать альтернативы?
Для полного цикла разработки сравните GitLab. GitHub Team имеет смысл, когда подходит облачное размещение.
Итог
Gitea закрывает понятный цикл: хранить код, обсуждать изменения и получать результат собственного workflow. Начните с приватного репозитория и одного рабочего проекта; после этого решайте, какие процессы действительно требуют GitLab.
На CPU2-RAM4-DISK50 сервер занял 95 МиБ памяти без прокси, а импорт Caddy добавил 37 МиБ данных. Команды установки и полного архива помогают оценить не только запуск, но и обслуживание.
Этот стек у нас запущен на тарифе CPU2-RAM4-DISK50. Нашли баг в гайде - напишите, поправим в течение дня.