Proxmox VE od zera — kompletny przewodnik

Czym jest Proxmox VE?

Proxmox Virtual Environment (w skrócie Proxmox VE lub PVE) to otwartoźródłowa platforma do wirtualizacji, która łączy dwa światy w jednym, przejrzystym interfejsie webowym: pełną wirtualizację opartą na KVM (Kernel-based Virtual Machine) oraz lekkie kontenery LXC (Linux Containers). Projekt jest rozwijany przez austriacką firmę Proxmox Server Solutions GmbH i bazuje na Debianie — stabilnym, sprawdzonym fundamencie.

Dlaczego właśnie Proxmox, a nie VMware ESXi czy Hyper-V? Powodów jest kilka:

Jeśli masz stary komputer, laptopa, OptiPlex lub serwer rack — Proxmox zamieni go w prawdziwe centrum danych. To nie przesada.

---

Wymagania sprzętowe

Proxmox jest zaskakująco skromny w wymaganiach, ale jak zawsze — im więcej RAM-u, tym lepiej. Oto co powinieneś wiedzieć przed instalacją:

Minimalne wymagania

| Komponent | Minimum |

|-----------|---------|

| CPU | 64-bit (Intel lub AMD), 2 rdzenie |

| RAM | 4 GB (realnie: 2 GB zajmuje sam system) |

| Dysk systemowy | 32 GB (SSD zalecany) |

| Sieć | 1x port Gigabit Ethernet |

Zalecane wymagania dla homelabu

| Komponent | Zalecane |

|-----------|----------|

| CPU | Intel Core i5/i7 8. generacji lub nowszy, AMD Ryzen 5/7 |

| RAM | 32 GB DDR4 ECC (lub non-ECC jeśli używasz ZFS bez kluczowych danych) |

| Dysk systemowy | SSD NVMe 256 GB lub więcej |

| Dysk danych | 2+ TB HDD lub SSD (najlepiej kilka w RAID/ZFS) |

| Sieć | 1-2x Gigabit Ethernet, opcjonalnie 10GbE |

Ważna uwaga o ECC RAM

Jeśli planujesz używać ZFS (a powinieneś), społeczność homelabowa jest podzielona w kwestii ECC RAM. Oficjalnie ZFS preferuje ECC, ale w praktyce tysiące homelabowców używa ZFS z non-ECC bez problemów. Na potrzeby homelabu non-ECC jest akceptowalne — na serwer produkcyjny z krytycznymi danymi: postaw na ECC.

Świetne platformy dla Proxmox

---

Instalacja krok po kroku

Krok 1: Pobranie obrazu ISO

