{"canonical_url":"https://engineer.company/uk/glossary/forge/","content_markdown":"# Форджа\n\n## Що це таке\n\nФорджа, англійською forge, яку ще називають програмною форджею, форджею коду або\ngit-форджею, — це сервер, який команда домовляється вважати домівкою своїх\nрепозиторіїв, разом із сервісами, що працюють довкола них. Кожен повний клон\nрепозиторію Git несе всю історію, тож у принципі жодна копія не стоїть вище за\nіншу. На практиці ж команді потрібне одне місце, куди пушити, одне місце, яке\nвирішує, хто може читати й писати, і одне місце, де точиться розмова про код. Це\nмісце і є форджа.\n\nПід капотом форджа зберігає голі (bare) репозиторії, тобто форму, що містить\nлише історію без робочої копії файлів, і розмовляє одним або кількома протоколами\nпередавання Git. Книга Git називає чотири: локальний протокол для каталогу на\nтій самій машині, HTTP, SSH і власний протокол Git, тобто демон на порту 9418\nбез будь-якої автентифікації. Усе інше будується згори, і обсяг цієї надбудови\nдуже різниться.\n\nДокументація Forgejo описує повний край шкали: трекер задач, пул-реквести,\nвбудовану вікі, реєстр пакунків для багатьох мовних екосистем, Forgejo Actions\nдля запуску завдань, дзеркала репозиторіїв, імпорт з інших сервісів, захист\nгілок і тегів, а також вебхуки. Soft Serve стоїть на протилежному краю. Проєкт\nописує себе як Git-сервер для командного рядка, який можна розгорнути\nсамостійно: один бінарний файл `soft`, що віддає репозиторії через SSH, HTTP або\nпротокол Git, керує доступом за публічними SSH-ключами й підтримує співавторів,\nприватні репозиторії та вебхуки. Обидва є форджами; різниця в тому, яку частину\nроботи команди кожен намагається вмістити.\n\nФорджі також почали спілкуватися між собою. ForgeFed, протокол федерації для\nплатформ хостингу програмних проєктів і спільної роботи над ними, побудований як\nрозширення ActivityPub, моделює репозиторії, трекери задач, трекери патчів,\nпроєкти й команди як акторів, що надсилають одне одному активності. Його мета —\nспільна мова для мереж форджів та інструментів керування проєктами, щоб людина\nна одному сервері могла відкрити задачу щодо репозиторію на іншому, а\nрепозиторій міг переїхати між серверами, тоді як стара копія архівується в\nрежимі лише для читання і вказує на нову адресу.\n\n## Чому це важливо\n\nСаме у форджі правила стають обов'язковими. Правило, що живе на машині\nрозробника, діє лише доти, доки ту машину правильно налаштовано, а хук на\nсервері запускається під час кожного пушу. Хук Git `pre-receive` зчитує кожне\nнадіслане посилання зі стандартного входу як старий ідентифікатор, новий\nідентифікатор та ім'я, і якщо він завершується з ненульовим статусом, Git не\nоновлює жодного з посилань. Захист гілок, обов'язкові рецензії та вимога\nпідписаних комітів у більших форджах уточнюють ту саму ідею: спільна копія\nвідхиляє те, чого команда домовилася не приймати.\n\nВибір форджі — це також вибір того, хто тримає код. Хостинговий сервіс бере на\nсебе витрати на роботу й доступність, а натомість код, список доступу та кожне\nобговорення лежать на чужому обладнанні за чужими правилами. Самостійний хостинг\nперевертає цей обмін. Ціну має кожен варіант, і різниця найважливіша для\nбізнесу, який розповідає клієнтам, де зберігаються їхні дані.\n\nФорджа також зберігає дані, яких Git не має. Коміти й теги переходять із кожним\nклоном, а задачі, обговорення в рецензіях, списки доступу та серверні хуки\nналежать лише форджі. Цей поділ визначає, що має охоплювати резервна копія і що\nтреба перенести під час переїзду між форджами.\n\n## Як це виглядає на практиці\n\nКомпанія тримає власну форджу, і три проєкти на цьому сайті показують, чого це\nвимагало.\n\nВихідний код компанії раніше зберігався в сторонньому хостинг-сервісі, а проєкт,\nу якому\n[компанія розгорнула власну git-форджу](/uk/portfolio/your-code-on-your-own-hardware/),\nпочинається з думки, що мати форджу означає справді її тримати: автентифікація,\nконтроль доступу, сховище, резервні копії й публічне обличчя. Форджа — це Soft\nServe, один бінарний файл під наглядом операційної системи, обраний за те, що\nвін працює насамперед через SSH і не має адміністративного вебінтерфейсу. Вона\nприватна за замовчуванням: анонімний доступ заборонено, доступ без ключа\nзаборонено, а кожен задекларований репозиторій позначено як приватний. Її\nSSH-сервер слухає лише loopback-інтерфейс на порту 23231, а ззовні до нього\nдістаються через проміжний хост. Мультиплексор, який розводив би HTTPS і git\nчерез SSH на одному публічному порту, написано й залишено вимкненим, бо порт,\nяким ніхто не користується, теж є поверхнею атаки. Підсумок сформульовано\nпросто: компанія тримає власний код на власному обладнанні.\n\nВласний репозиторій цього сайту живе саме там. Його інструкції називають\nканонічним віддаленим репозиторієм самостійно розгорнуту форджу, Soft Serve\nчерез SSH, старішу хостингову копію називають застарілим дзеркалом і прямо\nкажуть, що хостингового CI немає: перевірка якості працює локально та в\ngit-хуках.\n\nСерверний хук треба перевіряти в середовищі, яке приймає справжній Git push,\nтож хук\n[відрепетирували на справжньому bare-репозиторії та справжньому пуші](/uk/portfolio/rehearsed-the-forge-ci-hook-found-2-defects/),\nперш ніж йому довіряти. Репетиція створює bare-репозиторій, встановлює хук,\nклонує, робить коміт, пушить і перевіряє обидва сценарії: прийняття й\nвідхилення. Вона виявила два дефекти, обидва невидимі у файлі. Повчальний\nдругий: запускаючи хук, Git експортує змінну з каталогом репозиторію, набір\nтестів, який запустив хук, її успадкував, і дев'ятнадцять тестів ставали\nчервоними на правильному коді, доки середовище не очистили на межі. Сторінка\nтакож називає своє обмеження: примусові оновлення та видалення гілок — це пуші,\nяких репетиція не відтворює.\n\nУсе це ділить [один одноядерний хост із 512 МБ пам'яті](/uk/portfolio/a-whole-company-on-one-small-server/) з усім іншим, що компанія обслуговує публічно: від семи доменів із TLS до onion-сервісу, сервера Gemini, сервера Gopher і блокування вторгнень. Автоматизацію резервного копіювання реалізовано окремо; це не те саме, що активні резервні копії. Форджа з вебпанеллю була б ще однією постійно запущеною програмою за цього бюджету, тому платформи з вебпанеллю відкинули ще на етапі проєктування; у вибірках, зафіксованих протягом доби на цьому хості, найнижче значення доступної пам'яті становило близько 310 МБ із 464.\n\n## Де виникають проблеми\n\nАнонімні відвідувачі отримують доступ на читання за замовчуванням у деяких\nфорджах. Документація Soft Serve каже, що з коробки він дає анонімним з'єднанням\nдоступ лише на читання, а керують цим два параметри, `anon-access` і\n`allow-keyless`. Приватна форджа встановлює перший у `no-access`, а другий у\nfalse, і результат варто перевірити з машини без завантаженого ключа. Власний\nдемон Git ще прямолінійніший: книга Git зазначає, що репозиторій, який він\nвіддає, або доступний для клонування всім, або не віддається взагалі.\n\nХук, що викликає Git в іншому каталозі, влучає не в той репозиторій. Під час\nпушу Git запускає хуки отримання всередині bare-репозиторію та експортує\n`GIT_DIR` і пов'язані змінні, щоб команди Git у хуку його знаходили. Усе, що\nзапускає хук, їх успадковує, зокрема й тести в робочій копії деінде.\nПосібник githooks радить очищати ці змінні, перш ніж працювати в чужому\nрепозиторії. Мінімальний хук `pre-receive`, що перевіряє кожен надісланий коміт\nу тимчасовому каталозі, робить це в підоболонці:\n\n```sh\nwhile read -r _ newrev _; do\n  git cat-file -e \"$newrev^{commit}\" 2\u003e/dev/null || continue\n  tree=$(mktemp -d)\n  git archive \"$newrev\" | tar -x -C \"$tree\"\n  (\n    unset $(git rev-parse --local-env-vars)\n    cd \"$tree\" \u0026\u0026 ./run-tests\n  ) || exit 1\ndone\n```\n\nВідновлена форджа повертається з кодом, але без своїх правил. Будь-який клон\nможе знову наповнити репозиторії втраченого сервера, проте книга Git попереджає,\nщо серверні хуки й подібні налаштування лишаються позаду, а задач, рецензій,\nключів і списків доступу в клонах ніколи й не було. Резервна копія форджі — це\nкопія її каталогу даних і конфігурації, а потім відновлення обох деінде й\nперевірка, що пуш, який хук має відхилити, справді відхиляється.\n\nКожен порт, який відкриває форджа, доводиться захищати. Зразкова конфігурація\nSoft Serve має SSH на порту 23231, HTTP на 23232, демон Git на 9418 і сервер\nстатистики на 23233. Команда, яка пушить лише через SSH, може вимкнути решту або\nприв'язати їх до loopback, і відкритих портів залишиться рівно стільки, скільки\nвикористовується.\n\nПереїзд на іншу форджу переносить код і залишає розмову позаду. Дзеркальний пуш\nкопіює кожне посилання в `refs/`, зокрема гілки й теги, і більше нічого.\nЗадачам, обговоренням у рецензіях, міткам і спискам доступу потрібен інструмент\nімпорту нової форджі або протокол на кшталт ForgeFed, який копіює коміти, теги,\nзадачі, мерж-реквести й коментарі та залишає старий репозиторій в архіві з\nпосиланням на новий.\n\n## Що почитати далі\n\n- [Специфікація ForgeFed](https://forgefed.org/spec/) — протокол федерації для\n  форджів з акторами, активностями та процедурою переїзду, яка архівує старий\n  репозиторій.\n- [Soft Serve](https://github.com/charmbracelet/soft-serve) — власна\n  документація проєкту про Git-сервер в одному бінарному файлі, що працює\n  насамперед через SSH, зокрема про параметри `anon-access` і `allow-keyless`.\n- [Документація Forgejo](https://forgejo.org/docs/latest/) — посібники для\n  адміністраторів і користувачів повнофункціональної форджі для самостійного\n  хостингу, від встановлення й резервних копій до Actions і дзеркал.\n- [githooks](https://git-scm.com/docs/githooks) — усі хуки, які запускає Git,\n  зокрема `pre-receive`, і середовище, яке успадковує хук пушу.\n- [The Protocols](https://git-scm.com/book/en/v2/Git-on-the-Server-The-Protocols)\n  — чотири способи, якими Git переносить дані між машинами, і чого кожен вартує\n  в налаштуванні та безпеці.\n- [ActivityPub](https://www.w3.org/TR/activitypub/) — рекомендація W3C, яку\n  розширює ForgeFed.\n\n\u003chttps://engineer.company/uk/glossary/forge/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Що форджа додає поверх репозиторіїв, які обслуговує, якою малою вона може бути і де самостійний хостинг спільної копії коду дається взнаки.","formats":{"gemtext":"https://engineer.company/uk/glossary/forge/index.gmi","gopher":"https://engineer.company/uk/glossary/forge/gophermap","html":"https://engineer.company/uk/glossary/forge/","json":"https://engineer.company/uk/glossary/forge/index.json","markdown":"https://engineer.company/uk/glossary/forge/index.md","pdf":"https://engineer.company/uk/glossary/forge/index.pdf"},"kind":"page","language":"uk","title":"Що таке форджа?","url":"https://engineer.company/uk/glossary/forge/","version":1}