So fügen Sie eine Domain zu cPanel hinzu: Vollständiger technischer Leitfaden

Eine Domain zu cPanel hinzuzufügen bedeutet, einen zusätzlichen Domainnamen im Hosting-Kontrollpanel zu registrieren, damit der Server weiß, wohin eingehende Anfragen weitergeleitet werden sollen und von wo Dateien bereitgestellt werden. In cPanel erfolgt dies über die Oberfläche Domains oder Addon Domains, die ein dediziertes Dokumentenstammverzeichnis erstellt, den virtuellen Host-Eintrag konfiguriert und optional eine Subdomain für das interne Management einrichtet – alles in einem einzigen Arbeitsablauf.

Dieser Leitfaden behandelt jeden Schritt dieses Prozesses in technischer Tiefe: von den DNS-Voraussetzungen und der Domain-Konfiguration in cPanel über die Datei-Bereitstellung via File Manager bis hin zur MySQL-Datenbank-Bereitstellung. Er gilt direkt für jede VPS mit cPanel-Umgebung, einschließlich AlexHost VPS-Instanzen mit LiteSpeed und NVMe-Speicher.

Voraussetzungen vor dem Hinzufügen einer Domain in cPanel

Das Überspringen des DNS-Schritts ist der häufigste Grund, warum eine neu hinzugefügte Domain nicht aufgelöst werden kann. Bevor Sie cPanel aufrufen, bestätigen Sie Folgendes:

• Die DNS-Propagierung ist im Gange oder abgeschlossen. Der A-Record Ihrer Domain muss auf die öffentliche IP-Adresse des Servers zeigen. Die Propagierung dauert in der Regel zwischen 15 Minuten und 48 Stunden, abhängig vom Registrar und den TTL-Werten.
• Ihr cPanel-Konto verfügt über verfügbare Addon-Domain-Slots. Auf einem VPS mit Root-Zugang und WHM wird dies pro Konto unter „Modify an Account” gesteuert. Bei Shared-Hosting-Plänen hängt es vom Hosting-Paket ab.
• Sie besitzen oder kontrollieren die Domain. Wenn Sie sie anderswo registriert haben, benötigen Sie Zugang zum DNS-Verwaltungspanel des Registrars. Wenn Sie eine neue Domain benötigen, hält die Domain-Registrierung über AlexHost die DNS-Verwaltung zentralisiert.
• SSL ist von Anfang an geplant. Die Domain zuerst hinzuzufügen und dann ein Zertifikat anzufordern, ist die richtige Reihenfolge. AutoSSL in cPanel versucht die Ausstellung automatisch, sobald die Domain auf den Server aufgelöst wird.

Schritt 1: Die Domain in cPanel hinzufügen

Melden Sie sich bei Ihrem cPanel-Konto an (in der Regel unter yourdomain.com:2083 oder über den Link „Go to cPanel” in WHM).

Navigation zur Domain-Verwaltungsoberfläche

Im modernen Jupiter-Theme von cPanel wurde der Domain-Verwaltungsablauf konsolidiert:

1. Suchen Sie auf dem cPanel-Startbildschirm den Abschnitt Domains.
2. Klicken Sie auf Domains (die einheitliche Oberfläche, die in cPanel 76+ eingeführt wurde und die älteren separaten Symbole „Addon Domains”, „Subdomains” und „Aliases” ersetzt).
3. Klicken Sie auf die Schaltfläche Create A New Domain in der oberen rechten Ecke.

Den neuen Domain-Eintrag konfigurieren

Sie sehen ein Formular mit den folgenden Feldern:

• Domain: Geben Sie den vollständig qualifizierten Domainnamen ein, zum Beispiel example.com. Fügen Sie kein www hinzu – cPanel verwaltet den www-Subdomain-Alias automatisch.
• Document Root: cPanel füllt dieses Feld automatisch basierend auf dem Domainnamen aus, typischerweise mit /home/username/public_html/example.com. Sie können diesen Pfad überschreiben, aber der Standard ist für die meisten Bereitstellungen sinnvoll.
• Kontrollkästchen „Share document root with main domain”: Lassen Sie dieses deaktiviert, es sei denn, Sie möchten absichtlich, dass diese Domain dieselben Dateien wie Ihre primäre Domain bereitstellt. Das Aktivieren ist ein häufiger Fehler, der dazu führt, dass beide Domains identische Inhalte anzeigen.

