Jan Ulrich Hasecke
2019-10-25 b45d7222bd796affbe5586c0ac6b9063b41295db
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
23     │   ├── domain1.tld
24     │   │   ├── app
25     │   │   ├── app-ssl
26     │   │   ├── cgi
27     │   │   ├── cgi-ssl
28     │   │   ├── etc
29     │   │   │   └── pri.domain1.tld
30     │   │   ├── fastcgi
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
b45d72 59 :file:`~/doms/domain1.tld`
JUH 60     ``domain1`` steht für eine beliebige Domain und ``tld`` für eine beliebige Top-Level-Domain wie ``com``, ``net``, ``org`` oder ``de``.
61     
62 :file:`~/doms/domain1.tld/app`
63     Dieses Verzeichnis ist als ``PassengerAppRoot`` des Apache-Webserver-Moduls `Phusion Passenger <https://www.phusionpassenger.com/>`_ konfiguriert. 
0a126d 64
b45d72 65 :file:`~/doms/domain1.tld/app-ssl`
JUH 66     Auch dieses Verzeichnis ist als ``PassengerAppRoot`` des Apache-Webserver-Moduls konfiguriert.
67     Es wird für https-Zugriffe genutzt.
68     
69 :file:`~/doms/domain1.tld/cgi`
70     Dies ist das Basisverzeichnis für CGI-Skripte.
71     Ein Alias bildet HTTP-Requests auf ``/cgi-bin/`` für alle Zugriffe auf den Virtual Host auf dieses Verzeichnisses ab.
72     
73 :file:`~/doms/domain1.tld/cgi-ssl`
74     Analog zu :file:`~/doms/domain1.tld/cgi` ist dies das Basisverzeichnis für CGI-Skripte beim Zugriff via https.
75     
76 :file:`~/doms/domain1.tld/etc`
77     Dieses Verzeichnis enthält ggf. das Zonefile, mit dem sich der Nameserver `BIND
78     <http://de.wikipedia.org/wiki/BIND>`_ konfigurieren lässt
0a126d 79
b45d72 80 :file:`~/doms/domain1.tld/etc/pri.domain1.tld`
JUH 81    Mit dieser Datei können Sie eine Zonendatei für Ihre Domain selbst verwalten. 
82    Damit können z.B. einzelne Subdomains auf andere Server umgeleitet oder eigene Mailserver angesprochen werden.
0a126d 83
b45d72 84 :file:`~/doms/domain1.tld/fastcgi`
JUH 85     Dies ist das Basisverzeichnis für FastCGI-Skripte.
86     Ein Alias bildet HTTP-Requests auf ``/fastcgi-bin/`` für alle Zugriffe auf den Virtual Host auf dieses Verzeichnis ab.
87     
88 :file:`~/doms/domain1.tld/fastcgi-ssl`
89    Analog zu :file:`~/doms/domain1.tld/fastcgi` ist dies das Basisverzeichnis für FastCGI-Skripte bei https-Zugriffen.
90    Ein Alias bildet HTTP-Requests auf ``/fastcgi-bin/`` für alle Zugriffe auf den Virtual Host auf dieses Verzeichnis ab.
0a126d 91
b45d72 92 :file:`~/doms/domain1.tld/htdocs`
JUH 93    Dieses Verzeichnis ist als ``DocumentRoot`` des Apache Webserver konfiguriert. 
0a126d 94
b45d72 95    Es dient auch zur Aufnahme statischer Inhalte im Zusammenhang mit der Nutzung von Phusion Passenger
JUH 96    zur Auslieferung der statischen Dateien.
0a126d 97
b45d72 98 :file:`~/doms/domain1.tld/htdocs/.htaccess`
JUH 99    In der Standardkonfiguration enthält diese Datei die Weiterleitung auf die ``www``-Subdomain::
0a126d 100
b45d72 101       Redirect permanent / http://www.domain1.tld/
0a126d 102
b45d72 103    Die verwendeten Regeln werden auf **alle** Subdomains von ``domain1.tld`` angewendet.
JUH 104    In der ``.htaccess`` können
0a126d 105
b45d72 106    - eigene Fehlerseiten definiert,
JUH 107    - MIME-Typen zugewiesen,
108    - Passwortschutz eingerichtet,
109    - Weiterleitungen durchgeführt werden. 
0a126d 110
b45d72 111 :file:`~/doms/domain1.tld/htdocs-ssl`
JUH 112    Analog zu :file:`~/doms/domain1.tld/htdocs` ist dieses Verzeichnis als ``DocumentRoot`` des Apache Webserver für Zugriffe via https konfiguriert. 
113    
114 :file:`~/doms/domain1.tld/subs`
115    Dieses Verzeichnis enthält alle Subdomains.
116    Hier findet sich auch die Subdomain *www.domain1.tld*.
117
118 :file:`~/doms/domain1.tld/subs/example`
119    Dies ist ein Beispiel für eine Subdomain, die Sie einfach selbst anlegen können. 
120    Sie müssen hierzu nur ein Verzeichnis anlegen und anschließend die Dateien in das Verzeichnis übertragen.
121
122 :file:`~/doms/domain1.tld/subs/www`
123    Dieses Verzeichnis wird automatisch angelegt und üblicherweise vom Webserver angesprochen, wenn keine Subdomain explizit genannt wird. 
124    Die Adresse ``http://domain1.tld`` verweist üblicherweise auf ``http://www.domain1.tld``.
125
126 :file:`~/doms/domain1.tld/subs-ssl`
127    Analog zu :file:`~/doms/domain1.tld/subs` enthält dieses Verzeichnis alle Subdomains auf die via https zugegriffen wird.
128     
129 :file:`~/doms/domain1.tld/var`
130    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 131
JUH 132 Zugangsdaten und Einstellungen
133 ==============================
134
b45d72 135 Sie können Dateien mit einem FTP-Programm wie :program:`FileZilla`, :program:`WinSCP` oder :command:`scp` in das Web-Paket kopieren.
JUH 136 Sie benötigen dazu die gleichen Zugangsdaten wie beim Einloggen via :command:`ssh`.
0a126d 137
b45d72 138 Server:
JUH 139    xyz00.hostsharing.net
0a126d 140
b45d72 141 Benutzer:
JUH 142    xyz00-doms
0a126d 143
b45d72 144 Passwort:
JUH 145    PASSWORT
0a126d 146
JUH 147
939940 148 .. figure:: ../images/ftp-filezilla.jpg
b45d72 149    :width: 70%
0a126d 150
b45d72 151    Eingabe der Zugangsdaten in Filezilla.
JUH 152
153 Wechseln Sie in den Ordner :file:`~/doms/domain1.tld/subs/www`, um zum Beispiel statische Webseiten hochzuladen.
0a126d 154
939940 155 .. figure:: ../images/ftp-filezilla-www.jpg
b45d72 156    :width: 70%
JUH 157
158    Wechsel in das Verzeichnis ``www``.
0a126d 159