Git Remote
Ostatnia aktualizacja
git remote zarządza krótkimi nazwami, których twoje repozytorium używa dla repozytoriów zdalnych. Najczęściej to origin, wskazujące na twoje repozytorium na GitHubie. Używasz go, żeby dodać repozytorium zdalne na starcie, wyświetlić te, które masz, zmienić ich nazwy albo je usunąć i zmienić adres URL (na przykład przejść z HTTPS na SSH).
Wypróbuj te polecenia w terminalu online: prawdziwa powłoka w przeglądarce, bez żadnej instalacji.
Składnia
| Polecenie | Co robi |
|---|---|
git remote -v | Wyświetla repozytoria zdalne z adresami URL |
git remote add origin <url> | Dodaje repozytorium zdalne o nazwie origin |
git remote set-url origin <url> | Zmienia adres URL repozytorium zdalnego |
git remote rename origin upstream | Zmienia nazwę repozytorium zdalnego |
git remote remove origin | Usuwa repozytorium zdalne |
git remote show origin | Pokazuje szczegóły repozytorium zdalnego |
Typowe przypadki
| Cel | Polecenie |
|---|---|
| Połączyć nowe repozytorium z GitHubem | git remote add origin <url> |
| Przejść z HTTPS na SSH | git remote set-url origin git@github.com:... |
| Sprawdzić, na co wskazuje origin | git remote -v |
Przykład krok po kroku
| Krok | Polecenie | Wynik |
|---|---|---|
| 1 | git remote add origin https://github.com/you/app.git | Rejestruje repozytorium z GitHuba pod nazwą origin |
| 2 | git remote -v | Wyświetla origin z adresami URL dla fetch i push |
| 3 | git push -u origin main | Wysyła main i ustawia śledzenie origin/main |
Najczęstsze pytania o git remote
Czym jest repozytorium zdalne w Git?
Remote to nazwane odwołanie do repozytorium hostowanego gdzie indziej, zwykle na GitHubie, GitLabie albo serwerze. Domyślna nazwa to
origin. Z repozytoriami zdalnymi synchronizują się git push, git pull i git fetch. git remote to polecenie do zarządzania tymi nazwanymi odwołaniami.Jak dodać repozytorium zdalne?
Uruchom
git remote add origin <url> z adresem URL repozytorium. To łączy twoje lokalne repozytorium ze zdalnym pod nazwą origin. Potem możesz wypchnąć zmiany przez git push -u origin main. Jeśli nazwa origin jest już zajęta, użyj innej (np. upstream).Jak zmienić adres URL repozytorium zdalnego?
Użyj
git remote set-url origin <new-url>. Tak przełączysz repozytorium z adresu HTTPS na SSH (albo zaktualizujesz go po zmianie nazwy repozytorium) bez usuwania i ponownego dodawania repozytorium zdalnego. Sprawdź wynik przez git remote -v.Jak zobaczyć moje repozytoria zdalne?
Uruchom
git remote -v, żeby wyświetlić każde repozytorium zdalne z adresami URL dla fetch i push. Szczegółowy widok jednego z nich, razem ze śledzonymi gałęziami, daje git remote show origin.Co robi git remote add origin?
Zapisuje adres URL pod nazwą
origin w konfiguracji twojego repozytorium. Nic nie jest jeszcze wysyłane ani pobierane: polecenie tylko tworzy nazwę, żeby później można było wpisać git push origin main zamiast pełnego adresu URL. Jeśli origin już istnieje, Git odmawia z komunikatem "remote origin already exists"; użyj git remote set-url origin <url>, żeby wskazać inny adres.Czym różni się origin od upstream?
Obie nazwy to tylko konwencja.
origin to repozytorium zdalne, z którego klonujesz albo do którego pierwszy raz wypychasz zmiany, zwykle twoja własna kopia. Gdy robisz fork projektu, oryginalne repozytorium często dodaje się jako drugie repozytorium zdalne o nazwie upstream przez git remote add upstream <url>, żeby pobierać z niego zmiany, a wypychać do swojego forka.Jak pobrać gałąź z repozytorium zdalnego?
Uruchom
git fetch origin, żeby pobrać wszystkie gałęzie, a potem git switch <branch>, żeby utworzyć lokalną gałąź śledzącą origin/<branch>. Warianty omawia strona checkout zdalnej gałęzi.Czy mogę to przećwiczyć online?
Tak. Otwórz terminal online i uruchom
git remote w prawdziwej powłoce w przeglądarce, bez żadnej instalacji. Darmowy interaktywny kurs Git w Coddy też krok po kroku omawia łączenie z repozytoriami zdalnymi.Powiązane materiały
Więcej komend Git
