user@homelab:~/docs$ cat 11-troubleshooting.md
Troubleshooting
Všechny chyby z první session: příznak, příčina a řešení na jednom místě
# obsah
| # | Příznak | Příčina | Řešení |
|---|---|---|---|
| 1 | Windows instalátor chce síť a Microsoft účet | výchozí chování Win11 Home | Shift+F10 → start ms-cxh:localonly, Ventoy VTOY_WIN11_BYPASS_NRO |
| 2 | Po instalaci Win se nebootuje z USB | Windows Boot Manager první v UEFI | Novo → Boot Menu → EFI USB Device |
| 3 | Ubuntu: Probing for devices to install to failed, Invalid dep_id (disk-dm-1) | Ventoy připojuje ISO přes device-mapper | Ventoy → Boot in grub2 mode |
| 4 | Ubuntu: chybí Add GPT Partition a free space | instalátor v grub2 režimu nenačetl mezery mezi oddíly | sgdisk -n 0:0:0 … v shellu instalátoru a restart |
| 5 | Wi-Fi nefunguje (ani hotspot) | rfkill soft=1 + prázdné wifis: {} v netplanu | odblokovat přes /sys/class/rfkill/*/soft + 50-wifi.yaml |
| 6 | V instalátoru není rfkill | minimální prostředí | instalovat bez sítě, řešit až v systému |
| 7 | GRUB menu se nezobrazí | Ubuntu Server má GRUB_TIMEOUT=0 | GRUB_TIMEOUT_STYLE=menu, GRUB_TIMEOUT=5 |
| 8 | Windows v GRUBu dvakrát | os-prober + ruční položka v 40_custom | odstranit ruční položku |
| 9 | ssh-keygen vytvořil klíč na serveru | příkaz spuštěný v SSH relaci | smazat, vytvořit na Macu, nahrát přes ssh-copy-id |
| 10 | Bad configuration option: yhost | překlep v ~/.ssh/config | smazat zbloudilé y |
| 11 | Could not resolve hostname ip | v HostName zůstalo doslova IP | dosadit <ip-serveru> |
| 12 | zsh: command not found: ip | linuxový příkaz spuštěný na Macu | Mac: route -n get default |
| 13 | Správa routeru nejde otevřít v prohlížeči | Mac posílá web přes proxy (200 Connection Established) | otevřít z mobilu, v Terminálu --noproxy '*' |
| 14 | Rezervace v routeru poskytovatele nefunguje | adresy přiděluje vlastní Wi-Fi router za ním | DHCP rezervace na routeru, který je bránou (route -n get default) |
| 15 | Termius: Handshake finished, pak chyba | chybí uživatel a klíč v Credentials | Username <uživatel> + Key ipad |
| 16 | buildah build: apk hlásí temporary error, no such package | build kontejner nemá internet: ufw zahazuje přeposílaný provoz (disabled (routed)) | buildah build --network=host |
| 17 | read vrátil prázdný token (Délka tokenu: 0) | blok příkazů vložený najednou: read „snědl“ následující řádek | příkazy čekající na vstup spouštět samostatně; prázdný Secret smazat a vytvořit znovu |
| 18 | secrets "tunnel-token" already exists | Secret z předchozího pokusu | kubectl -n cloudflared delete secret tunnel-token a znovu |
| 19 | Na serveru chybí cloudflared/ | nahraný starý zip, prohlížeč nový uložil jako homelab-docs (1).zip | ls -lt ~/Downloads/homelab-docs*.zip, nahrát nejnovější |
| 20 | unzip: cannot find homelab-docs.zip | příkaz spuštěný uvnitř ~/homelab-docs, zip leží v ~ | cd ~ a znovu |
Užitečné diagnostické příkazy
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 | tailPonaučení
- Instalační skripty místo psaní z fotky: bez sítě a schránky ušetřil čas skript na USB disku, který zároveň uložil diagnostiku do souboru.
- 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.
- Interaktivní příkazy nevkládat v bloku:
read,passwdnebo instalátory si jako vstup vezmou další vložené řádky. - Kontrolovat verzi souborů: před nasazením ověřit, že na serveru je opravdu nová verze (
ls,unzip -l).