Przejdź do treści
Baza wiedzy 12 min czytania

Kopia zapasowa repozytoriów GitHub i GitLab: dlaczego dostawca jej za ciebie nie zrobi

Repozytorium na GitHubie albo GitLabie nie jest kopią zapasową. Warunki GitHub wyłączają odpowiedzialność za utratę danych, a GitLab sam pisze, że eksport projektu nie służy do backupu. Klon lustrzany chroni kod i historię, ale zgłoszenia, konfigurację CI i zmienne trzeba zabezpieczyć osobno.

Programista porządkuje gałęzie w repozytorium produktu i wypycha zmianę z flagą --force. Po godzinie okazuje się, że z serwera zniknęły commity kolegi z ostatnich trzech dni. Commity mogą jeszcze leżeć w lokalnej kopii kolegi, jeśli jej nie nadpisał. Kopii, z której firma mogłaby odtworzyć repozytorium na własne żądanie, dział IT jednak nie ma.

Backup repozytorium Git to zadanie właściciela konta, a nie dostawcy platformy. GitHub i GitLab utrzymują usługę, ale za zawartość konta, jej ochronę i możliwość odtworzenia odpowiada klient. Dla firmy, której produktem jest kod, to luka w cyberbezpieczeństwie i ciągłości działania tej samej wagi co brak kopii serwera bazy danych.

Czy GitHub i GitLab robią kopię zapasową twoich repozytoriów?

Nie w takim sensie, w jakim rozumie kopię dział IT: dokumentacja obu platform zakłada, że kopię, którą da się odtworzyć w wybranym momencie i miejscu, wykonuje klient. Warunki korzystania z GitHub, obowiązujące od 27 kwietnia 2026 r., mówią, że usługa jest świadczona „as is” i bez gwarancji dostępności w danym czasie. Ten sam dokument zawiera klauzulę, zgodnie z którą GitHub nie odpowiada za utratę danych „however arising”, czyli bez względu na przyczynę.

GitLab stawia sprawę podobnie, choć innymi słowami. Dokumentacja kopii zapasowej i odtwarzania zapewnia, że GitLab dba o bezpieczeństwo danych na GitLab.com, ale opisanych tam metod nie da się użyć do eksportu ani kopii własnych danych z GitLab.com. Te procedury dotyczą instancji GitLab Self-Managed, za której kopię odpowiada jej administrator. Ta sama strona uzasadnia, po co je stosować: kopie chronią przed utratą danych z powodu awarii sprzętu, błędów oprogramowania i przypadkowego usunięcia oraz pozwalają odtworzyć instancję po poważnym zdarzeniu.

Firma z indywidualną umową korporacyjną musi sprawdzić zapisy o odpowiedzialności we własnej umowie, zamiast zakładać, że różnią się od warunków standardowych.

Na czym polega model współdzielonej odpowiedzialności przy repozytoriach?

Dostawca odpowiada za działanie usługi, a klient za to, co na koncie umieszcza, kto ma do tego dostęp i czy da się to odzyskać. Warunki GitHub zapisują drugą połowę wprost: użytkownik odpowiada za bezpieczeństwo konta, za całą treść i aktywność na koncie, a zawartość konta i jej bezpieczeństwo są w jego rękach. GitHub dodaje, że udostępnia narzędzia takie jak uwierzytelnianie dwuskładnikowe, ale z nich trzeba skorzystać samemu. Włączone uwierzytelnianie wieloskładnikowe dla wszystkich członków organizacji i wąskie grono administratorów zmniejszają ryzyko, że ktoś usunie repozytoria z przejętego konta.

W praktyce oznacza to, że przed wieloma scenariuszami utraty danych platforma nie ochroni, bo z jej punktu widzenia nic złego się nie stało. Wymuszone wypchnięcie do niechronionej gałęzi, usunięcie repozytorium przez administratora z uprawnieniami, przejęte konto, które kasuje projekty, albo zamknięcie organizacji to poprawnie wykonane operacje uprawnionego użytkownika. Platforma je wykona, bo tak działa. Wynika z tego, że plan kopii firmy musi obejmować także repozytoria.

Przed czym chroni kopia repozytorium, a przed czym nie?

Kopia chroni przed utratą danych z powodów, na które platforma nie reaguje albo reaguje za późno: błędem człowieka, złośliwym działaniem z przejętego konta, zamknięciem konta i niedostępnością usługi. Dokumentacja Git opisuje pierwszy z tych scenariuszy bez ogródek. Flaga --force w poleceniu git push wyłącza kontrole bezpieczeństwa i według podręcznika git-push może spowodować, że zdalne repozytorium straci commity.

