Jak dodać domenę do cPanel: Kompletny przewodnik techniczny

Dodanie domeny do cPanel oznacza zarejestrowanie dodatkowej nazwy domeny w panelu sterowania hostingiem, aby serwer wiedział, gdzie kierować przychodzące żądania i skąd serwować pliki. W cPanel odbywa się to za pośrednictwem interfejsu Domains lub Addon Domains, który tworzy dedykowany katalog główny dokumentów, konfiguruje wpis wirtualnego hosta i opcjonalnie konfiguruje subdomenę do wewnętrznego zarządzania — wszystko w jednym przepływie pracy.

Ten przewodnik szczegółowo omawia każdy krok tego procesu: od wymagań wstępnych DNS i konfiguracji domeny w cPanel, przez wdrożenie plików za pomocą Menedżera plików, po konfigurację bazy danych MySQL. Dotyczy bezpośrednio każdego środowiska VPS z cPanel, w tym instancji AlexHost VPS działających na LiteSpeed i pamięci masowej NVMe.

Wymagania wstępne przed dodaniem domeny w cPanel

Pominięcie kroku DNS jest najczęstszym powodem, dla którego nowo dodana domena nie jest rozwiązywana. Przed wprowadzeniem zmian w cPanel potwierdź następujące kwestie:

• Propagacja DNS jest w toku lub zakończona. Rekord A Twojej domeny musi wskazywać na publiczny adres IP serwera. Propagacja zazwyczaj trwa od 15 minut do 48 godzin, w zależności od rejestratora i wartości TTL.
• Twoje konto cPanel ma dostępne sloty dla dodatkowych domen. Na VPS z dostępem root i WHM jest to kontrolowane dla każdego konta w sekcji „Modify an Account”. W przypadku planów współdzielonych zależy to od pakietu hostingowego.
• Jesteś właścicielem domeny lub masz nad nią kontrolę. Jeśli zarejestrowałeś ją gdzie indziej, potrzebujesz dostępu do panelu zarządzania DNS rejestratora. Jeśli potrzebujesz nowej domeny, rejestracja domeny przez AlexHost zapewnia scentralizowane zarządzanie DNS.
• SSL jest planowany od samego początku. Prawidłowa kolejność to najpierw dodanie domeny, a następnie żądanie certyfikatu. AutoSSL w cPanel spróbuje automatycznie wystawić certyfikat, gdy tylko domena zostanie rozwiązana na serwerze.

Krok 1: Dodaj domenę w cPanel

Zaloguj się na swoje konto cPanel (zazwyczaj pod adresem yourdomain.com:2083 lub za pośrednictwem linku „Go to cPanel” w WHM).

Nawigacja do interfejsu zarządzania domenami

W nowoczesnym motywie Jupiter cPanel przepływ pracy związany z zarządzaniem domenami został skonsolidowany:

1. Na ekranie głównym cPanel znajdź sekcję Domains.
2. Kliknij Domains (ujednolicony interfejs wprowadzony w cPanel 76+, który zastępuje starsze, oddzielne ikony „Addon Domains”, „Subdomains” i „Aliases”).
3. Kliknij przycisk Create A New Domain w prawym górnym rogu.

Konfigurowanie nowego wpisu domeny

Zobaczysz formularz z następującymi polami:

• Domain: Wprowadź w pełni kwalifikowaną nazwę domeny, na przykład example.com. Nie dołączaj www — cPanel automatycznie obsługuje alias subdomeny www.
• Document Root: cPanel automatycznie wypełnia to pole na podstawie nazwy domeny, zazwyczaj rozwiązując je do /home/username/public_html/example.com. Możesz zmienić tę ścieżkę, ale domyślna jest odpowiednia dla większości wdrożeń.
• Pole wyboru Share document root with main domain: Pozostaw odznaczone, chyba że celowo chcesz, aby ta domena serwowała te same pliki co Twoja główna domena. Zaznaczenie tego pola jest częstym błędem, który powoduje wyświetlanie identycznej treści przez obie domeny.

