docs/hs.docs.users.git - Hostsharing Git Server

Jan Ulrich Hasecke

2019-10-25 ad994f6adba7feb936620e6fad80fa8d66a5cbd5

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.
ad994f	71	Ein Alias bildet HTTP-Requests auf ``http://domain1.tld/cgi-bin/`` auf dieses Verzeichnisses ab.
b45d72	72
JUH	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`
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
b45d72	79	:file:`~/doms/domain1.tld/etc/pri.domain1.tld`
JUH	80	Mit dieser Datei können Sie eine Zonendatei für Ihre Domain selbst verwalten.
	81	Damit können z.B. einzelne Subdomains auf andere Server umgeleitet oder eigene Mailserver angesprochen werden.
0a126d	82
b45d72	83	:file:`~/doms/domain1.tld/fastcgi`
JUH	84	Dies ist das Basisverzeichnis für FastCGI-Skripte.
ad994f	85	Ein Alias bildet HTTP-Requests auf ``http://domain1.tld/fastcgi-bin/`` auf dieses Verzeichnis ab.
b45d72	86
JUH	87	:file:`~/doms/domain1.tld/fastcgi-ssl`
	88	Analog zu :file:`~/doms/domain1.tld/fastcgi` ist dies das Basisverzeichnis für FastCGI-Skripte bei https-Zugriffen.
ad994f	89	Ein Alias bildet HTTP-Requests auf ``https://domain1.tld/fastcgi-bin/`` auf dieses Verzeichnis ab.
0a126d	90
b45d72	91	:file:`~/doms/domain1.tld/htdocs`
JUH	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
b45d72	95	:file:`~/doms/domain1.tld/htdocs/.htaccess`
JUH	96	In der Standardkonfiguration enthält diese Datei die Weiterleitung auf die ``www``-Subdomain::
0a126d	97
b45d72	98	Redirect permanent / http://www.domain1.tld/
0a126d	99
b45d72	100	Die verwendeten Regeln werden auf alle Subdomains von ``domain1.tld`` angewendet.
JUH	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
b45d72	108	:file:`~/doms/domain1.tld/htdocs-ssl`
JUH	109	Analog zu :file:`~/doms/domain1.tld/htdocs` ist dieses Verzeichnis als ``DocumentRoot`` des Apache Webserver für Zugriffe via https konfiguriert.
	110
	111	:file:`~/doms/domain1.tld/subs`
	112	Dieses Verzeichnis enthält alle Subdomains.
	113	Hier findet sich auch die Subdomain www.domain1.tld.
	114
	115	:file:`~/doms/domain1.tld/subs/example`
	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
JUH	119	:file:`~/doms/domain1.tld/subs/www`
	120	Dieses Verzeichnis wird automatisch angelegt und üblicherweise vom Webserver angesprochen, wenn keine Subdomain explizit genannt wird.
	121	Die Adresse ``http://domain1.tld`` verweist üblicherweise auf ``http://www.domain1.tld``.
	122
	123	:file:`~/doms/domain1.tld/subs-ssl`
	124	Analog zu :file:`~/doms/domain1.tld/subs` enthält dieses Verzeichnis alle Subdomains auf die via https zugegriffen wird.
	125
	126	:file:`~/doms/domain1.tld/var`
	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
	149	Wechseln Sie in den Ordner :file:`~/doms/domain1.tld/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
	161	$ scp -r . xyz00-doms@xyz00.hostsharing.net:/doms/domain1.tld/subs-ssl/www
	162
	163	Die Dateien in dem lokalen Ordner :file:`website-dateien` werden dadurch rekursiv in das Verzeichnis :file:`~/doms/domain1.tld/subs-ssl/www` des Domain-Admin kopiert.