Klicken Sie auf Submit (oder Add Domain, je nach Ihrer cPanel-Version). cPanel wird:

• Das Dokumentenstammverzeichnis erstellen.
• Einen neuen Apache- oder LiteSpeed-Virtual-Host-Konfigurationsblock schreiben.
• Einen Subdomain-Eintrag erstellen (z. B. example.com.yourmainaccount.com) für das interne Routing.
• Die Domain zur SSL/TLS-Warteschlange hinzufügen, wenn AutoSSL aktiviert ist.

Überprüfen, ob die Domain korrekt hinzugefügt wurde

Kehren Sie nach der Übermittlung zur Domains-Liste zurück. Der neue Eintrag sollte mit seinem Dokumentenstammpfad und einer Option zur DNS-Verwaltung erscheinen. Wenn Sie die integrierten Nameserver von cPanel verwenden, klicken Sie auf Manage neben der Domain, um die DNS-Zone zu überprüfen und zu bestätigen, dass der A-Record auf die richtige IP zeigt.

Schritt 2: Website-Dateien über den File Manager hochladen

Mit der konfigurierten Domain ist der Server bereit, Inhalte aus dem Dokumentenstamm bereitzustellen. Der nächste Schritt ist die Bereitstellung Ihrer Website-Dateien.

Zugriff auf den File Manager

1. Öffnen Sie vom cPanel-Startbildschirm aus den File Manager im Abschnitt Files.
2. Navigieren Sie im linken Verzeichnisbaum zu public_html/ und dann in den Ordner, der nach Ihrer Domain benannt ist (z. B. example.com/).
3. Alternativ öffnet sich der File Manager standardmäßig unter public_html – Sie können von dort aus navigieren.

Dateien als Archiv hochladen

Der File Manager von cPanel erzwingt eine Upload-Methode, bei der Dateien in einem Archivformat verpackt sein müssen. Das einzelne Hochladen von Dateien ist sowohl langsam als auch auf vielen Server-Konfigurationen aus Leistungsgründen eingeschränkt.

Unterstützte Archivformate zur Extraktion:

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

Das korrekte Upload-Verfahren:

1. Komprimieren Sie Ihre Website-Dateien lokal in ein .zip-Archiv. Bei einer WordPress-Installation bedeutet dies, den gesamten Inhalt des Website-Verzeichnisses zu zippen (nicht den Ordner selbst, es sei denn, Sie möchten eine zusätzliche Unterverzeichnisebene).
2. Navigieren Sie im File Manager zum Dokumentenstammordner Ihrer Domain.
3. Klicken Sie in der oberen Symbolleiste auf Upload.
4. Wählen Sie Ihre Archivdatei aus und warten Sie, bis der Upload abgeschlossen ist. Der File Manager zeigt einen Fortschrittsindikator an.
5. Klicken Sie nach Abschluss des Uploads auf Go Back to das Verzeichnis.
6. Klicken Sie mit der rechten Maustaste auf das hochgeladene Archiv und wählen Sie Extract. Bestätigen Sie, dass der Extraktionspfad das aktuelle Verzeichnis ist.
7. Löschen Sie das Archiv nach der Extraktion, um den Dokumentenstamm sauber zu halten.

Wichtiges Detail: Wenn Ihr Archiv einen Ordner der obersten Ebene enthält (z. B. mysite/index.php anstelle von index.php im Stammverzeichnis), wird Ihre Website von example.com/mysite/ statt von example.com/ bereitgestellt. Überprüfen Sie nach der Extraktion immer die Verzeichnisstruktur. Verschieben Sie Dateien bei Bedarf mit der Move-Funktion des File Managers eine Ebene nach oben.

Alternative: Bereitstellung über SFTP

Für größere Websites oder automatisierte Bereitstellungen ist SFTP deutlich effizienter als der File Manager. Verwenden Sie einen SFTP-Client (FileZilla, WinSCP oder sftp in der Befehlszeile) mit den folgenden Parametern:

• Host: Die IP-Adresse oder der Hostname Ihres Servers
• Port: 22 (SSH/SFTP)
• Benutzername: Ihr cPanel-Konto-Benutzername
• Authentifizierung: Passwort oder SSH-Schlüsselpaar