Kliknij Submit (lub Add Domain w zależności od wersji cPanel). cPanel wykona następujące czynności:

• Utworzy katalog główny dokumentów.
• Zapisze nowy blok konfiguracji wirtualnego hosta Apache lub LiteSpeed.
• Utworzy wpis subdomeny (np. example.com.yourmainaccount.com) dla wewnętrznego routingu.
• Doda domenę do kolejki SSL/TLS, jeśli AutoSSL jest włączony.

Weryfikacja poprawnego dodania domeny

Po przesłaniu formularza wróć do listy Domains. Nowy wpis powinien pojawić się ze ścieżką do katalogu głównego dokumentów i opcją zarządzania DNS. Jeśli używasz wbudowanych serwerów nazw cPanel, kliknij Manage obok domeny, aby sprawdzić strefę DNS i potwierdzić, że rekord A wskazuje na prawidłowy adres IP.

Krok 2: Prześlij pliki witryny za pomocą Menedżera plików

Po skonfigurowaniu domeny serwer jest gotowy do serwowania treści z katalogu głównego dokumentów. Następnym krokiem jest wdrożenie plików witryny.

Dostęp do Menedżera plików

1. Na ekranie głównym cPanel otwórz File Manager w sekcji Files.
2. W drzewie katalogów po lewej stronie przejdź do public_html/, a następnie do folderu nazwanego po Twojej domenie (np. example.com/).
3. Alternatywnie, Menedżer plików domyślnie otwiera się w public_html — możesz nawigować stamtąd.

Przesyłanie plików jako archiwum

Menedżer plików cPanel wymaga, aby pliki były spakowane w formacie archiwum. Przesyłanie pojedynczych plików jeden po drugim jest zarówno powolne, jak i w wielu konfiguracjach serwerów ograniczone ze względów wydajnościowych.

Obsługiwane formaty archiwów do wyodrębnienia:

• .zip
• .tar.gz / .tgz
• .tar.bz2
• .gz

Prawidłowa procedura przesyłania:

1. Skompresuj pliki witryny lokalnie do archiwum .zip. W przypadku instalacji WordPress oznacza to spakowanie całej zawartości katalogu witryny (nie samego folderu, chyba że chcesz uzyskać dodatkowy poziom podkatalogu).
2. W Menedżerze plików przejdź do folderu głównego dokumentów Twojej domeny.
3. Kliknij Upload na górnym pasku narzędzi.
4. Wybierz plik archiwum i poczekaj na zakończenie przesyłania. Menedżer plików wyświetla wskaźnik postępu.
5. Po zakończeniu przesyłania kliknij Go Back to katalogu.
6. Kliknij prawym przyciskiem myszy przesłane archiwum i wybierz Extract. Potwierdź, że ścieżka wyodrębniania to bieżący katalog.
7. Usuń archiwum po wyodrębnieniu, aby zachować porządek w katalogu głównym dokumentów.

Ważny szczegół: Jeśli Twoje archiwum zawiera folder najwyższego poziomu (np. mysite/index.php zamiast index.php w katalogu głównym), Twoja witryna będzie serwowana z example.com/mysite/ zamiast example.com/. Zawsze weryfikuj strukturę katalogów po wyodrębnieniu. W razie potrzeby przenieś pliki o jeden poziom wyżej za pomocą funkcji Move w Menedżerze plików.

Alternatywa: Wdrożenie przez SFTP

W przypadku większych witryn lub zautomatyzowanych wdrożeń SFTP jest znacznie wydajniejszy niż Menedżer plików. Użyj klienta SFTP (FileZilla, WinSCP lub sftp w wierszu poleceń) z następującymi parametrami:

• Host: Adres IP lub nazwa hosta Twojego serwera
• Port: 22 (SSH/SFTP)
• Username: Nazwa użytkownika Twojego konta cPanel
• Authentication: Hasło lub para kluczy SSH

