Архивная версия статьи — версия продукта 28.2.0, проверена 27 октября 2026 г.. Инструкции могли устареть.Актуальная статья →
Разработка

Gitea

Gitea - аналог GitHub для команды, которая хочет хранить код, вести задачи и обсуждать изменения на своем сервере. Развернули 28.2.0 на Fatmetal Cloud Server, отдельно проверили установку и сохранили замеры ресурсов версии 28.1.0, потому что состав стека не менялся.

Проверено на версии v28.2.0, 27 октября 2026~14 минут чтенияFatmetal Team
Свой GitЛицензия: MITСтатус: установка проверена, v28.2.0

Вердикт

Подходит
  • команде, которой нужны приватный код, обсуждение изменений и задачи вместо сложной платформы GitLab
  • разработчику, который хочет забирать репозитории с GitHub на собственную машину
Не подходит
  • отделу, который рассчитывает переехать с GitLab без изменения процессов
  • заказчику, который ждет готовые исполнители сборок вместе с Git-сервером
Рекомендуем: CPU2-RAM4-DISK50Сложность: mediumЗапуск: около минутыRAM в простое: Gitea 95 МиБ + Caddy 21 МиБ, без исполнителя сборокГлавный риск: сообщение об отправке письма не подтверждает доставкуПрод-готовность: HTTPS, закрытая регистрация и резервная копия
Работа команды

Что Gitea заменяет в ежедневной разработке

Разработчик отправляет ветку, открывает запрос на слияние, коллега смотрит diff и обсуждает строки. Рядом живут задачи, релизы и результаты сборок. Для такого цикла полноценный GitLab нужен не каждой команде.

Новые продажи GitLab Premium в России приостановлены. Gitea OSS не требует покупки зарубежной лицензии и платы за каждого участника; оплачивать и обслуживать нужно свой сервер и копии.

На стенде создали приватный репозиторий, отправили изменения по HTTPS и SSH, связали задачу с запросом на слияние. В интерфейсе видны файлы и история, а доступ к Git не зависит от веб-редактора.

Gitea написана на Go и распространяется под MIT. Коммерческая поддержка продается отдельно.

GoSQLiteOpenSSHDocker ComposeCaddy
Приватный командный репозиторий: файлы, ветки и README в Gitea 28.1.0
Приватный командный репозиторий: файлы, ветки и README. Gitea 28.1.0, русская локаль.
Выбор

Gitea, GitLab и платный GitHub

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

ПродуктОплатаЧто учесть
Gitea OSSЛицензия 0; наш сервер 500 руб/месКод и копии обслуживаете сами
GitLab CEЛицензия 0; своя инфраструктураБолее широкая платформа; исполнитель CI также отдельный
GitLab Premium29 $ за пользователя в месяц, оплата за годМеждународный прайс, новые продажи в РФ приостановлены
GitHub Team4 $ за пользователя в месяц, условие первых 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 дает широкие права на ее содержимое.

Успешный workflow и сохраненный артефакт сборки в Gitea 28.1.0
Успешный workflow и сохраненный артефакт сборки. Gitea 28.1.0, русская локаль.
Конфигурация

Какой сервер выбрать

Для самостоятельной установки возьмите 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.2.0. Версии ниже 28.2.0 требуют обновления из-за исправлений безопасности.

  1. Установите 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
  2. Задайте домен и создайте секреты

    Замените ваш-домен своим именем с 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
  3. Сохраните состав сервера

    Запишите compose.yml целиком. Gitea хранит данные в ./gitea, порт веба доступен только локально. Адрес шлюза сети задан явно: аудит доверяет только этому прокси. Подсеть 172.30.50.0/24 должна быть свободна на сервере.

    cat > compose.yml <<'YAML'
    services:
      server:
        image: docker.io/gitea/gitea:28.2.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
  4. Включите 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
  5. Создайте администратора и войдите

    Установщик заблокирован заранее, поэтому случайный посетитель не станет владельцем. Команда создает 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. Данные репозитория сохраняются при пересоздании контейнера, поскольку находятся в примонтированном каталоге.

Замеры

Память и рост на реальном репозитории

Ресурсы ниже измерены на 28.1.0: CPU2-RAM4-DISK50, Debian 13.3, Docker 29.9.1 и Compose 5.6.0. В 28.2.0 установка и интерфейс не менялись; тестовый исполнитель остановлен, память Caddy указана отдельно от Gitea.

Gitea в простое95 МиБ
Caddy21 МиБ
Вся машина с ОС и Docker644 МиБ
Холодное скачивание Gitea + Caddy12 секунд
Первый ответ после запуска11 секунд
От готовой чистой Debian до HTTPS и администратора59 секунд
Повторный запуск с даннымиоколо 2 секунд
Отклик главной через публичный HTTPS54 мс

