Forgejo 17.0 получил новые вебхуки, импорт из Bitbucket и поддержку FUNDING.yml

15 октября 2026 года вышел Forgejo 17.0 — новая версия открытой платформы для совместной работы с Git-репозиториями. Forgejo развивается как форк Gitea и позволяет развернуть собственный сервис, сопоставимый по основным задачам с GitHub, GitLab и Bitbucket.

‹›

Релиз будет поддерживаться до 28 января 2027 года. Исходный код Forgejo написан на Go и распространяется под лицензиями MIT и GPLv3+ для нового кода. До версии 17.0 проект выпускал обновления 13.0 в октябре 2025 года, 14.0 в январе 2026-го, 15.0 LTS в апреле и 16.0 в июле. Поддержка Forgejo 15.0 LTS продлится до 15 июля 2027 года.

Изменения, влияющие на совместимость

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

Для описаний и комментариев к задачам и запросам на слияние действует прежняя логика: абсолютные ссылки по-прежнему разрешаются относительно корня экземпляра.

Разработчики также объявили устаревшими вебхуки, связанные с запусками действий action run. Их заменяют события workflow run, которые поддерживают более широкий набор сценариев и вызывают меньше проблем. Автоматически перенести существующие вебхуки нельзя: у новых событий изменились заголовки и ключ action. Кроме того, уведомление о завершении отправляется только после выполнения всех заданий в рамках запуска. События action run планируют удалить в одной из будущих версий.

Новые возможности для репозиториев и миграций

Forgejo 17.0 поддерживает файл FUNDING.yml. Если он присутствует в репозитории, веб-интерфейс показывает кнопку «Пожертвовать» со списком доступных способов поддержки проекта. Аналогичная кнопка появляется на страницах пользователей и организаций, если соответствующий файл находится в репозитории .profile. Пока функция доступна только через веб-интерфейс; возможность работы с ней через API разработчики рассматривают отдельно.

В формах создания задач, запросов на слияние и комментариев появилось автодополнение. Для поиска задачи или запроса на слияние можно ввести символ «#», а в запросах на слияние также доступен символ «!». После этого варианты уточняются поисковым текстом или номером объекта.

Разработчики продолжают переработку поддержки Git LFS. В версии 17.0 обновлены навигация и интерфейс настроек LFS, появились дополнительные способы поиска коммитов, ссылающихся на конкретный LFS-файл, а обработка LFS-указателей стала надёжнее.

При переносе репозиториев из Gogs, GitLab, Gitea или Forgejo теперь сохраняются изображения их аватаров. Кроме того, Forgejo научился импортировать репозитории из Bitbucket Data Center, ранее называвшегося Bitbucket Server. Во время миграции можно перенести запросы на слияние, обзоры, обычные и многострочные комментарии, темы и ответы. Для подключения используется токен доступа HTTP, а на стороне Bitbucket необходимо включить HTTPS SCM-хостинг, поскольку Forgejo выполняет клонирование через HTTPS.

Резервное копирование и защита экземпляра

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

Ранее разработчик Ян Эспозито также показывал пример настройки Nginx для защиты собственного экземпляра Forgejo от краулеров, использующихся системами искусственного интеллекта. Такая схема должна ограничивать нежелательную автоматическую нагрузку, сохраняя доступность платформы для обычных пользователей.