Subdomain oder Weiterleitung anlegen
add_domainLegt für das Hostingpaket (hauptdomain = die Domain des Pakets) eine Subdomain oder eine Weiterleitung von einer Domain bei einem anderen Anbieter an. Drei Arten (art): "alias" = Weiterleitung einer Domain, die der Kunde bei einem ANDEREN Anbieter registriert hat (z. B. IONOS oder Strato): sie leitet dauerhaft (301) auf die Hauptdomain des Pakets weiter; das SSL-Zertifikat wird nach dem Anlegen ausgestellt, sobald alle autoritativen Nameserver der jeweiligen Domain den Namen liefern (bei einer Subdomain die der Hauptdomain, bei einem Alias die der Domain selbst, nicht die des Pakets). Meldet die Antwort zertifikat_folgt (oder nicht ausdrücklich, dass das Zertifikat ausgestellt ist), ist es noch nicht da: es wird automatisch nachgeholt (Wiederholung alle paar Minuten bis 48 Stunden nach dem Anlegen), und aktion "pruefen" auf den angelegten Namen stellt auch ein noch offenes Zertifikat aus (im Panel: Knopf "Zertifikat ausstellen"; das gilt auch für Subdomains). Die Weiterleitung wird erst aktiviert, wenn die A-/AAAA-Einträge für @ und www auf den Server des Pakets zeigen: bis dahin ist der Zustand "wartet_dns", und die Antwort nennt die Einträge, die der Kunde beim DNS-Anbieter setzen muss (und AAAA-Einträge, die er entfernen muss). Es gibt keinen Hintergrundjob für wartende Domains: Hat der Kunde das DNS geändert, muss mit aktion "pruefen" erneut aufgerufen werden, erst dann wird die Weiterleitung angelegt und das Zertifikat ausgestellt. Wartende Domains verfallen nach 30 Tagen (der Eintrag wird entfernt, die Domain lässt sich danach neu hinzufügen); "pruefen" verlängert die Frist nicht. Zeigt die neue Domain richtig, ein anderer Alias des Pakets aber nicht, nennt die Antwort diesen Alias: der Zustand bleibt "wartet_dns", bis der Kunde ihn in Ordnung bringt oder entfernt. "sub_website" = Subdomain mit eigener Website: ihre Dateien liegen im Ordner neben httpdocs (der Ordner heißt immer wie die Subdomain und lässt sich nicht frei wählen); bis zum Hochladen steht dort eine Platzhalterseite, der Zugriff läuft über FTP/SFTP/SSH des Hauptzugangs. Nur wenn die App einen eigenen Ordner ausliefert (z. B. public bei Laravel/Symfony oder dist bei Vite), gibt es den optionalen Parameter unterordner (relativ unter , z. B. public); aktion "pfad" ändert ihn später (der alte Ordner bleibt bestehen). Das Zertifikat der Subdomain folgt automatisch, sobald sie überall im DNS angekommen ist (meist innerhalb von 15 Minuten). "sub_weiterleitung" = Subdomain, die per 301 auf eine URL (ziel) weiterleitet. Domains, die dem Kunden bei turbopress gehören, legt dieses Werkzeug nicht an: für sie gibt es im Panel unter "Weiterleitungen" → "Weiterleitung anlegen" den Weg "Eine deiner turbopress-Domains" (im Chat: redirect_domain; Domains ohne eigenes Paket werden dabei dem Paket zugeordnet); die Hauptdomain eines anderen Pakets desselben Kunden wird mit dz_eigenes_paket abgelehnt; Domains anderer werden abgelehnt. Im Panel-Chat braucht jeder Aufruf den Bestätigungsklick des Kunden (dann wurde noch nichts ausgeführt). Höchstens 10 Hinzufügungen pro Tag. Die Antwort (Zustand, DNS-Einträge, Zugang) wörtlich weitergeben; nur dann Erfolg melden, wenn sie ihn meldet. Entfernen: remove_added_domain.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| art | No | Pflicht bei hinzufuegen: alias (Weiterleitung einer Domain von einem anderen Anbieter, 301 auf die Hauptdomain), sub_website (Subdomain mit eigener Website) oder sub_weiterleitung (Subdomain, 301 auf eine URL) | |
| pfad | No | Veraltet, nur noch Alt-Name für unterordner: gilt nur mit der Vorsilbe <fqdn>/ (z. B. shop.example.de/public wird zu unterordner public); jeden anderen Ordnerpfad gibt es nicht mehr. Besser unterordner verwenden | |
| ziel | No | Pflicht bei sub_weiterleitung: die URL, auf die per 301 weitergeleitet wird | |
| label | No | Bei Subdomains: nur der Teil vor der Hauptdomain, z. B. "shop" für shop.example.de | |
| aktion | No | Standard hinzufuegen. pruefen = DNS einer wartenden Alias-Domain erneut prüfen und/oder ein offenes Zertifikat einer angelegten Domain oder Subdomain nachholen (domain angeben, bei einer Subdomain der volle Name); pfad = Unterordner einer sub_website ändern (domain = vollständiger Name der Subdomain + unterordner, leer = der Ordner der Subdomain selbst) | |
| domain | No | Bei alias und pruefen: die weiterzuleitende Domain bei einem anderen Anbieter, z. B. andere.de (bei pruefen auch der volle Name einer hinzugefügten Subdomain). Bei aktion pfad: der vollständige Name der Subdomain, z. B. shop.example.de | |
| hauptdomain | Yes | Die Domain des Hostingpakets, z. B. example.de | |
| unterordner | No | Optional bei sub_website, nur wenn die App einen eigenen Ordner ausliefert: öffentlicher Unterordner relativ unter dem Ordner <fqdn> der Subdomain, z. B. public oder dist (leer = der Ordner <fqdn> selbst). Pflichtangabe bei aktion pfad (leer erlaubt) |