Navigieren Sie direkt zu /home/username/public_html/example.com/ und übertragen Sie Dateien. Diese Methode umgeht die Archivierungsanforderung und unterstützt fortsetzbare Übertragungen.

Schritt 3: Eine MySQL-Datenbank für Ihre Website erstellen

Die meisten CMS-Plattformen – WordPress, Joomla, Drupal, Magento – benötigen eine relationale Datenbank. cPanel bietet hierfür zwei Tools: MySQL Databases (manuell, granulare Kontrolle) und MySQL Database Wizard (geführt, schrittweise). Für unkomplizierte Setups ist der Wizard schneller.

Den MySQL Database Wizard verwenden

1. Navigieren Sie von der cPanel-Startseite zu Databases > MySQL Database Wizard.
2. Schritt 1 – Datenbank erstellen: Geben Sie einen Namen für die Datenbank ein. cPanel stellt Ihren Konto-Benutzernamen automatisch voran (z. B. username_dbname). Notieren Sie sich diesen vollständigen Namen – Sie benötigen ihn bei der CMS-Installation.
3. Schritt 2 – Datenbankbenutzer erstellen: Geben Sie einen Benutzernamen und ein sicheres Passwort ein. Verwenden Sie den Password Generator von cPanel, um ein kryptografisch sicheres Passwort zu erstellen. Der vollständige Benutzername wird ebenfalls mit einem Präfix versehen (z. B. username_dbuser).
4. Schritt 3 – Benutzer zur Datenbank hinzufügen: Wählen Sie den soeben erstellten Benutzer aus und weisen Sie Berechtigungen zu. Für ein Standard-CMS gewähren Sie All Privileges. Klicken Sie auf Next Step.
5. Der Wizard bestätigt die Datenbank, den Benutzer und die Berechtigungszuweisung. Notieren Sie alle drei Werte: Datenbankname, Benutzername und Passwort.

MySQL Databases verwenden (Erweitert)

Für Umgebungen, die mehrere Benutzer mit unterschiedlichen Berechtigungsstufen erfordern, oder bei der Verwaltung mehrerer Datenbanken pro Domain:

1. Gehen Sie zu Databases > MySQL Databases.
2. Erstellen Sie die Datenbank unter Create New Database.
3. Scrollen Sie nach unten zu Add New User und erstellen Sie den Benutzer mit einem sicheren Passwort.
4. Wählen Sie unter Add User to Database den Benutzer und die Datenbank aus und definieren Sie dann granulare Berechtigungen (SELECT, INSERT, UPDATE, DELETE usw.) anstelle von pauschalen ALL PRIVILEGES.

Sicherheitshinweis: Verwenden Sie niemals denselben Datenbankbenutzer für mehrere Websites auf demselben Konto. Wenn eine Website kompromittiert wird, begrenzen isolierte Datenbank-Anmeldeinformationen die laterale Bewegung zu anderen Datenbanken.

Datenbank-Host-Wert

Bei der Konfiguration Ihres CMS-Installers ist der Datenbank-Host auf einem Standard-cPanel-VPS fast immer localhost. Dies liegt daran, dass der MySQL-Server auf derselben Maschine läuft und auf dem lokalen Socket lauscht. Die Verwendung von 127.0.0.1 funktioniert ebenfalls, erzwingt jedoch TCP anstelle des Unix-Sockets und fügt einen geringen Overhead hinzu.

Schritt 4: SSL für die neue Domain konfigurieren

Eine Domain ohne HTTPS wird von Browsern markiert und in den Suchrankings abgestraft. Die AutoSSL-Funktion von cPanel (betrieben von Let’s Encrypt oder Sectigo, je nach Serverkonfiguration) übernimmt die Zertifikatsausstellung automatisch, sobald die Domain korrekt aufgelöst wird.

AutoSSL-Abdeckung überprüfen

1. Navigieren Sie zu Security > SSL/TLS Status.
2. Ihre neue Domain sollte in der Liste erscheinen. Wenn AutoSSL bereits ausgeführt wurde, wird ein grünes Schloss und ein Ablaufdatum angezeigt.
3. Wenn die Domain als ausstehend oder fehlgeschlagen angezeigt wird, klicken Sie auf Run AutoSSL, um einen sofortigen Versuch auszulösen.

