Marc O. Sandlus
2019-11-29 222551b4ee928e230521371b27641cdbbd191e6b
commit | author | age
8d081a 1 .. _kap-modul-domain:
0a126d 2
8d081a 3 ============
JUH 4 Modul domain
5 ============
0a126d 6
8d081a 7 Funktionen
JUH 8 ==========
0a126d 9
8d081a 10 .. option:: domain.search
JUH 11
222551 12    Suche Domain nach den im Befehlsausdruck angegebenen Feldern und Werten
8d081a 13
JUH 14 .. option:: domain.add
15
222551 16    Füge eine neue Domain nach den im Befehlsausdruck angegebenen Feldern und Werten hinzu.
8d081a 17
JUH 18 .. option:: domain.update
19
222551 20    Aktualisiere eine Domain nach den im Befehlsausdruck angegebenen Feldern und Werten.
8d081a 21
JUH 22 .. option:: domain.remove
23
222551 24    Lösche eine Domain nach den im Befehlsausdruck angegebenen Feldern und Werten.
8d081a 25
JUH 26 Editierbare Felder
27 ==================
28
222551 29 Das HSAdmin-Modul ``domain`` kann entsprechend der folgenden Befehlssyntax von :command:`HSAdmin` Felder setzen oder verändern::
8d081a 30
JUH 31    domain.function({where:{field:'value',...}, set:{field:'value',...}})
32
33 Im Modul ``domain`` stehen folgende Felder zur Verfügung.
34
35 name
36    Name einer Domain
37 user
38    Name des Domain-Admins
39 validsubdomainnames
222551 40    leichtgewichtige Subdomains in diesem Virtual-Host des Webservers, gültige Werte: ``*`` für beliebige Subdomains oder eine kommaseparierte Liste: ``www,blog,other``
8d081a 41 greylisting
JUH 42    E-Mails werden verzögert durch den Mailserver angenommen, siehe :term:`Greylisting`. Ist die Option deaktivert, werden E-Mails ohne Verzögerung angenommen.
43 multiviews
44    Der Webserver berücksichtigt Einstellungen im Browser beim Abruf einer Domain (z.B. eine bevorzugte Sprache). Die Option kann mit einer :term:`.htaccess`-Datei für jedes Verzeichnis konfiguriert werden.
45 indexes
46    Der Webserver erzeugt für Verzeichnisse, die keine eigene Index-Datei enthalten, eine Liste mit den im Verzeichnis enthaltenen Dateien. Ist die Option deaktiviert, wird ein Fehler 303 ausgegeben. Die Option kann mit einer .htaccess-Datei für jedes Verzeichnis konfiguriert werden.
47 htdocsfallback
48    Der Webserver leitet auf die Hauptdomain, wenn keine Sub-Domain angelegt ist. Ist die Option deaktivert, wird ein Fehler 404 ausgegeben: Seite nicht gefunden.
49 includes
50    Der Webserver erkennt :term:`SSI`-Komandos und -Dateien. Die Option kann mit einer .htaccess-Datei für jedes Verzeichnis konfiguriert werden.
51 backupmxforexternalmx
52    Der Paket-Hive wird als Weiterleitung (transport) beim Mail-In-Server eingetragen. Ist die Option aktiv, ist der Hostsharing-Mail-In-Server Backup-MX. Der eigentliche Mailserver befindet sich außerhalb der Infrastruktur von Hostsharing (z.B. anderer Provider, DSL-Anschluss mit fester IP)
53 letsencrypt
222551 54    Es wird automatisch ein TLS Zertifikat für diese Domain und alle im Feld „validsubdomainnames“ angegebenen Subdomains erzeugt
8d081a 55
JUH 56 .. note::
57
58         Die Option ``backupmxforexternalmx`` erfordert Änderungen am :doc:`Zonefile<../zonefile/index>` einer Domain.
59
60 Beispiele
61 =========
0a126d 62
JUH 63 .. code-block:: console
64
b4f134 65     xyz00@hsadmin> domain.add ({set:{name:'hs-example.de',user:'xyz00-doms'}})
0a126d 66
8d081a 67 .. todo:: Weitere Beispiele, mindestens noch eins mit where-Kondition