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