Häufige AutoSSL-Fehlerursachen:

• Der A-Record der Domain zeigt noch nicht auf den Server (DNS nicht propagiert).
• Ein CAA-DNS-Record auf der Domain schränkt die Ausstellung auf eine andere CA ein.
• Die Domain befindet sich hinter einem Proxy (z. B. Cloudflare Orange-Cloud), der die ACME HTTP-01-Challenge abfängt.

Für Domains, die eine erweiterte Validierung oder Wildcard-Abdeckung über das hinaus benötigen, was AutoSSL bietet, können Sie ein Drittanbieter-SSL-Zertifikat manuell über den SSL/TLS Manager von cPanel installieren.

Addon Domains vs. Subdomains vs. Parked Domains: Wesentliche Unterschiede

Das Verständnis, welcher Domain-Typ hinzugefügt werden soll, verhindert Fehlkonfigurationen und verschwendete Fehlerbehebungszeit.

Die moderne cPanel-Domains-Oberfläche konsolidiert diese in einem Bildschirm, aber das zugrunde liegende Verhalten bleibt unterschiedlich. Wenn Sie eine Domain hinzufügen und „Share document root” deaktiviert lassen, erstellen Sie das, was historisch als Addon Domain bezeichnet wurde.

Häufige Probleme und deren Lösung

Domain zeigt „Index of /” (Verzeichnislisting)

Das bedeutet, dass der Dokumentenstamm leer ist oder keine index.php / index.html-Datei enthält. Entweder wurden Ihre Dateien nicht hochgeladen oder sie wurden in ein Unterverzeichnis extrahiert. Überprüfen Sie die Dateistruktur im File Manager.

500 Internal Server Error nach dem Upload

Wird in der Regel durch falsche Dateiberechtigungen oder eine fehlerhafte .htaccess-Datei verursacht. Stellen Sie sicher, dass Verzeichnisse auf 755 und Dateien auf 644 gesetzt sind. Klicken Sie im File Manager mit der rechten Maustaste auf eine Datei oder einen Ordner und wählen Sie Change Permissions.

Datenbankverbindungsfehler während der CMS-Installation

Überprüfen Sie, ob Sie den vollständigen Datenbanknamen und Benutzernamen mit Präfix verwenden (z. B. username_dbname, nicht nur dbname). Bestätigen Sie, dass das Passwort keine Sonderzeichen enthält, die vom CMS-Konfigurations-Parser falsch interpretiert werden könnten – oder schließen Sie den Wert in der Konfigurationsdatei in Anführungszeichen ein.

Domain wird zur falschen Website aufgelöst

Wenn zwei Domains auf demselben Konto denselben Inhalt anzeigen, wurde der Dokumentenstamm während der Einrichtung versehentlich geteilt. Gehen Sie zu Domains, bearbeiten Sie den Eintrag und korrigieren Sie den Dokumentenstammpfad zum dedizierten Verzeichnis.

Skalierung über ein einzelnes cPanel-Konto hinaus

Wenn Sie ein einzelnes cPanel-Konto überwachsen – sei es in Bezug auf die Anzahl der Domains, das Traffic-Volumen oder die Anforderungen an die Ressourcenisolierung – divergieren die Architekturoptionen:

• Mehrere cPanel-Konten auf einem VPS über WHM: Jedes Konto hat eigene Ressourcenlimits, Dokumentenstämme und Datenbankbenutzer. Ideal für Agenturen, die Kundenwebsites verwalten.
• Dedizierter Server mit WHM/cPanel: Vollständige Hardware-Isolierung, keine Noisy-Neighbor-Effekte und die Möglichkeit, die LiteSpeed- oder Apache-Konfiguration auf Serverebene anzupassen. AlexHost dedizierte Server unterstützen vollen WHM-Root-Zugang.
• Mehrere VPS-Instanzen: Jeder VPS betreibt eine unabhängige cPanel-Umgebung. Nützlich, wenn Websites unterschiedliche Sicherheits- oder Compliance-Anforderungen haben.

Für die meisten kleinen bis mittleren Bereitstellungen ist ein einzelnes VPS Hosting-Konto mit cPanel, das 5–20 Domains hostet, die kosteneffizienteste Architektur. NVMe-Speicher stellt sicher, dass selbst I/O-intensive Operationen wie Datenbankabfragen und PHP-Opcode-Caching für alle gehosteten Domains schnell bleiben.

