Instalacja CloudPanel na VPS z Linuksem (Ubuntu/Debian)

CloudPanel to darmowy, lekki panel sterowania, który zarządza Nginx, PHP-FPM, bazami danych i certyfikatami SSL z poziomu przeglądarki. Zainstalowany na VPS Linux Infrawire zamienia pusty serwer w platformę hostingową dla wielu stron w kilka minut. Poradnik dotyczy Ubuntu 24.04 i Debiana 12.

📋 Wymagania

Nowy VPS KVM z Ubuntu 24.04 lub Debianem 12, bez niczego więcej (bez Apache, Nginx, MySQL ani innego panelu).
Co najmniej 2 GB RAM i dostęp SSH jako root. W panelu klienta znajdziesz adres IP i hasło roota VPS.
Domena, której rekord DNS A (oraz AAAA, jeśli używasz IPv6) wskazuje na VPS_IP.
Porty 22, 80, 443 i 8443 dostępne z Internetu.

🔄 1. Przygotowanie systemu

Zaloguj się jako root i zaktualizuj pakiety. CloudPanel wymaga curl, wget i sudo.

Bash
1ssh root@VPS_IP
2apt update && apt -y upgrade && apt -y install curl wget sudo

Jeśli zaktualizowano jądro, uruchom ponownie system poleceniem reboot i połącz się ponownie, zanim przejdziesz dalej.

⬇️ 2. Uruchomienie oficjalnego instalatora

Instalator jest najpierw pobierany, a jego suma kontrolna SHA-256 jest sprawdzana przed uruchomieniem. Suma zmienia się wraz z każdą wersją instalatora: skopiuj aktualną wartość i aktualną listę silników baz danych ze strony oficjalnej https://www.cloudpanel.io/docs/v2/getting-started/other/ (zastąp poniżej SHA256_FROM_DOCS).

Bash
1curl -sS https://installer.cloudpanel.io/ce/v2/install.sh -o install.sh
2echo "SHA256_FROM_DOCS install.sh" | sha256sum -c
3sudo CLOUD_PANEL_DB_ENGINE=MARIADB_11.4 bash install.sh

Zmienna CLOUD_PANEL_DB_ENGINE wybiera serwer bazy danych. Udokumentowane wartości to MYSQL_8.4, MYSQL_8.0, MARIADB_11.4 i MARIADB_10.11. Bez niej instalator użyje wartości domyślnej. Polecenie sha256sum -c musi wypisać install.sh: OK; jeśli widzisz FAILED, przerwij i pobierz plik ponownie. Instalacja trwa kilka minut.

🔑 3. Utworzenie pierwszego konta administratora

Otwórz w przeglądarce https://VPS_IP:8443. Certyfikat jest samopodpisany, więc przeglądarka wyświetli ostrzeżenie: zaakceptuj je przy pierwszym logowaniu.

Administratora tworzy pierwszy odwiedzający, więc zrób to od razu. Podaj nazwę użytkownika, adres e-mail i długie hasło, a następnie zaloguj się. Nie zostawiaj panelu dostępnego przez wiele godzin przed utworzeniem konta.

🌐 4. Dodanie strony PHP

W panelu kliknij Sites, potem Add Site i Create a PHP Site. Wybierz szablon aplikacji (Generic, WordPress, Laravel itd.), wpisz example.com jako domenę, wybierz wersję PHP i ustaw użytkownika oraz hasło strony. CloudPanel utworzy vhost Nginx, pulę PHP-FPM i dedykowanego użytkownika systemowego dla strony.

Wyślij pliki przez SFTP jako użytkownik strony (nie root) do /home/USER/htdocs/example.com. W sekcji Databases możesz też utworzyć bazę danych dla strony.

🔒 5. Wystawienie certyfikatu Let's Encrypt

Sprawdź, czy example.com już wskazuje na VPS_IP:

Bash
1dig +short example.com

Następnie otwórz stronę, przejdź do zakładki SSL/TLS, kliknij Actions i wybierz New Let's Encrypt Certificate. Zaznacz nazwy domen do uwzględnienia i potwierdź. Odnawianiem automatycznie zajmuje się CloudPanel.

🛡️ 6. Zabezpieczenie panelu

W Admin Area > Security > Firewall ogranicz port 8443 do własnego adresu IP i usuń regułę zezwalającą na dostęp z dowolnego miejsca. Porty 22, 80 i 443 zostaw otwarte według potrzeb.
W Admin Area > Security włącz Basic Auth dla panelu jako drugą barierę.
W profilu użytkownika włącz uwierzytelnianie dwuskładnikowe.
Używaj długiego, unikalnego hasła i aktualizuj system:

Bash
1apt update && apt -y upgrade

✅ 7. Weryfikacja instalacji

Bash
1ss -tlnp | grep -E ':(80|443|8443)\b'
2systemctl is-active nginx clp-agent
3curl -I https://example.com

Porty 80, 443 i 8443 powinny nasłuchiwać, obie usługi powinny odpowiedzieć active, a ostatnie polecenie powinno zwrócić HTTP 200 lub przekierowanie z prawidłowym certyfikatem.

🧰 Rozwiązywanie problemów

Instalator nie startuje lub kończy się błędem w trakcie: CloudPanel trzeba instalować na czystym systemie. Jeśli był już inny serwer WWW lub baza danych, zainstaluj system ponownie z panelu klienta i zacznij od nowa.
Port 8443 nie odpowiada: sprawdź, czy zapora (reguły panelu i każda inna zapora) go przepuszcza oraz czy Twój IP nie został usunięty z listy dozwolonych. Uruchom na serwerze ss -tlnp | grep 8443.
Let's Encrypt kończy się błędem: domena jeszcze nie wskazuje na VPS albo proxy ukrywa prawdziwy IP. Popraw rekord DNS, poczekaj na propagację i spróbuj ponownie. Port 80 musi być otwarty.
Utracone hasło admina: zresetuj je z powłoki poleceniem clpctl user:reset:password --userName='admin' --password='NEW_PASSWORD'.

🎉 CloudPanel działa: dodawaj strony, zabezpiecz port 8443 i korzystaj z czystego środowiska hostingowego na swoim VPS.