Fork: 0
root / homeassistant-infra
Transfer to URL with SHA Find file
Newer
Older
homeassistant-infra / docs / HA_SSH_ACTIVATION_GUIDE.md
Wojciech Konieczny 23 days ago 5 KB Dodano instrukcję aktywacji SSH na Home Assistant
Raw Blame History

Jak aktywować SSH na Home Assistant

Data: 2026-02-05
Dotyczy: HA TEST (192.168.50.151) i HA PROD (192.168.50.242)

Metoda 1: Terminal & SSH addon (ZALECANE)

Krok 1: Zaloguj się do Home Assistant

Krok 2: Otwórz Add-on Store

  1. W menu po lewej kliknij Settings (Ustawienia)
  2. Kliknij Add-ons
  3. Kliknij ADD-ON STORE (prawy dolny róg)

Krok 3: Znajdź SSH addon

  1. Wyszukaj: Terminal & SSH
  2. Lub znajdź w kategorii Official add-ons
  3. Kliknij na Terminal & SSH

Krok 4: Zainstaluj addon

  1. Kliknij INSTALL
  2. Poczekaj 1-2 minuty (addon się pobierze i zainstaluje)

Krok 5: Skonfiguruj SSH

  1. Po instalacji przejdź do zakładki Configuration
  2. W sekcji password: wprowadź hasło SSH
  3. ZALECANE HASŁO: QWer!@34 (to samo co do HA)
  4. Przykładowa konfiguracja:
ssh:
  username: hassio
  password: QWer!@34
  authorized_keys: []
  sftp: false
  compatibility_mode: false
  allow_agent_forwarding: false
  allow_remote_port_forwarding: false
  allow_tcp_forwarding: false
  1. Kliknij SAVE (Zapisz)

Krok 6: Uruchom SSH

  1. Przejdź do zakładki Info
  2. Włącz opcję Start on boot (Start przy bootowaniu)
  3. Włącz opcję Watchdog (Auto-restart jeśli się zawiesza)
  4. Kliknij START
  5. Poczekaj 10-20 sekund

Krok 7: Sprawdź czy działa

Status powinien pokazywać RUNNING (zielony)

Testowanie połączenia SSH

Z systemu Linux/Mac:

# TEST
ssh -p 22 root@192.168.50.151
# Hasło: QWer!@34

# PROD
ssh -p 22 root@192.168.50.242
# Hasło: QWer!@34

Z Windows (PowerShell):

ssh -p 22 root@192.168.50.151

Po zalogowaniu:

# Sprawdź katalogi HA
ls -la /config
ls -la /config/custom_components

# Sprawdź wersję HA
ha core info

# Zobacz logi
ha core logs

Przydatne ścieżki w HAOS przez SSH

  • /config/ - Główny katalog konfiguracji
  • /config/configuration.yaml - Główny plik konfiguracyjny
  • /config/automations.yaml - Automatyzacje
  • /config/scripts.yaml - Skrypty
  • /config/custom_components/ - Własne integracje (HACS)
  • /config/.storage/ - Pliki systemowe (config_entries, auth, etc.)
  • /share/ - Współdzielony katalog (backupy, etc.)
  • /backup/ - Backupy HA
  • /ssl/ - Certyfikaty SSL

Przydatne komendy przez SSH

Zarządzanie Home Assistant:

ha core info            # Info o wersji HA
ha core logs            # Logi HA
ha core restart         # Restart HA Core
ha core rebuild         # Przebuduj HA Core
ha core update          # Update HA

ha supervisor info      # Info o Supervisor
ha supervisor logs      # Logi Supervisor
ha supervisor restart   # Restart Supervisor

Zarządzanie addonami:

ha addons               # Lista addonów
ha addons logs <addon>  # Logi addona
ha addons restart <addon> # Restart addona
ha addons start <addon>   # Start addona
ha addons stop <addon>    # Stop addona

Zarządzanie hostem:

ha host reboot          # Reboot całej maszyny
ha host shutdown        # Wyłącz maszynę
ha host info            # Info o hoście

System:

df -h                   # Dyski
free -h                 # RAM
top                     # Procesy
journalctl -f           # Logi systemowe

Instalacja custom_components przez SSH

Po aktywacji SSH możesz instalować integracje bez montowania dysków!

Przykład - instalacja Solcast:

# Zaloguj się przez SSH
ssh root@192.168.50.151

# Pobierz integrację
cd /tmp
wget https://github.com/BJReplay/ha-solcast-solar/archive/refs/heads/main.zip
unzip main.zip

# Skopiuj do custom_components
mkdir -p /config/custom_components
cp -r ha-solcast-solar-main/custom_components/solcast_solar /config/custom_components/

# Sprawdź
ls -la /config/custom_components/solcast_solar

# Posprzątaj
rm -rf /tmp/main.zip /tmp/ha-solcast-solar-main

# Restart HA
ha core restart

Bezpieczeństwo

⚠️ WAŻNE UWAGI:

  1. SSH addon daje dostęp root do całego systemu!
  2. Używaj silnych haseł!
  3. Opcjonalnie: Dodaj klucze SSH zamiast hasła
  4. Nie wystawiaj portu 22 na internet!
  5. SSH tylko z lokalnej sieci (192.168.50.x)

Rekomendowane ustawienia:

ssh:
  username: hassio
  password: QWer!@34
  authorized_keys: []
  sftp: false
  compatibility_mode: false
  allow_agent_forwarding: false
  allow_remote_port_forwarding: false
  allow_tcp_forwarding: false

Alternatywa: File Editor addon

Jeśli chcesz tylko edytować pliki (bez SSH):

  1. Add-on Store → File editor
  2. Install → Start
  3. Przejdź do addon w menu po lewej
  4. Edytuj pliki bezpośrednio w przeglądarce

Zalety:

  • Łatwiejszy w użyciu
  • Bezpieczniejszy (brak dostępu shell)
  • Podświetlanie składni

Wady:

  • Brak możliwości uruchamiania komend
  • Nie można instalować pakietów
  • Tylko edycja plików

Troubleshooting

Problem: "Connection refused"

Rozwiązanie:

  • Sprawdź czy addon jest uruchomiony (RUNNING)
  • Sprawdź firewall na HA
  • Spróbuj restart addona

Problem: "Permission denied"

Rozwiązanie:

  • Sprawdź hasło (case-sensitive!)
  • Sprawdź czy hasło jest ustawione w konfiguracji

Problem: "Port 22 already in use"

Rozwiązanie:

  • Zmień port w konfiguracji SSH addon (np. na 22222)
  • Podłącz się: ssh -p 22222 root@192.168.50.151

Co dalej?

Po aktywacji SSH:

  1. ✅ Zainstaluj Solcast przez SSH (szybciej niż przez HACS)
  2. ✅ Edytuj configuration.yaml bezpośrednio
  3. ✅ Dodawaj automatyzacje przez pliki
  4. ✅ Debuguj problemy przez logi
  5. ✅ Robij backupy przez SSH

Status: 📝 Instrukcja gotowa - czeka na aktywację przez użytkownika