Jan Ulrich Hasecke
2019-11-04 a59e4bcadaf85366dcb3f3e68370881c0e280b8e
commit | author | age
0a126d 1 ===================
JUH 2 Webspace einrichten
3 ===================
b45d72 4
JUH 5 Ihre Webanwendungen – im einfachsten Fall statische HTML-Seiten – richten Sie in dem Heimverzeichnis des jeweiligen :role:`Domain-Admin` ein.
6
7 Loggen Sie sich dazu mit Hilfe von :command:`ssh` ein:
8
9 .. code-block:: console
10
11    $ ssh xyz00-doms@xyz00.hostsharing.net
12
13 Sie erreichen alle Benutzerverzeichnisse über die Adresse des jeweiligen Pakets.
14 In unserem Beispiel ist das :file:`xyz00.hostsharing.net`.
15 Nach dem Einloggen finden Sie die im nächsten Abschnitt beschriebene Ordnerstruktur vor.
16
0a126d 17 Ordnerstruktur
JUH 18 ==============
19
b45d72 20 Die exemplarische Struktur des Home-Verzeichnisses eines :role:`Domain-Admin` sieht folgendermaßen aus::
0a126d 21
JUH 22     ├── doms
a59e4b 23     │   ├── hs-example.de
0a126d 24     │   │   ├── app
JUH 25     │   │   ├── app-ssl
26     │   │   ├── cgi
27     │   │   ├── cgi-ssl
28     │   │   ├── etc
a59e4b 29     │   │   │   └── pri.hs-example.de
0a126d 30     │   │   ├── fastcgi
JUH 31     │   │   │   └── phpstub
32     │   │   ├── fastcgi-ssl
33     │   │   │   └── phpstub
34     │   │   ├── htdocs
35     │   │   │   └── .htaccess
36     │   │   ├── htdocs-ssl
37     │   │   │   └── .htaccess
38     │   │   ├── subs
39     │   │   │   ├── www
40     │   │   │   │   └── index.html
41     │   │   │   └── example
42     │   │   ├── subs-ssl
43     │   │   │   └── www
44     │   │   │       └── index.html
45     │   │   └── var
46     │   └── domain2.tld
47     │       ├── app
48     │       └── …
49     ├── etc
50     │   └── config.ini
51     ├── Maildir
52     ├── procmail.log
53     ├── vacation.cache
54     └── vacation.msg
55
b45d72 56 :file:`~/doms`
JUH 57     Alle dem Domain-Admin zugewiesenen Domains liegen im Verzeichnis :file:`~/doms`.
0a126d 58
a59e4b 59 :file:`~/doms/hs-example.de`
JUH 60     ``hs-example.de`` die Beispiel-Domain, für die die Verzeichnisse von HSAdmin automatisch angelegt wurden.
b45d72 61     
a59e4b 62 :file:`~/doms/hs-example.de/app`
b45d72 63     Dieses Verzeichnis ist als ``PassengerAppRoot`` des Apache-Webserver-Moduls `Phusion Passenger <https://www.phusionpassenger.com/>`_ konfiguriert. 
0a126d 64
a59e4b 65 :file:`~/doms/hs-example.de/app-ssl`
b45d72 66     Auch dieses Verzeichnis ist als ``PassengerAppRoot`` des Apache-Webserver-Moduls konfiguriert.
JUH 67     Es wird für https-Zugriffe genutzt.
68     
a59e4b 69 :file:`~/doms/hs-example.de/cgi`
b45d72 70     Dies ist das Basisverzeichnis für CGI-Skripte.
a59e4b 71     Ein Alias bildet HTTP-Requests auf ``http://hs-example.de/cgi-bin/`` auf dieses Verzeichnisses ab.
b45d72 72     
a59e4b 73 :file:`~/doms/hs-example.de/cgi-ssl`
JUH 74     Analog zu :file:`~/doms/hs-example.de/cgi` ist dies das Basisverzeichnis für CGI-Skripte beim Zugriff via https.
b45d72 75     
a59e4b 76 :file:`~/doms/hs-example.de/etc`
ad994f 77     Dieses Verzeichnis enthält ggf. das Zonefile, mit dem sich der Nameserver `BIND <http://de.wikipedia.org/wiki/BIND>`_ konfigurieren lässt
0a126d 78
a59e4b 79 :file:`~/doms/hs-example.de/etc/pri.hs-example.de`
b45d72 80    Mit dieser Datei können Sie eine Zonendatei für Ihre Domain selbst verwalten. 
JUH 81    Damit können z.B. einzelne Subdomains auf andere Server umgeleitet oder eigene Mailserver angesprochen werden.
0a126d 82
a59e4b 83 :file:`~/doms/hs-example.de/fastcgi`
b45d72 84     Dies ist das Basisverzeichnis für FastCGI-Skripte.
a59e4b 85     Ein Alias bildet HTTP-Requests auf ``http://hs-example.de/fastcgi-bin/`` auf dieses Verzeichnis ab.
b45d72 86     
a59e4b 87 :file:`~/doms/hs-example.de/fastcgi-ssl`
JUH 88    Analog zu :file:`~/doms/hs-example.de/fastcgi` ist dies das Basisverzeichnis für FastCGI-Skripte bei https-Zugriffen.
89    Ein Alias bildet HTTP-Requests auf ``https://hs-example.de/fastcgi-bin/`` auf dieses Verzeichnis ab.
0a126d 90
a59e4b 91 :file:`~/doms/hs-example.de/htdocs`
b45d72 92    Dieses Verzeichnis ist als ``DocumentRoot`` des Apache Webserver konfiguriert. 
ad994f 93    Es dient auch zur Aufnahme statischer Inhalte im Zusammenhang mit der Nutzung von Phusion Passenger zur Auslieferung der statischen Dateien.
0a126d 94
a59e4b 95 :file:`~/doms/hs-example.de/htdocs/.htaccess`
b45d72 96    In der Standardkonfiguration enthält diese Datei die Weiterleitung auf die ``www``-Subdomain::
0a126d 97
a59e4b 98       Redirect permanent / http://www.hs-example.de/
0a126d 99
a59e4b 100    Die verwendeten Regeln werden auf **alle** Subdomains von ``hs-example.de`` angewendet.
b45d72 101    In der ``.htaccess`` können
0a126d 102
b45d72 103    - eigene Fehlerseiten definiert,
JUH 104    - MIME-Typen zugewiesen,
105    - Passwortschutz eingerichtet,
106    - Weiterleitungen durchgeführt werden. 
0a126d 107
a59e4b 108 :file:`~/doms/hs-example.de/htdocs-ssl`
JUH 109    Analog zu :file:`~/doms/hs-example.de/htdocs` ist dieses Verzeichnis als ``DocumentRoot`` des Apache Webserver für Zugriffe via https konfiguriert. 
b45d72 110    
a59e4b 111 :file:`~/doms/hs-example.de/subs`
b45d72 112    Dieses Verzeichnis enthält alle Subdomains.
a59e4b 113    Hier findet sich auch die Subdomain *www.hs-example.de*.
b45d72 114
a59e4b 115 :file:`~/doms/hs-example.de/subs/example`
b45d72 116    Dies ist ein Beispiel für eine Subdomain, die Sie einfach selbst anlegen können. 
ad994f 117    Sie müssen hierzu nur im  Verzeichnis :file:`subs` ein Verzeichnis mit dem Namen der gewünschten Subdomain anlegen und anschließend die Dateien in das Verzeichnis übertragen.
b45d72 118
a59e4b 119 :file:`~/doms/hs-example.de/subs/www`
b45d72 120    Dieses Verzeichnis wird automatisch angelegt und üblicherweise vom Webserver angesprochen, wenn keine Subdomain explizit genannt wird. 
a59e4b 121    Die Adresse ``http://hs-example.de`` verweist üblicherweise auf ``http://www.hs-example.de``.
b45d72 122
a59e4b 123 :file:`~/doms/hs-example.de/subs-ssl`
JUH 124    Analog zu :file:`~/doms/hs-example.de/subs` enthält dieses Verzeichnis alle Subdomains auf die via https zugegriffen wird.
b45d72 125     
a59e4b 126 :file:`~/doms/hs-example.de/var`
b45d72 127    In diesem Verzeichnis werden in der Nacht die Log-Dateien mit den Zugriffen auf die Domain in gepackter Form bereitgestellt, wenn dies in ``/home/pacs/xyz00/etc/config.ini``entsprechend angegeben ist.
0a126d 128
JUH 129 Zugangsdaten und Einstellungen
130 ==============================
131
b45d72 132 Sie können Dateien mit einem FTP-Programm wie :program:`FileZilla`, :program:`WinSCP` oder :command:`scp` in das Web-Paket kopieren.
JUH 133 Sie benötigen dazu die gleichen Zugangsdaten wie beim Einloggen via :command:`ssh`.
0a126d 134
b45d72 135 Server:
JUH 136    xyz00.hostsharing.net
0a126d 137
b45d72 138 Benutzer:
JUH 139    xyz00-doms
0a126d 140
b45d72 141 Passwort:
JUH 142    PASSWORT
0a126d 143
939940 144 .. figure:: ../images/ftp-filezilla.jpg
b45d72 145    :width: 70%
0a126d 146
b45d72 147    Eingabe der Zugangsdaten in Filezilla.
JUH 148
a59e4b 149 Wechseln Sie in den Ordner :file:`~/doms/hs-example.de/subs/www`, um zum Beispiel statische Webseiten hochzuladen.
0a126d 150
939940 151 .. figure:: ../images/ftp-filezilla-www.jpg
b45d72 152    :width: 70%
JUH 153
154    Wechsel in das Verzeichnis ``www``.
0a126d 155
ad994f 156 Auf der Kommandozeile geben Sie folgende Befehle ein:
JUH 157
158 .. code-block:: console
159
160    $ cd ~/website-dateien
a59e4b 161    $ scp -r . xyz00-doms@xyz00.hostsharing.net:/doms/hs-example.de/subs-ssl/www
ad994f 162
a59e4b 163 Die Dateien in dem lokalen Ordner :file:`website-dateien` werden dadurch rekursiv in das Verzeichnis :file:`~/doms/hs-example.de/subs-ssl/www` des Domain-Admin kopiert.