Przejdź bezpośrednio do /home/username/public_html/example.com/ i prześlij pliki. Ta metoda omija wymóg archiwum i obsługuje wznawialne transfery.

Krok 3: Utwórz bazę danych MySQL dla swojej witryny

Większość platform CMS — WordPress, Joomla, Drupal, Magento — wymaga relacyjnej bazy danych. cPanel udostępnia dwa narzędzia do tego celu: MySQL Databases (ręczna, szczegółowa kontrola) i MySQL Database Wizard (prowadzony, krok po kroku). W przypadku prostych konfiguracji Kreator jest szybszy.

Korzystanie z kreatora bazy danych MySQL

1. Na stronie głównej cPanel przejdź do Databases > MySQL Database Wizard.
2. Krok 1 — Utwórz bazę danych: Wprowadź nazwę bazy danych. cPanel automatycznie poprzedza ją nazwą użytkownika konta (np. username_dbname). Zanotuj tę pełną nazwę — będzie potrzebna podczas instalacji CMS.
3. Krok 2 — Utwórz użytkownika bazy danych: Wprowadź nazwę użytkownika i silne hasło. Użyj Password Generator cPanel, aby wygenerować kryptograficznie silne hasło. Pełna nazwa użytkownika również będzie poprzedzona prefiksem (np. username_dbuser).
4. Krok 3 — Dodaj użytkownika do bazy danych: Wybierz właśnie utworzonego użytkownika i przypisz uprawnienia. W przypadku standardowego CMS przyznaj All Privileges. Kliknij Next Step.
5. Kreator potwierdza bazę danych, użytkownika i przypisanie uprawnień. Zapisz wszystkie trzy wartości: nazwę bazy danych, nazwę użytkownika i hasło.

Korzystanie z MySQL Databases (zaawansowane)

W środowiskach wymagających wielu użytkowników z różnymi poziomami uprawnień lub podczas zarządzania kilkoma bazami danych na domenę:

1. Przejdź do Databases > MySQL Databases.
2. Utwórz bazę danych w sekcji Create New Database.
3. Przewiń w dół do Add New User i utwórz użytkownika z silnym hasłem.
4. W sekcji Add User to Database wybierz użytkownika i bazę danych, a następnie zdefiniuj szczegółowe uprawnienia (SELECT, INSERT, UPDATE, DELETE itp.) zamiast ogólnego ALL PRIVILEGES.

Uwaga dotycząca bezpieczeństwa: Nigdy nie używaj tego samego użytkownika bazy danych w wielu witrynach na tym samym koncie. Jeśli jedna witryna zostanie naruszona, izolowane dane uwierzytelniające bazy danych ograniczają możliwość przemieszczania się do innych baz danych.

Wartość hosta bazy danych

Podczas konfigurowania instalatora CMS hostem bazy danych jest prawie zawsze localhost na standardowym VPS z cPanel. Dzieje się tak, ponieważ serwer MySQL działa na tej samej maszynie i nasłuchuje na lokalnym gnieździe. Użycie 127.0.0.1 również działa, ale wymusza TCP zamiast gniazda Unix, dodając niewielkie obciążenie.

Krok 4: Skonfiguruj SSL dla nowej domeny

Domena bez HTTPS będzie oznaczana przez przeglądarki i penalizowana w rankingach wyszukiwania. Funkcja AutoSSL cPanel (obsługiwana przez Let’s Encrypt lub Sectigo w zależności od konfiguracji serwera) automatycznie obsługuje wystawianie certyfikatów, gdy tylko domena zostanie poprawnie rozwiązana.

Weryfikacja pokrycia AutoSSL

1. Przejdź do Security > SSL/TLS Status.
2. Twoja nowa domena powinna pojawić się na liście. Jeśli AutoSSL już działał, wyświetli zieloną kłódkę i datę wygaśnięcia.
3. Jeśli domena jest wyświetlana jako oczekująca lub nieudana, kliknij Run AutoSSL, aby wywołać natychmiastową próbę.