Technische Checkliste der wichtigsten Erkenntnisse

Bevor Sie eine Domain in cPanel als vollständig betriebsbereit betrachten, überprüfen Sie jeden Punkt:

• DNS A-Record zeigt auf die korrekte Server-IP und wurde propagiert (überprüfen Sie mit dig example.com A oder einem Online-DNS-Checker).
• Document Root ist ein dediziertes Verzeichnis, das nicht mit der Hauptdomain geteilt wird.
• Dateien werden extrahiert auf der richtigen Verzeichnisebene – index.php muss sich direkt im Dokumentenstamm befinden, nicht in einem Unterverzeichnis.
• Dateiberechtigungen sind auf 755 für Verzeichnisse und 644 für Dateien gesetzt.
• Datenbank-Anmeldeinformationen (vollständiger Name mit Präfix, Benutzername, Passwort, Host localhost) sind notiert und getestet.
• SSL-Zertifikat ist aktiv und deckt sowohl example.com als auch www.example.com ab.
• AutoSSL oder manuelle Zertifikat-Erneuerung ist bestätigt – Let’s Encrypt-Zertifikate laufen alle 90 Tage ab.
• .htaccess enthält eine gültige HTTPS-Weiterleitungsregel, wenn Sie SSL erzwingen möchten.
• E-Mail-Hosting für die neue Domain ist bei Bedarf konfiguriert – der Abschnitt E-Mail-Konten in cPanel oder eine dedizierte E-Mail-Hosting-Lösung, wenn Sie erweiterte Zustellbarkeitsfunktionen benötigen.

FAQ

Konfiguriert das Hinzufügen einer Domain in cPanel automatisch DNS?

Nur wenn Ihre Domain die Nameserver von cPanel verwendet. Wenn die Domain anderswo registriert ist und externe Nameserver verwendet, müssen Sie den A-Record manuell bei Ihrem Registrar oder DNS-Anbieter hinzufügen, der auf die IP Ihres Servers zeigt. cPanel erstellt die Zonendatei intern, aber externe Resolver werden sie nicht verwenden, es sei denn, die Domain delegiert an die Nameserver von cPanel.

Wie viele Domains kann ich einem einzelnen cPanel-Konto hinzufügen?

Das Limit wird in WHM unter der Kontokonfiguration festgelegt. Auf einem VPS mit Root-Zugang können Sie dies auf unbegrenzt setzen. Bei verwalteten Shared-Hosting-Plänen hängt das Limit von der Paketstufe ab. Es gibt keine feste technische Obergrenze in cPanel selbst – die praktische Grenze ist die Serverressourcenkapazität.

Was ist der Unterschied zwischen dem MySQL Database Wizard und MySQL Databases in cPanel?

Der Wizard führt Sie durch die Datenbankerstellung, Benutzererstellung und Berechtigungszuweisung in einem linearen Drei-Schritt-Ablauf – am besten für schnelle Setups geeignet. Die MySQL Databases-Oberfläche gibt Ihnen granulare Kontrolle über mehrere Benutzer, individuelle Berechtigungszuweisungen und Datenbank-Reparatur-/Optimierungstools. Für Produktionsumgebungen mit Sicherheitsanforderungen verwenden Sie die manuelle Oberfläche.

Warum zeigt meine Domain nach dem Hinzufügen eine cPanel-Standardseite?

Die cPanel-Standardseite (cgi-sys/defaultwebpage.cgi) erscheint, wenn der Dokumentenstamm leer ist. Laden Sie Ihre Website-Dateien hoch und extrahieren Sie sie, oder platzieren Sie eine index.html-Datei im Dokumentenstamm, um sie sofort zu ersetzen.

Kann ich eine Domain zu cPanel hinzufügen, ohne Root-Zugang zum Server zu haben?

Ja. Standard-cPanel-Benutzerkonten (ohne Root) können Domains bis zu dem vom Hosting-Anbieter festgelegten Limit hinzufügen. Root-Zugang ist nur erforderlich, um Limits auf Kontoebene zu ändern, serverweite Software zu installieren oder Konfigurationen außerhalb des Home-Verzeichnisses des cPanel-Benutzers zu ändern.