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