Импортировали Caddy с полной историей: 15 783 коммита по всем веткам и тегам, 734 файла в текущем дереве. Импорт занял 9 секунд, клонирование обратно по HTTPS - 3 секунды.

Каталог данных вырос на 37 МиБ, SQLite - на 24 КиБ. Память Gitea достигала 114 МиБ, после импорта оставалась на 109 МиБ. В этом сценарии место расходуется прежде всего на Git-объекты.

Ресурсы измерены на v28.1.0, 15 октября 2026. Установка v28.2.0 проверена 27 октября. На новых версиях результаты могут отличаться.

Импортированный репозиторий Caddy с историей, ветками и тегами в Gitea 28.1.0
Импортированный репозиторий Caddy с историей, ветками и тегами. Gitea 28.1.0, русская локаль.
Ревью

Как связать задачу и изменение

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

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

Изменения RESTORE.md в запросе на слияние в Gitea 28.1.0
Изменения RESTORE.md в запросе на слияние. Gitea 28.1.0, русская локаль.

На стенде задача о восстановлении связана с изменением RESTORE.md. В карточке задачи видны переход к запросу, участники и затраченное время, поэтому отдельный трекер для такого списка работ не обязателен.

Задача с критериями проверки Git, CI и восстановления в Gitea 28.1.0
Задача с критериями проверки Git, CI и восстановления. Gitea 28.1.0, русская локаль.
Диагностика

Где может сломаться

You can not import from disallowed hosts.

Причина. Gitea 28 проверяет исходящие Git-соединения. Режим lax разрешает публичные адреса, но блокирует loopback и внутренние сети.

Решение. Для внутреннего источника разрешите конкретный адрес в GITEA__security__ALLOWED_HOST_LIST, затем выполните docker compose up -d. Не открывайте все внутренние сети ради одного импорта.

В аудите вместо адреса клиента виден Docker-шлюз

Причина. Приложение не доверяет заголовку X-Forwarded-For от прокси за Docker-сетью.

Решение. В инструкции указан фиксированный шлюз 172.30.50.1 и доверие только к нему. При другой сети узнайте адрес командой docker inspect gitea и замените REVERSE_PROXY_TRUSTED_PROXIES, сохранив ограничение одним адресом.

failed to copy: httpReadSeeker: failed open: timeout awaiting response headers

Причина. Docker начал загрузку официального образа с docker.gitea.com, но соединение с CDN зависло. Тег в Docker Hub содержит тот же образ.

Решение. Подставьте официальное зеркало и повторите загрузку: sed -i 's#docker.gitea.com/gitea:28.2.0#docker.io/gitea/gitea:28.2.0#' compose.yml && docker compose pull. Дальше команды не меняются.

Письмо «отправлено», но не приходит

Причина. Интерфейс подтверждает постановку в очередь. На стенде 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 дней.

Встроенный OSS-аудит: действия пользователя и его IP за reverse proxy в Gitea 28.1.0
Встроенный OSS-аудит: действия пользователя и его IP за reverse proxy. Gitea 28.1.0, русская локаль.
Безопасность

Уязвимости прошлых версий

Инструкция ставит 28.2.0. Этот релиз закрывает девять CVE, а еще три записи опубликованы как исправленные раньше. На сервере ниже 28.2.0 сначала сделайте копию по командам выше, затем обновите образ и проверьте версию.

