Dwa konta GitHub, jeden komputer · krok 4 z 7

macOS: klucze SSH i Keychain

ssh-agent na macOS zapamiętuje hasło w Pęku kluczy — jedna flaga i restarty przestają być problemem.

1. Wygeneruj dwa klucze SSH

W Terminalu:

ssh-keygen -t ed25519 -f ~/.ssh/id_ed25519_user1 -C "user1@example.com"
ssh-keygen -t ed25519 -f ~/.ssh/id_ed25519_user2 -C "user2@example.com"

Ustaw passphrase dla każdego klucza — na macOS obsługa “nie pytaj za każdym razem” jest wbudowana i wygodniejsza niż na Windowsie (patrz krok 6).

2. Dodaj klucze publiczne na GitHubie

cat ~/.ssh/id_ed25519_user1.pub | pbcopy

Wklej zawartość w Settings → SSH and GPG keys na koncie user1. Powtórz dla user2.

Nazwa pliku klucza i etykieta “Title” na GitHubie są dowolne — to tylko opisy dla Ciebie. Musi się za to zgadzać dokładnie zawartość klucza publicznego oraz konto, na które go dodajesz. Więcej w kroku “Jak to działa”.

3. Podepnij klucze w .gitconfig-userX

To plik, który utworzyłeś w kroku 1 tutoriala (w katalogu domowym, czyli ~, np. /Users/twojanazwa/.gitconfig-user1). Teraz dopisujesz do niego sekcję [core] wskazującą na konkretny klucz.

Otwórz plik w edytorze terminalowym nano (prostszy niż vim dla początkujących):

nano ~/.gitconfig-user1

Jeśli plik już istnieje z kroku 1 (z sekcją [user]), zobaczysz jego zawartość. Strzałkami zjedź na koniec pliku i dopisz nową sekcję. Cały plik powinien wyglądać tak:

[user]
    name = User1
    email = user1@example.com
[core]
    sshCommand = "ssh -i ~/.ssh/id_ed25519_user1 -o IdentitiesOnly=yes"

Zapisz i wyjdź z nano: Ctrl+O (zapisz), Enter (zatwierdź nazwę pliku), Ctrl+X (wyjdź). Powtórz identycznie dla .gitconfig-user2, podmieniając user1 na user2 w obu miejscach (nazwa pliku i ścieżka do klucza w sshCommand).

Alternatywa bez otwierania edytora — dopisanie sekcji od razu z terminala:

cat >> ~/.gitconfig-user1 << 'EOF'
[core]
    sshCommand = "ssh -i ~/.ssh/id_ed25519_user1 -o IdentitiesOnly=yes"
EOF

To dopisze sekcję [core] na końcu pliku, nie ruszając tego, co już tam jest. Sprawdź efekt:

cat ~/.gitconfig-user1

Powinieneś zobaczyć obie sekcje, [user] i [core], jedna pod drugą.

Ścieżki z ~ zwykle działają poprawnie w core.sshCommand na macOS/Linuksie (w przeciwieństwie do Windows, gdzie bezpieczniej jest podać pełną ścieżkę).

4. Zmień remote repozytorium na SSH

git remote set-url origin git@github.com:user1/nazwa-repo.git
git remote -v

5. Test połączenia

ssh -T -i ~/.ssh/id_ed25519_user1 -o IdentitiesOnly=yes git@github.com

Powinno pokazać Hi user1! You've successfully authenticated....

6. Żeby nie wpisywać passphrase przy każdym pushu

macOS ma wbudowaną integrację ssh-agent z Pękiem kluczy (Keychain). Dodaj wpis w ~/.ssh/config:

Host github.com-user1
    HostName github.com
    User git
    IdentityFile ~/.ssh/id_ed25519_user1
    UseKeychain yes
    AddKeysToAgent yes

Host github.com-user2
    HostName github.com
    User git
    IdentityFile ~/.ssh/id_ed25519_user2
    UseKeychain yes
    AddKeysToAgent yes

UseKeychain yes + AddKeysToAgent yes sprawiają, że po jednorazowym podaniu hasła przy pierwszym ssh-add, hasło jest zapisane w Pęku kluczy i przetrwa restart komputera — w przeciwieństwie do Windows.

Dodaj klucze raz:

ssh-add --apple-use-keychain ~/.ssh/id_ed25519_user1
ssh-add --apple-use-keychain ~/.ssh/id_ed25519_user2

Sprawdź:

ssh-add -l

Jeśli używasz aliasów Host github.com-userX z ~/.ssh/config razem z core.sshCommand w gitconfigu — wybierz jeden mechanizm, żeby się nie gryzły. Prostszy w utrzymaniu jest sam core.sshCommand (krok 1 tutoriala) bez aliasów w ~/.ssh/config; jeśli wolisz aliasy, w .gitconfig-userX zamiast core.sshCommand po prostu zmień remote na git@github.com-user1:user1/repo.git.

Uwaga: Git od Apple vs Git z Homebrew

macOS ma domyślnie zainstalowany Git od Apple (Xcode Command Line Tools). Jeśli zainstalowałeś dodatkowo Git przez Homebrew, sprawdź który jest używany:

which git
git --version

includeIf działa identycznie w obu, ale warto wiedzieć, z której instalacji korzystasz, gdy coś nie działa zgodnie z oczekiwaniami.