GitHub daje ograniczoną siatkę bezpieczeństwa dla usuniętych repozytoriów. Według dokumentacji przywracania można to zrobić w ciągu 90 dni, a repozytorium z niepustej sieci forków przywraca tylko wsparcie GitHub na płatnych planach; przywrócenie nie odtwarza też uprawnień zespołów. Po zamknięciu konta warunki GitHub przewidują usunięcie zawartości repozytoriów w ciągu 90 dni; w tym czasie można poprosić o kopię, a GitHub zobowiązuje się jedynie do „rozsądnych starań”.

Kopia repozytorium nie chroni natomiast przed wyciekiem kodu ani przed złośliwym commitem, który trafi do kopii razem z resztą historii. Do tego służą kontrola dostępu, przegląd zmian i skanowanie kodu, opisane w tekście o bezpieczeństwie środowiska DevOps. Kopia zapewnia, że da się wrócić do znanego, dobrego stanu.

Najważniejsze:

  • GitHub wyłącza w warunkach odpowiedzialność za utratę danych, a procedur kopii GitLab nie da się użyć do danych z GitLab.com.
  • Wymuszone wypchnięcie, usunięcie repozytorium i zamknięcie konta to dla platformy poprawne operacje.
  • Przywrócenie usuniętego repozytorium na GitHub ma limit 90 dni i wyjątki.

Co trzeba skopiować poza samym kodem?

Trzeba skopiować wszystko, bez czego zespół nie odtworzy pracy: repozytorium Git, obiekty Git LFS, wiki, a także metadane platformy, takie jak zgłoszenia, przeglądy kodu i konfigurację CI/CD. Repozytorium Git zawiera pliki i historię zmian. Zgłoszenia (issues), pull requesty i merge requesty, komentarze, wydania i ustawienia projektu żyją w bazie danych platformy, a nie w repozytorium.

Dokumentacja GitHub wymienia kilka warstw. Pliki duże przechowywane w Git LFS trzeba pobrać osobnym poleceniem git lfs fetch --all. Wiki na GitHubie to osobne repozytorium Git, które klonuje się oddzielnie. Archiwa migracyjne, które obejmują wybrane metadane, nie zawierają między innymi obiektów LFS, dyskusji ani pakietów.

Na GitLabie lista tego, czego eksport projektu nie obejmuje, jest dłuższa. Według dokumentacji GitLab poza eksportem zostają między innymi zmienne CI/CD, webhooki, logi i artefakty zadań, obrazy z rejestru pakietów i kontenerów oraz zaszyfrowane tokeny. Jeśli w zmiennych CI/CD są dane dostępowe do środowisk, ich utrata zatrzymuje wdrożenia nawet wtedy, gdy kod jest bezpieczny.

Czy git clone —mirror wystarczy jako kopia zapasowa?

Klon lustrzany wystarczy jako kopia repozytorium Git z pełną historią, ale nie jako kopia całego projektu na platformie. Dokumentacja GitHub o kopii repozytorium opisuje właśnie polecenie git clone --mirror, a następnie git lfs fetch --all, jeśli repozytorium korzysta z Git LFS. Według podręcznika git-clone klon lustrzany odwzorowuje wszystkie referencje źródła, w tym gałęzie zdalne i notatki, a nie tylko gałęzie lokalne.

Odtworzenie jest proste: rozpakowujesz archiwum i wypychasz repozytorium do nowego zdalnego serwera. Ta prostota jest zaletą klonu lustrzanego. Kopię da się odtworzyć na innej platformie, na przykład z GitHub na własną instancję GitLab, bez zależności od narzędzia dostawcy.

Ograniczenie jest równie jasne. Klon lustrzany nie zawiera zgłoszeń, przeglądów kodu, ustawień ochrony gałęzi ani zmiennych CI/CD. Dla repozytorium biblioteki z historią w commitach to może wystarczyć. Dla repozytorium produktu, w którym decyzje projektowe zapisano w przeglądach kodu, a wdrożenia zależą od zmiennych, to tylko część kopii.

Dlaczego eksport projektu z GitLab nie jest kopią zapasową?

Eksport projektu służy do migracji, a sam GitLab odradza używanie go jako kopii. Dokumentacja eksportu i importu projektów mówi wprost, że plików eksportu nie należy używać do tworzenia kopii danych, bo taka kopia nie zawsze działa, a nie wszystkie elementy są eksportowane.

Ta sama dokumentacja daje dwa praktyczne powody ostrożności. Po pierwsze, pliki eksportu leżą na serwerze tymczasowo, a mechanizm GitLab usuwa je co 24 godziny, więc trzeba je od razu pobrać i przenieść. Lista elementów nieeksportowanych obejmuje te, które trudno odtworzyć ręcznie: zmienne CI/CD, webhooki i zaszyfrowane tokeny.