Typowe przyczyny niepowodzenia AutoSSL:

• Rekord A domeny nie wskazuje jeszcze na serwer (DNS nie został propagowany).
• Rekord DNS CAA w domenie ogranicza wystawianie certyfikatów do innego CA.
• Domena jest za proxy (np. Cloudflare orange-cloud), które przechwytuje wyzwanie ACME HTTP-01.

W przypadku domen wymagających rozszerzonej walidacji lub pokrycia wildcard wykraczającego poza możliwości AutoSSL, możesz ręcznie zainstalować zewnętrzny certyfikat SSL za pomocą SSL/TLS Manager cPanel.

Addon Domains vs. subdomeny vs. zaparkowane domeny: kluczowe różnice

Zrozumienie, który typ domeny dodać, zapobiega błędnej konfiguracji i stracie czasu na rozwiązywanie problemów.

Nowoczesny interfejs Domains cPanel konsoliduje je na jednym ekranie, ale podstawowe zachowanie pozostaje odrębne. Gdy dodajesz domenę i pozostawiasz „Share document root” odznaczone, tworzysz to, co historycznie nazywano Addon Domain.

Typowe problemy i sposoby ich rozwiązania

Domena wyświetla „Index of /” (listowanie katalogów)

Oznacza to, że katalog główny dokumentów jest pusty lub nie zawiera pliku index.php / index.html. Twoje pliki nie zostały przesłane lub zostały wyodrębnione do podkatalogu. Sprawdź strukturę plików w Menedżerze plików.

Błąd 500 Internal Server Error po przesłaniu

Zazwyczaj spowodowany nieprawidłowymi uprawnieniami plików lub błędnie sformułowanym plikiem .htaccess. Sprawdź, czy katalogi są ustawione na 755, a pliki na 644. W Menedżerze plików kliknij prawym przyciskiem myszy dowolny plik lub folder i wybierz Change Permissions.

Błąd połączenia z bazą danych podczas instalacji CMS

Sprawdź dokładnie, czy używasz pełnej nazwy bazy danych i nazwy użytkownika z prefiksem (np. username_dbname, a nie tylko dbname). Upewnij się, że hasło nie zawiera znaków specjalnych, które mogą być błędnie interpretowane przez parser konfiguracji CMS — lub umieść wartość w cudzysłowie w pliku konfiguracyjnym.

Domena rozwiązuje się do niewłaściwej witryny

Jeśli dwie domeny na tym samym koncie rozwiązują się do tej samej treści, katalog główny dokumentów został przypadkowo udostępniony podczas konfiguracji. Przejdź do Domains, edytuj wpis i popraw ścieżkę katalogu głównego dokumentów do dedykowanego katalogu.

Skalowanie poza jedno konto cPanel

Gdy przerośniesz jedno konto cPanel — pod względem liczby domen, natężenia ruchu lub wymagań dotyczących izolacji zasobów — opcje architektury się rozchodzą:

• Wiele kont cPanel na jednym VPS przez WHM: Każde konto ma własne limity zasobów, katalogi główne dokumentów i użytkowników bazy danych. Idealne dla agencji zarządzających witrynami klientów.
• Dedykowany serwer z WHM/cPanel: Pełna izolacja sprzętowa, brak efektów hałaśliwego sąsiada i możliwość dostosowania konfiguracji LiteSpeed lub Apache na poziomie serwera. Serwery dedykowane AlexHost obsługują pełny dostęp root do WHM.
• Wiele instancji VPS: Każdy VPS działa w niezależnym środowisku cPanel. Przydatne, gdy witryny mają różne wymagania dotyczące bezpieczeństwa lub zgodności.

W przypadku większości małych i średnich wdrożeń jedno konto VPS Hosting z cPanel hostującym 5–20 domen jest najbardziej opłacalną architekturą. Pamięć masowa NVMe zapewnia, że nawet operacje o wysokim I/O, takie jak zapytania do bazy danych i buforowanie opcode PHP, pozostają szybkie we wszystkich hostowanych domenach.

