user@homelab:~/docs$ cat troubleshooting.md

Troubleshooting

Technické problémy při stavbě homelabu: příznak, příčina a řešení

# obsah
#PříznakPříčinaŘešení
1Windows instalátor chce síť a Microsoft účetvýchozí chování Win11 HomeShift+F10 → start ms-cxh:localonly, Ventoy VTOY_WIN11_BYPASS_NRO
2Po instalaci Win se nebootuje z USBWindows Boot Manager první v UEFINovo → Boot Menu → EFI USB Device
3Ubuntu: Probing for devices to install to failed, Invalid dep_id (disk-dm-1)Ventoy připojuje ISO přes device-mapperVentoy → Boot in grub2 mode
4Ubuntu: chybí Add GPT Partition a free spaceinstalátor v grub2 režimu nenačetl mezery mezi oddílysgdisk -n 0:0:0 … v shellu instalátoru a restart
5Wi-Fi nefunguje (ani hotspot)rfkill soft=1 + prázdné wifis: {} v netplanuodblokovat přes /sys/class/rfkill/*/soft + 50-wifi.yaml
6V instalátoru není rfkillminimální prostředíinstalovat bez sítě, řešit až v systému
7GRUB menu se nezobrazíUbuntu Server má GRUB_TIMEOUT=0GRUB_TIMEOUT_STYLE=menu, GRUB_TIMEOUT=5
8Windows v GRUBu dvakrátos-prober + ruční položka v 40_customodstranit ruční položku
9Rezervace v routeru poskytovatele nefungujeadresy přiděluje vlastní Wi-Fi router za nímDHCP rezervace na routeru, který je bránou (route -n get default)
10Flux: apps hlásí dependency ‘flux-system/infra’ is not readypo novém commitu se infra synchronizuje jako první (dependsOn)nic, za chvíli se srovná; urychlit: flux reconcile kustomization apps

Užitečné diagnostické příkazy

shell @ server
lsblk -o NAME,SIZE,MODEL,MOUNTPOINTS          # disky a oddíly
sudo parted /dev/sda unit GiB print free      # včetně volného místa
grep . /sys/class/rfkill/*/{name,soft,hard}   # blokace rádií
ip -br addr ; ip route                        # adresy a brána
networkctl status wlp3s0 --no-pager           # stav Wi-Fi
sudo journalctl -u ssh -n 20 --no-pager       # proč SSH odmítl přihlášení
sudo sshd -T | grep -i auth                   # výsledná konfigurace sshd
sudo ufw status verbose                       # firewall
k get pods -A ; k get events -A --sort-by=.lastTimestamp | tail

Ponaučení

  • Bez sítě skripty na USB disku: diagnostika i konfigurace jako skript, výstup uložený do souboru místo ručního přepisování.
  • Před zákazem hesel test přihlášení klíčem a druhé SSH okno jako pojistka.
  • Pevná IP před k3s: k3s si adresu zapíše do certifikátů a kubeconfigu.