GitHub ma podobne zastrzeżenie wobec archiwów migracyjnych. Jego dokumentacja zaznacza, że nie ma wspieranego, udokumentowanego sposobu odtworzenia takiego archiwum na GitHubie, więc nadaje się ono wyłącznie do archiwizacji. Archiwum, z którego nie da się odtworzyć projektu, nie spełnia definicji kopii zapasowej.

Jak zaprojektować kopię repozytoriów: częstotliwość, retencję i miejsce?

Kopię repozytoriów projektuje się tak samo jak każdą inną: od akceptowalnej utraty danych, przez rodzaj i częstotliwość kopii, po retencję i miejsce przechowywania poza zasięgiem tego samego konta. Częstotliwość wynika z tego, ile pracy zespół może stracić w danym repozytorium. Jeśli zespół może stracić najwyżej dzień pracy, kopia musi powstawać co najmniej raz dziennie; archiwalny projekt wymaga jej rzadziej.

Wybór między kopią pełną a przyrostową działa tu jak przy innych danych. Kopia przyrostowa oszczędza miejsce, ale wydłuża łańcuch, który trzeba odtworzyć, co szczegółowo omawia tekst o kopii pełnej, przyrostowej i różnicowej. Zasady przechowywania kopii w kilku egzemplarzach i lokalizacjach opisuje przewodnik po backupie i strategii 3-2-1.

Miejsce przechowywania ma znaczenie szczególne. Kopia trzymana na tym samym koncie GitHub albo w tej samej grupie GitLab, do której ma dostęp to samo konto administratora, padnie razem z oryginałem przy przejęciu konta. Bezpieczniejsza jest kopia w osobnym magazynie, z osobnymi poświadczeniami i, jeśli to możliwe, w trybie niezmiennym, opisanym w tekście o backupie niezmiennym.

Kopia musi też nadążać za organizacją. Zespoły zakładają nowe repozytoria w miarę rozwoju produktu, więc mechanizm, który kopiuje listę repozytoriów spisaną przy wdrożeniu, po kilku miesiącach pomija część kodu. Lista repozytoriów do kopii powinna powstawać automatycznie z konta organizacji albo grupy, a raport z kopii powinien pokazywać repozytoria, które do niej nie trafiły.

Jak chronić samą kopię i dostęp do niej?

Kopię repozytoriów chroni się jak środowisko produkcyjne, bo zawiera kod, historię i może zawierać dane dostępowe. Historia Git przechowuje każdą wersję pliku, więc hasło albo klucz API zapisany kiedyś w repozytorium i później usunięty nadal jest w kopii. Kopia musi więc być szyfrowana, a dostęp do niej ograniczony do osób, które faktycznie odtwarzają dane.

Mechanizm wykonujący kopię powinien działać z osobnego konta technicznego z najmniejszymi potrzebnymi uprawnieniami, czyli tylko do odczytu, jeśli platforma na to pozwala. Token tego konta jest kluczem do całego kodu firmy, więc przechowuje się go w sejfie sekretów, rotuje i monitoruje jego użycie. Konto, które może czytać wszystkie repozytoria i jednocześnie kasować kopie, łączy dwie role, które powinny być rozdzielone.

Jak sprawdzić, że kopię repozytorium da się odtworzyć?

Kopię sprawdza się, odtwarzając ją do pustego repozytorium na innej instancji i porównując wynik z oryginałem. Test odpowiada na trzy pytania: czy są wszystkie gałęzie i tagi, czy obiekty LFS się pobierają i czy projekt da się zbudować z odtworzonego kodu i odtworzonej konfiguracji.

Wynik testu warto zapisać razem z czasem, jaki zajął. Odtworzenie wielu repozytoriów razem ze zmiennymi CI/CD i uprawnieniami zespołów to seria czynności, a nie jedno polecenie. Bez próby nikt nie wie, ile naprawdę potrwa, a ta liczba jest potrzebna w planie odtwarzania po awarii, o którym piszemy w tekście o planie DRP. Test warto powtarzać po każdej zmianie narzędzia kopii, platformy albo struktury organizacji na platformie, bo każda z nich może po cichu zmienić to, co trafia do kopii.

Co obejmuje każda metoda kopii repozytoriów?

Żadna pojedyncza metoda nie obejmuje wszystkiego, dlatego wybiera się zestaw metod do rodzaju repozytorium i platformy. Tabela porównuje metody opisane w dokumentacji dostawców.