Pobierz najnowszy obraz ISO ze strony [proxmox.com/downloads](https://www.proxmox.com/en/downloads). Na dzień pisania tego artykułu aktualna wersja to Proxmox VE 8.x.

Krok 2: Nagranie na pendrive

Użyj narzędzia **Balena Etcher** (Windows/macOS/Linux) lub `dd` na Linuksie:

```bash

# Na Linux/macOS — zamień /dev/sdX na swój pendrive (sprawdź przez lsblk lub diskutil list)

sudo dd if=proxmox-ve_8.x-1.iso of=/dev/sdX bs=1M status=progress

```

Na Windows polecam Rufus w trybie DD Image.

Krok 3: Boot z pendrive'a

Wejdź do BIOS/UEFI (zwykle F2, F12, DEL podczas startu), ustaw pendrive jako pierwsze urządzenie bootujące. Wyłącz Secure Boot — Proxmox tego nie lubi.

Krok 4: Instalator Proxmox

Instalator jest graficzny i intuicyjny:

1. Wybierz **"Install Proxmox VE (Graphical)"**

2. Zaakceptuj licencję EULA

3. Wybierz dysk docelowy — jeśli masz kilka dysków, możesz od razu skonfigurować ZFS RAID

4. Ustaw strefę czasową (Europe/Warsaw)

5. Wprowadź hasło roota i adres e-mail (dla alertów)

6. Skonfiguruj sieć:

- Adres IP (statyczny, np. `192.168.1.10/24`)

- Brama (twój router, np. `192.168.1.1`)

- DNS (np. `1.1.1.1` lub lokalny Pi-hole)

7. Potwierdź i czekaj ~5-10 minut

Krok 5: Pierwsze logowanie

Po restarcie przejdź w przeglądarce na:

```

https://192.168.1.10:8006

```

Zaloguj się jako `root` z hasłem ustawionym podczas instalacji. Przeglądarka ostrzeże o certyfikacie SSL — to normalne, kliknij "Zaawansowane" i kontynuuj.

Krok 6: Wyłączenie subskrypcji Enterprise (opcjonalnie)

Domyślnie Proxmox używa repozytorium Enterprise, które wymaga płatnej subskrypcji. Aby przełączyć się na bezpłatne repozytorium community, uruchom w terminalu (Shell w GUI lub SSH):

```bash

# Wyłącz repozytorium Enterprise

echo "# deb https://enterprise.proxmox.com/debian/pve bookworm pve-enterprise" > /etc/apt/sources.list.d/pve-enterprise.list

# Dodaj repozytorium No-Subscription

echo "deb http://download.proxmox.com/debian/pve bookworm pve-no-subscription" > /etc/apt/sources.list.d/pve-no-subscription.list

# Aktualizuj

apt update && apt dist-upgrade -y

```

---

Pierwsza maszyna wirtualna

Stwórzmy maszynę wirtualną z Ubuntu Server 24.04 LTS. To klasyka — stabilna, szeroko udokumentowana i doskonała do nauki.

Krok 1: Pobierz ISO Ubuntu

W GUI Proxmox przejdź do **local (pve) > ISO Images > Download from URL** i wklej link:

```

https://releases.ubuntu.com/24.04/ubuntu-24.04-live-server-amd64.iso

```

Krok 2: Stwórz VM

Kliknij **"Create VM"** w prawym górnym rogu:

Po utworzeniu uruchom VM i przejdź przez instalator Ubuntu przez konsolę VNC w przeglądarce.

Krok 3: Instalacja QEMU Guest Agent

Po zainstalowaniu Ubuntu, zaloguj się i zainstaluj agenta:

```bash

sudo apt update && sudo apt install -y qemu-guest-agent

sudo systemctl enable --now qemu-guest-agent

```

W Proxmox w ustawieniach VM włącz **QEMU Guest Agent**. Od teraz Proxmox będzie "widział" adres IP maszyny i będzie mógł ją poprawnie zrestartować/wyłączyć.

---

Kontenery LXC

Kontenery LXC to jedno z największych atutów Proxmox. Zamiast uruchamiać cały system operacyjny (jak VM), kontener współdzieli jądro hosta. Efekt? Zużywa kilkanaście MB RAM zamiast kilkuset, startuje w 2 sekundy i jest niemal tak elastyczny jak pełna VM.

Kiedy używać LXC zamiast VM?

Kiedy używać VM?

Tworzenie pierwszego kontenera

Najpierw pobierz szablon systemu. W GUI: **local (pve) > CT Templates > Templates**, wybierz np. `debian-12-standard`.

Przez CLI:

```bash

# Pobierz listę dostępnych szablonów

pveam update

pveam available | grep debian

# Pobierz szablon Debian 12

pveam download local debian-12-standard_12.7-1_amd64.tar.zst

```

Następnie stwórz kontener:

```bash

# Utwórz kontener LXC o ID 200 z Debian 12

pct create 200 local:vztmpl/debian-12-standard_12.7-1_amd64.tar.zst \

--hostname pihole \

--memory 512 \

--cores 1 \

--net0 name=eth0,bridge=vmbr0,ip=192.168.1.20/24,gw=192.168.1.1 \

--storage local-lvm \

--rootfs local-lvm:8 \

--password TwojeHaslo123 \

--unprivileged 1 \

--start 1

```

Zaloguj się do kontenera:

```bash

pct enter 200

```

I już — masz gotowy, działający kontener Debian w kilka sekund.

---

Storage i backup

ZFS — dlaczego warto

ZFS to system plików, który zmienia zasady gry. Oferuje:

Jeśli masz kilka dysków, skonfiguruj ZFS podczas instalacji lub po:

```bash

# Sprawdź dostępne dyski

lsblk

# Utwórz pool ZFS mirror (RAID-1) z dwóch dysków

zpool create -f datapool mirror /dev/sdb /dev/sdc

# Włącz kompresję

zfs set compression=lz4 datapool

# Sprawdź status poola

zpool status

zpool list

```

Proxmox Backup Server (PBS)

PBS to osobna aplikacja (osobna VM lub fizyczny serwer), która oferuje deduplikację i szyfrowanie backupów. Jeśli masz drugi dysk lub NAS — uruchom PBS i podłącz go do Proxmox.

Harmonogram backupów

W GUI Proxmox przejdź do **Datacenter > Backup > Add**:

Backupy działają automatycznie. Możesz je przywrócić jednym kliknięciem lub z CLI:

```bash

# Przywróć VM z backupu (ID 100, do storage local-lvm)

qmrestore /var/lib/vz/dump/vzdump-qemu-100-2026_02_20-02_00_00.vma.zst 100 --storage local-lvm

```

---

Monitoring i zarządzanie

Wbudowany panel Proxmox

Proxmox oferuje podstawowy monitoring w GUI: zużycie CPU, RAM, sieci i dysków dla każdej VM/kontenera. To dobre na start, ale dla głębszej analizy warto sięgnąć po Grafanę.

Grafana + InfluxDB + Proxmox

Proxmox ma natywną integrację z InfluxDB. Skonfiguruj ją w:

Datacenter > Metric Server > Add > InfluxDB

Podaj adres serwera InfluxDB, port (8086), token API i bucket. Dane zaczną spływać automatycznie.

Następnie w Grafanie zaimportuj gotowe dashboardy ze strony [grafana.com/dashboards](https://grafana.com/grafana/dashboards/) — wyszukaj "Proxmox". Dashboard o ID **10048** to sprawdzony klasyk.

Uptime Kuma — monitoring usług

Dla monitorowania dostępności usług (HTTP, ping, TCP) polecam **Uptime Kuma** — prosty, piękny, self-hostowany. Uruchom jako kontener LXC:

```bash

# W kontenerze Debian/Ubuntu

apt update && apt install -y nodejs npm

npx @louislam/uptime-kuma@latest

```

Lub przez Docker w VM:

```bash

docker run -d --restart=always -p 3001:3001 \

-v uptime-kuma:/app/data \

--name uptime-kuma \

louislam/uptime-kuma:1

```

Alerty e-mail

Proxmox może wysyłać alerty e-mail przy awariach. Skonfiguruj SMTP w:

Datacenter > Notifications > Add SMTP

Lub przez CLI:

```bash

# Edytuj konfigurację postfix

nano /etc/postfix/main.cf

# Testuj wysyłanie maila

echo "Test Proxmox alert" | mail -s "Test" twoj@email.com

```

---

Porady dla początkujących

Po latach homelabowania zebrałem kilka rad, które zaoszczędziłyby mi mnóstwo czasu na początku:

1. Zacznij od kontenerów LXC, nie od VM

Nowi użytkownicy instynktownie tworzą VM dla każdej usługi. Błąd. LXC jest lżejsze, szybsze i prostsze w zarządzaniu. VM zostawia na rzeczy, które tego wymagają.

2. Daj VM i kontenerom statyczne IP lub rezerwację DHCP

Dynamiczne IP to koszmar — po restarcie routera adres się zmienia i tracisz połączenie. Skonfiguruj rezerwacje MAC→IP na routerze lub przypisuj statyczne adresy bezpośrednio w kontenerze.

3. Snapshoty przed każdą zmianą

Zanim zaktualizujesz kernel, zainstalujesz nowe oprogramowanie lub zmienisz konfigurację — zrób snapshot. Proxmox robi je w sekundy. Przywrócenie też trwa sekundy. Uratowało mnie to dziesiątki razy.

```bash

# Snapshot VM o ID 100

qm snapshot 100 przed-aktualizacja --description "Przed apt upgrade 2026-02-20"

# Przywróć snapshot

qm rollback 100 przed-aktualizacja

```

4. Nie używaj local-lvm dla wszystkiego

Domyślny storage `local-lvm` jest dobry na dyski VM, ale nie obsługuje snapshots bez ZFS. Jeśli chcesz snapshoty LXC, używaj ZFS storage lub `local` (directory).

5. Aktualizuj regularnie

```bash

apt update && apt dist-upgrade -y

pveam update

```

Proxmox regularnie łata bezpieczeństwo — nie odkładaj aktualizacji na "kiedyś".

6. Używaj silnych haseł i SSH keys

Jeśli wystawiasz Proxmox na zewnątrz (przez VPN lub reverse proxy), koniecznie:

```bash

# Dodaj klucz SSH

mkdir -p ~/.ssh

echo "ssh-ed25519 TWOJ_KLUCZ" >> ~/.ssh/authorized_keys

chmod 600 ~/.ssh/authorized_keys

# Wyłącz logowanie hasłem

sed -i 's/#PasswordAuthentication yes/PasswordAuthentication no/' /etc/ssh/sshd_config

systemctl restart sshd

```

7. Zaplanuj sieć przed startem

Homelab rośnie szybko. Zaplanuj segmentację sieci od początku — np.:

Proxmox obsługuje VLAN i wiele interfejsów sieciowych (Linux bridges) — możesz symulować całą infrastrukturę sieciową na jednej maszynie.

8. Dokumentuj wszystko

Prowadź notes (Obsidian, Notion, nawet plik tekstowy) z:

Za 3 miesiące nie pamiętasz dlaczego dałeś danemu kontenerowi 4 rdzenie zamiast 2. Dokumentacja ratuje.

---

Proxmox VE to jedno z najlepszych narzędzi open-source dla homelabowca. Krzywa uczenia się jest łagodna, dokumentacja świetna, a społeczność gotowa pomóc na forum i Reddicie. Najlepszy sposób na naukę? Zainstaluj, zepsuj, napraw, zapamiętaj. Homelab wybacza błędy — właśnie po to go masz.