Generator ~/.ssh/config

Generator konfiguracji SSH

Plik ~/.ssh/config pozwala zapisać parametry połączeń i używać krótkich aliasów. Zamiast wpisywać długie polecenia, wystarczy ssh serwer.

Najważniejsze opcje

Uprawnienia pliku

Plik ~/.ssh/config powinien mieć uprawnienia 600, a katalog ~/.ssh — 700. Inaczej SSH zignoruje konfigurację.

Przykład

Po dodaniu wpisu z aliasem prod łączysz się przez ssh prod, a narzędzia takie jak scp czy rsync również korzystają z tych ustawień.

Jak generator zamienia formularz na blok Host

Generator działa lokalnie i nie łączy się z żadnym serwerem. Jego zadaniem jest zamiana wartości z formularza na składnię zrozumiałą dla OpenSSH. Każdy wpis powstaje jako blok rozpoczynający się od dyrektywy Host, która pełni rolę aliasu, a w kolejnych liniach znajdują się parametry połączenia. Narzędzie nie zgaduje danych, których nie podano — jeśli pole zostaje puste, nie powinno tworzyć pustej dyrektywy.

OpenSSH czyta plik config od góry do dołu. Dla danego połączenia wybiera bloki, których wzorzec Host pasuje do nazwy użytej w poleceniu. W praktyce oznacza to, że bardziej szczegółowe wpisy trzeba umieszczać przed ogólnymi, na przykład przed Host *. Późniejszy blok może uzupełnić tylko te opcje, które nie zostały ustawione wcześniej, dlatego kolejność jest częścią mechanizmu, a nie kosmetyką.

Wzorce w dyrektywie Host mogą zawierać znaki specjalne, takie jak gwiazdka lub znak zapytania. Dzięki temu można jednym blokiem objąć całą domenę albo grupę serwerów. Generator porządkuje wpisy, ale nie interpretuje ich za OpenSSH — wynikowy plik nadal działa według reguł klienta SSH.

Przykład krok po kroku: alias do bazy przez bastion

1. W polu Host wpisz alias db-prod. To nazwa, której będziesz używać w poleceniu ssh, a nie adres serwera.
2. W polu HostName podaj db.example.com, czyli rzeczywistą nazwę DNS maszyny docelowej.
3. Ustaw User na deploy, Port na 22, a IdentityFile na ~/.ssh/id_ed25519. Port 22 jest domyślny, ale wpisany jawnie nie zmienia działania.
4. W polu ProxyJump wskaż bastion. Połączenie do db-prod przejdzie najpierw przez ten serwer pośredniczący.
5. Zapisz wygenerowany blok w pliku ~/.ssh/config. Katalog ~/.ssh ustaw na 700, a sam plik config na 600.
6. Wykonaj polecenie ssh db-prod. OpenSSH użyje aliasu, adresu db.example.com, użytkownika deploy, portu 22, klucza id_ed25519 i bastionu jako ProxyJump. Blok ma 6 linii: nagłówek Host oraz 5 dyrektyw.

Tabela referencyjna dyrektyw i uprawnień

Praktyczne wskazówki przy budowaniu configu

• Trzymaj osobne bloki dla różnych środowisk — nie mieszaj produkcyjnego aliasu z testowym w jednym Host. Łatwiej wtedy zmienić klucz lub port bez wpływu na resztę.
• Wartości domyślne przenieś do Host * — ustaw tam User, IdentityFile albo Port 22, a w blokach szczegółowych nadpisuj tylko wyjątki.
• Komentuj wpisy — linia zaczynająca się od # pomaga opisać, do czego służy alias, szczególnie gdy config rośnie.
• Testuj efektywną konfigurację — polecenie ssh -G alias wypisuje wartości, które OpenSSH faktycznie zastosuje. To szybsze niż szukanie błędu w pliku.
• Nie kopiuj prywatnych kluczy do repozytorium — w configu podawaj ścieżkę do klucza, a sam plik klucza trzymaj poza projektem i zabezpiecz uprawnieniami.

Czego generator nie zrobi za Ciebie

• Nie sprawdza dostępności hosta — wygenerowany wpis może być poprawny składniowo, ale serwer może być wyłączony, port zablokowany przez firewall albo DNS nie działa.
• Nie zastępuje sshd_config — konfiguracja po stronie klienta nie zmienia ustawień serwera SSH ani zasad logowania.
• Nie tworzy ani nie kopiuje kluczy — IdentityFile to tylko ścieżka; jeśli plik nie istnieje albo ma złe uprawnienia, uwierzytelnianie nie zadziała.
• Nie rozstrzyga konfliktów kolejności — OpenSSH wybiera wartości według własnych reguł dopasowania i kolejności bloków. Generator ustawia tekst, ale nie gwarantuje, że nadpiszesz wcześniejszy wpis w innym pliku config.

Najczęstsze pytania