ИдентификаторУровеньЗатронутыИсправленоРиск для владельца
CVE-2026-104626, CVE-2026-104632critical<= 1.27.328.0.0Запуск кода неодобренного PR
CVE-2026-103667critical<= 1.27.328.0.0Захват аккаунта через OCI/XSS
CVE-2026-103059critical<= 1.27.328.0.0Чужой RSA-ключ: встроенный SSH + SQLite
CVE-2026-95106critical<= 1.27.328.0.0Скрытый от ревью вредоносный файл
CVE-2026-104627high<= 28.1.028.2.0Захват аккаунта через OpenID и обход локальной MFA
CVE-2026-109553high<= 28.1.028.2.0Вход под другим пользователем при доверии SSH-сертификатам
CVE-2026-103670, CVE-2026-94205high<= 1.27.328.0.0Обход согласования заданий Actions
CVE-2026-89430, CVE-2026-101027, CVE-2026-101029, CVE-2026-70357high<= 1.27.328.0.0Доступ Git-зеркала к внутренней сети
CVE-2026-96399high<= 1.27.328.0.0Падение процесса из-за шаблона трекера
CVE-2026-96404high<= 1.27.328.0.0Вход администратором через открытый установщик
CVE-2026-97208high<= 28.0.028.1.0Обход запрета создания push-зеркал
CVE-2026-86684high>= 1.18.0, <= 28.0.028.1.0Неверная проверка права локального импорта
CVE-2026-96594high<= 28.0.028.1.0Выполнение HTML на домене сервиса
CVE-2026-105964medium>= 1.22.0, <= 28.1.028.2.0Переполнение памяти через Artifact V4 при подключенном runner
CVE-2026-110494medium<= 28.1.028.2.0Через release можно раскрыть или удалить вложение задачи
CVE-2026-105661medium<= 28.1.028.2.0Анонимный запрос раздувает журнал ошибок через panic
CVE-2026-110311medium>= 1.22.0, <= 28.1.028.2.0Draft release раскрывает метаданные чужих вложений
CVE-2026-107686medium<= 28.1.028.2.0Реакции обходят блокировку issue и комментария
CVE-2026-110324medium>= 1.22.0, <= 28.0.028.1.0POST раскрывает данные закрытого профиля
CVE-2026-109844medium<= 1.26.41.27.0API отдает метаданные приватных репозиториев после потери доступа
CVE-2026-79960, CVE-2026-103504, CVE-2026-96589medium<= 1.27.328.0.0Лишние права ключей, команд, получателей
CVE-2026-104636, CVE-2026-96400medium<= 1.27.328.0.0Обход ограничений исходящих адресов
CVE-2026-96580, CVE-2026-95112medium<= 1.27.328.0.0Исчерпание памяти или процессора
CVE-2026-105268, CVE-2026-105267, CVE-2026-101023, CVE-2026-104633, CVE-2026-97626medium<= 28.0.028.1.0Ошибки прав, токенов, импорта, раскрытие активности
CVE-2026-89182medium>= 1.27.0, <= 28.0.028.1.0Публикация вопреки FORCE_PRIVATE
CVE-2026-107618low<= 28.1.028.2.0CSRF меняет темы репозитория от имени администратора
CVE-2026-97204low<= 28.1.028.2.0При совпадении id можно удалить labels чужой организации
CVE-2026-97859low<= 1.27.21.27.3API обходит видимость профиля, ключей и избранных репозиториев

CVE-2026-103059 касается встроенного SSH, а инструкция использует OpenSSH. Уровень critical взят из API бюллетеня; его текст называет high. CVE-2026-104627 требует включенного OpenID, а CVE-2026-109553 - настроенного доверия к SSH-сертификатам. Обе high закрыты в 28.2.0.

Отдельный GHSA-rqhx-647v-wx32 остается с неопределенным статусом. Версия 28.2.0 сама по себе не доказывает его закрытие.

Переобход

Что изменилось с прошлого разбора

Предыдущая версия статьи проверялась на 28.1.0. В 28.2.0 вышел второй maintenance-релиз ветки 28: 39 коммитов без breaking changes.

ЧтоБыло, 28.1.0Стало, 28.2.0
УстановкаDocker Compose, тег 28.1.0те же команды и стек, тег 28.2.0; образ берется из Docker Hub
Интерфейсрепозитории, задачи, ревью и Actionsте же экраны; небольшие исправления
Безопасностьисправления 28.1.0еще 9 CVE, включая две high
Интеграциябез встроенного приложения VS Codegitea-vscode добавлен в OAuth-приложения

Главная причина обновиться - безопасность. OpenID-вход позволял привязать чужой identity к аккаунту без проверки начатой операции, а SSH-сертификат мог аутентифицировать запрос под другим пользователем. Подробности и остальные исправления - в таблице уязвимостей.

В Actions исправлены зависшие cancelled reusable workflows, очистка расписаний, folded YAML и неограниченное чтение тела Artifact V4. В pull requests восстановлены контекст review comments, пустые PR и merge commit; в packages исправлены npm tarball URLs и метаданные Debian.

Способ установки, первый экран и ресурсы не менялись. Поэтому память и тайминги ниже относятся к 28.1.0, а команды и вход в 28.2.0 проверены отдельно.

Границы

Когда это НЕ ваш выбор

Требуется полный перенос GitLab. Вложенная иерархия групп, групповые процессы и SAML в бесплатной сборке не заменяются этим набором; .gitlab-ci.yml также не становится workflow Gitea автоматически.

Планируется исполнять чужие сборки на Git-сервере. Исполнитель с Docker нуждается в отдельной изоляции. Простой тест задания не является доказательством безопасной общей CI-площадки.

Команда работает только с русским интерфейсом. Перевод частичный: новые экраны аудита и Actions содержат английские названия. Это видно на живых скриншотах.

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

FAQ

Частые вопросы

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 МиБ данных. Команды установки и полного архива помогают оценить не только запуск, но и обслуживание.

Анонсы новых разборов в Telegram-канале Новые гайды и карточки в маркетплейсе первыми @fatmetal_channel →

Этот стек у нас запущен на тарифе CPU2-RAM4-DISK50. Нашли баг в гайде - напишите, поправим в течение дня.