Automatische Subdomains in ISPmanager

ISPmanager kann automatisch Subdomains für eine bestehende Domain erstellen — ohne manuelle Änderungen an der Konfiguration. Eine Subdomain wird in dem Moment aktiv, in dem Sie das entsprechende Verzeichnis an der richtigen Stelle anlegen.

Auto-Subdomains aktivieren

Gehen Sie zu WWW-Domains, öffnen Sie die Eigenschaften der gewünschten Domain und wählen Sie unter Auto-Subdomains den gewünschten Modus aus.

Modus: „Separates Verzeichnis"

Jede Subdomain erhält einen eigenen, vollständig unabhängigen Ordner — die Dateien der Hauptdomain bleiben davon unberührt.

Beispiel:

• Hauptdomain example.com liegt in www/example.com
• Sie möchten domain.example.com erstellen

Legen Sie die Dateien der Subdomain hier ab:

www/domain.example.com

Modus: „Unterverzeichnis der WWW-Domain"

Die Dateien der Subdomain befinden sich im Ordner der Hauptdomain und sind dadurch sowohl über die Subdomain-URL als auch über einen Pfad der Hauptdomain erreichbar.

Beispiel:

• Hauptdomain example.com liegt in www/example.com
• Sie möchten domain.example.com erstellen

Legen Sie die Dateien der Subdomain hier ab:

www/example.com/domain

Dieselben Dateien sind dann auch unter example.com/domain erreichbar.

Technische Hintergründe

Auto-Subdomains basieren auf dem Apache-Modul mod_vhost_alias, das in der ISPmanager-Konfiguration aktiviert sein muss. Zusätzlich steht die Option ForceAutoSubdomain in der Konfigurationsdatei des Panels zur Verfügung.

Wenn Sie Auto-Subdomains aktivieren, nimmt ISPmanager automatisch folgende Änderungen vor:

• Für den Modus „Separates Verzeichnis" wird diese Direktive zur Virtual-Host-Konfiguration hinzugefügt:

VirtualDocumentRoot /home/username/data/www/%0

• Für den Modus „Unterverzeichnis der WWW-Domain":

VirtualDocumentRoot /home/username/data/www/example.com/%1

• Der Direktive ServerAlias wird ein Wildcard-Eintrag *.example.com hinzugefügt
• Für die Domain wird ein DNS-A-Record mit Wildcard * angelegt, der auf ihre IP-Adresse zeigt

Fehlerbehebung & FAQ

Wo genau lege ich die Dateien der Subdomain ab?

Das hängt vom gewählten Modus ab:

• „Separates Verzeichnis" → www/vollständiger.subdomain-name
• „Unterverzeichnis der WWW-Domain" → www/domain-name/subdomain-name

Ich habe Auto-Subdomains aktiviert, aber die Domain löst nicht auf

Die DNS-Propagation benötigt Zeit — in manchen Fällen bis zu 24–48 Stunden. Überprüfen Sie außerdem, ob Ihre Domain an dieselben Nameserver delegiert ist, die ISPmanager verwendet.

Nach der Aktivierung von Auto-Subdomains liefern andere Subdomains 404-Fehler

Beim Aktivieren von Auto-Subdomains wird der Apache-Konfiguration ein Wildcard-Eintrag *.example.com hinzugefügt, wodurch alle Anfragen über diese Domain geroutet werden. Um das zu beheben, tragen Sie im Feld Aliase explizit nur die Subdomains ein, die Sie tatsächlich benötigen.

DNS-Einträge, die auf andere IP-Adressen zeigen, funktionieren nicht mehr

Ein Wildcard-Eintrag * in den DNS-Einstellungen hat Vorrang vor spezifischeren Einträgen. Sie können entweder Auto-Subdomains deaktivieren oder alle benötigten A-Records manuell in den DNS-Einstellungen eintragen.

www-Subdomains funktionieren nicht (z. B. www.example.com oder www.domain.example.com)

Für www-Varianten müssen symbolische Links (Symlinks) manuell eingerichtet werden.

Für den Modus „Separates Verzeichnis" erstellen Sie die Symlinks im Verzeichnis www:

lrwxr-xr-x  www.example.com -> example.com
lrwxr-xr-x  www.domain.example.com -> domain.example.com

Für den Modus „Unterverzeichnis der WWW-Domain" erstellen Sie die Symlinks im eigenen Verzeichnis der Domain:

lrwxr-xr-x  www -> .
lrwxr-xr-x  www.domain -> domain

Erstellen Sie die Symlinks mit dem Befehl ln -s:

ln -s domain www.domain
ln -s . www