MetodaCo obejmujeCzego nie obejmujeKiedy wystarcza
git clone --mirror + git lfs fetch --allWszystkie referencje, pełna historia, obiekty LFSZgłoszenia, przeglądy kodu, wiki, zmienne CI/CD, ustawieniaRepozytorium, w którym liczy się tylko kod i historia
Klon repozytorium wiki (GitHub)Strony wiki z historiąWszystko poza wikiJako uzupełnienie klonu lustrzanego
Archiwum migracyjne GitHubRepozytorium i wybrane metadaneObiekty LFS, dyskusje, pakiety; brak wspieranego odtworzenia na GitHubArchiwizacja, nie odtwarzanie
Eksport projektu GitLabRepozytorium, zgłoszenia, merge requesty, komentarze i inne elementy z listyZmienne CI/CD, webhooki, artefakty, rejestry, zaszyfrowane tokenyMigracja; GitLab odradza użycie jako kopii
Kopia instancji GitLab Self-ManagedInstancja według procedury GitLabNie dotyczy GitLab.comGdy firma utrzymuje własną instancję
Narzędzie zewnętrzne do kopii (GitHub odsyła do kategorii Backup Utilities w GitHub Marketplace)Zależnie od narzędziaZależnie od narzędziaGdy potrzebne są metadane i automatyczna retencja; zakres sprawdza się w dokumentacji narzędzia

Najważniejsze:

  • Klon lustrzany to fundament kopii, ale nie obejmuje metadanych platformy.
  • Eksport projektu GitLab i archiwum migracyjne GitHub nie zastępują kopii, z której da się odtworzyć projekt.
  • Kopia ma sens dopiero po teście odtworzenia na innej instancji.

Jak nFlo może pomóc w kopiach zapasowych repozytoriów i reszty środowiska?

Kopie repozytoriów to część szerszej strategii kopii i odtwarzania w infrastrukturze IT firmy. W ramach usługi Backup i Disaster Recovery nFlo prowadzi analizę wpływu na biznes z określeniem RTO i RPO dla każdego systemu, projektuje strategię kopii zgodną z zasadą 3-2-1, konfiguruje kopie niezmienne, przygotowuje plan odtwarzania po awarii i testuje odtwarzanie.

Dla pozostałych systemów, takich jak stacje robocze, serwery, Microsoft 365, Google Workspace i bazy danych, nFlo wdraża m.in. Xopero ONE, polską platformę kopii w chmurze z centrami danych w Polsce. Jeśli chcesz ustalić, które repozytoria i systemy wymagają jakiej kopii i jak szybko trzeba je odtworzyć, porozmawiaj z nami.

Co jeszcze warto wiedzieć o kopii zapasowej repozytoriów?

Czy GitHub przywróci usunięte repozytorium?

Czasem tak. Według dokumentacji GitHub usunięte repozytorium można przywrócić w ciągu 90 dni, chyba że należało do sieci forków, która nie jest pusta. Przywrócenie nie odtwarza uprawnień zespołów, a pomoc wsparcia w nietypowych przypadkach przysługuje tylko na płatnych planach. To funkcja ratunkowa, a nie kopia zapasowa.

Czy klony repozytorium na laptopach programistów wystarczą jako kopia?

Nie. Klon na laptopie zawiera tylko to, co dany programista pobrał, nie ma zgłoszeń, przeglądów kodu ani konfiguracji CI i znika razem z laptopem. Nikt też nie sprawdza, czy taki zbiór klonów obejmuje wszystkie repozytoria i gałęzie.

Czy GitLab Self-Managed potrzebuje osobnej kopii zapasowej?

Tak. Przy instancji utrzymywanej we własnym zakresie kopię wykonuje jej administrator. Dokumentacja GitLab opisuje procedury kopii i odtwarzania instancji i zaleca plan odtwarzania z regularnymi kopiami.

Jak często robić kopię repozytoriów?

Tak często, jak wynika z akceptowalnej utraty danych dla danego repozytorium. Repozytorium produktu, w którym zespół pracuje codziennie, wymaga innej częstotliwości niż archiwalny projekt. Częstotliwość warto ustalić w analizie wpływu na biznes razem z innymi systemami.

Czy kopia repozytorium może zawierać sekrety?

Tak, jeśli ktoś kiedykolwiek zapisał w repozytorium hasło, klucz albo token, bo historia Git przechowuje każdą wersję pliku. Dlatego kopię trzeba chronić jak środowisko produkcyjne: szyfrować, ograniczać dostęp i rejestrować, kto ją odczytuje.

Udostępnij:

Porozmawiaj z ekspertem

Masz pytania dotyczące tego tematu? Skontaktuj się z naszym opiekunem.

Opiekun handlowy
Grzegorz Gnych

Grzegorz Gnych

Opiekun handlowy

Odpowiedź w ciągu 24 godzin
Konsultacja z ekspertem
Indywidualne podejście

Podanie numeru telefonu przyspieszy kontakt.

Chcesz obniżyć ryzyko i koszty IT?

Umów konsultację - odpowiemy w ciągu 24h

Odpowiedź w 24h Indywidualna wycena Bez zobowiązań

Lub pobierz bezpłatny przewodnik:

E-book: Strategia odporności cyfrowej 2026