Lista kontrolna kluczowych wniosków technicznych

Przed uznaniem domeny za w pełni operacyjną w cPanel sprawdź każdy element:

• Rekord A DNS wskazuje na prawidłowy adres IP serwera i został propagowany (zweryfikuj za pomocą dig example.com A lub internetowego narzędzia do sprawdzania DNS).
• Katalog główny dokumentów jest dedykowanym katalogiem, nieudostępnionym z główną domeną.
• Pliki są wyodrębnione na właściwym poziomie katalogu — index.php musi znajdować się bezpośrednio w katalogu głównym dokumentów, a nie w podkatalogu.
• Uprawnienia plików są ustawione na 755 dla katalogów i 644 dla plików.
• Dane uwierzytelniające bazy danych (pełna nazwa z prefiksem, nazwa użytkownika, hasło, host localhost) są zapisane i przetestowane.
• Certyfikat SSL jest aktywny i obejmuje zarówno example.com, jak i www.example.com.
• Odnowienie AutoSSL lub ręcznego certyfikatu jest potwierdzone — certyfikaty Let’s Encrypt wygasają co 90 dni.
• .htaccess zawiera prawidłową regułę przekierowania HTTPS, jeśli chcesz wymuszać SSL.
• Hosting poczty e-mail dla nowej domeny jest skonfigurowany, jeśli jest potrzebny — sekcja Email Accounts w cPanel lub dedykowane rozwiązanie hostingu poczty e-mail, jeśli potrzebujesz zaawansowanych funkcji dostarczalności.

FAQ

Czy dodanie domeny w cPanel automatycznie konfiguruje DNS?

Tylko jeśli Twoja domena używa serwerów nazw cPanel. Jeśli domena jest zarejestrowana gdzie indziej i używa zewnętrznych serwerów nazw, musisz ręcznie dodać rekord A u swojego rejestratora lub dostawcy DNS wskazujący na adres IP Twojego serwera. cPanel tworzy plik strefy wewnętrznie, ale zewnętrzne resolwery nie będą go używać, chyba że domena deleguje do serwerów nazw cPanel.

Ile domen mogę dodać do jednego konta cPanel?

Limit jest ustawiany w WHM w konfiguracji konta. Na VPS z dostępem root możesz ustawić go na nieograniczony. W zarządzanych planach współdzielonych limit zależy od poziomu pakietu. W samym cPanel nie ma twardego technicznego limitu — praktycznym ograniczeniem jest pojemność zasobów serwera.

Jaka jest różnica między kreatorem MySQL Database Wizard a MySQL Databases w cPanel?

Kreator przeprowadza Cię przez tworzenie bazy danych, tworzenie użytkownika i przypisywanie uprawnień w liniowym trzyetapowym przepływie — najlepszy do szybkich konfiguracji. Interfejs MySQL Databases daje szczegółową kontrolę nad wieloma użytkownikami, indywidualnymi przypisaniami uprawnień oraz narzędziami do naprawy i optymalizacji bazy danych. W środowiskach produkcyjnych z wymaganiami bezpieczeństwa używaj interfejsu ręcznego.

Dlaczego moja domena wyświetla domyślną stronę cPanel po dodaniu?

Domyślna strona cPanel (cgi-sys/defaultwebpage.cgi) pojawia się, gdy katalog główny dokumentów jest pusty. Prześlij i wyodrębnij pliki swojej witryny lub umieść plik index.html w katalogu głównym dokumentów, aby natychmiast ją zastąpić.

Czy mogę dodać domenę do cPanel bez dostępu root do serwera?

Tak. Standardowe konta użytkowników cPanel (bez roota) mogą dodawać domeny do limitu ustawionego przez dostawcę hostingu. Dostęp root jest wymagany tylko do zmiany limitów na poziomie konta, instalowania oprogramowania na poziomie całego serwera lub modyfikowania konfiguracji poza katalogiem domowym użytkownika cPanel.