Połączenie SSH

Połączenie SSH pozwala na zaawansowaną konfigurację sterownika, dostęp do plików konfiguracyjnych oraz wykonywanie komend systemowych. Jest przydatne przy:

• Ręcznej edycji plików konfiguracyjnych YAML
• Diagnostyce problemów
• Konfiguracji sieci (np. statyczny adres IP)
• Aktualizacji systemu operacyjnego

Wymagania wstępne

• Adres IP sterownika (znajdziesz go na wyświetlaczu sterownika lub w panelu routera)
• Klient SSH (wbudowany w Windows 10+, Linux i macOS)

Połączenie przez sieć Ethernet

Windows

1. Naciśnij przycisk Start
2. Wpisz cmd i naciśnij Enter
3. W oknie terminala wpisz:

ssh boneio@ADRES_IP_STEROWNIKA

Możesz też użyć Windows Terminal: https://github.com/microsoft/terminal

Linux / macOS

1. Otwórz terminal (np. GNOME Terminal, XFCE Terminal, Terminal.app)
2. Wpisz:

ssh boneio@ADRES_IP_STEROWNIKA

Pierwsze połączenie

Przy pierwszym połączeniu pojawi się pytanie o akceptację klucza SSH:

The authenticity of host '192.168.1.100 (192.168.1.100)' can't be established.
ED25519 key fingerprint is SHA256:...
Are you sure you want to continue connecting (yes/no/[fingerprint])?

Wpisz yes i naciśnij Enter.

Dane logowania

• Użytkownik: boneio
• Hasło:
  • na sterowniku skonfigurowanym z wersją 1.6 lub nowszą — hasło, które wybrałeś dla konta administratora w pierwszym uruchomieniu. Dopóki kreator nie zostanie ukończony, logowanie hasłem po SSH w ogóle nie działa.
  • na starszym sterowniku — Black, chyba że je zmieniłeś. Zmień je (patrz niżej): użytkownik boneio może zostać rootem.

Późniejsza zmiana hasła w panelu nie zmienia hasła SSH — zobacz Zmiana hasła. Bezpośrednie logowanie jako root po SSH jest wyłączone.

Po trzech błędnych hasłach połączenie zostaje zamknięte. Twój komputer musi wtedy odczekać pięć minut, zanim sterownik znów go wpuści (tak samo po każdym połączeniu zamkniętym po błędnym haśle), a przy kolejnych razach czas rośnie, aż do godziny. Dzięki temu zgadywanie hasła nie ma sensu. Literówka, po której w tym samym połączeniu wpiszesz poprawne hasło, nic nie kosztuje.

Połączenie przez USB

Jeśli sterownik nie ma połączenia sieciowego, możesz połączyć się przez kabel USB:

1. Podłącz kabel USB do portu USB sterownika i do komputera
2. Poczekaj aż komputer rozpozna urządzenie sieciowe
3. Twój komputer otrzyma adres IP z zakresu 192.168.7.x
4. Sterownik będzie dostępny pod adresem 192.168.7.2

ssh boneio@192.168.7.2

Podstawowe komendy

Po zalogowaniu możesz używać następujących komend:

Przejście do katalogu konfiguracji

cd ~/boneio

Wyświetlenie plików konfiguracyjnych

ls -la ~/boneio/

Edycja pliku konfiguracyjnego

nano ~/boneio/config.yaml

Restart usługi boneIO

sudo systemctl restart boneio

Sprawdzenie statusu usługi

sudo systemctl status boneio

Wyświetlenie logów

journalctl -u boneio -f

Zmiana hasła

Najprościej z panelu: Ustawienia → Dostęp → Konta użytkowników, karta Hasło logowania SSH, Zmień hasło SSH. Panel pyta o obecne hasło SSH i dwa razy o nowe — zobacz Hasło logowania SSH.

Po SSH to samo robi:

passwd

Zostaniesz poproszony o podanie obecnego hasła, a następnie dwukrotne wpisanie nowego hasła. Jeśli logowanie boneio nie ma żadnego hasła, to jedyny sposób — panel nie ma obecnego hasła do sprawdzenia.

Rozwiązywanie problemów

Odmowa połączenia (Connection refused)

• Sprawdź czy sterownik jest włączony i podłączony do sieci
• Upewnij się, że wpisujesz prawidłowy adres IP
• Sprawdź czy usługa SSH jest uruchomiona na sterowniku

Połączenie zamyka się od razu, po wcześniejszych błędnych hasłach

Jeśli połączenie zamyka się, zanim w ogóle padnie pytanie o hasło, a chwilę wcześniej pomyliłeś hasło, sterownik każe Twojemu adresowi czekać — zobacz Dane logowania. Odczekaj pięć minut i połącz się ponownie.

Timeout połączenia

• Sprawdź czy komputer i sterownik są w tej samej sieci
• Sprawdź ustawienia firewalla na komputerze

Błąd klucza SSH

Jeśli pojawi się błąd związany ze zmianą klucza SSH (np. po reinstalacji systemu na sterowniku):

ssh-keygen -R ADRES_IP_STEROWNIKA

Następnie spróbuj połączyć się ponownie.