Zweite Web-Anwendung neben ownCloud/Nextcloud einrichten (am Beispiel WordPress)
Der Artikel über ownCloud auf nginx, MariaDB und PHP hat mittlerweile sehr viel Zuspruch gefunden. Hier wurde die Konfiguration des Webservers darauf ausgelegt, dass der Administrator neben ownCloud bzw. Nextcloud auch noch andere Web-Anwendungen auf dem gleichen Server betreiben kann. Hierzu gibt es immer wieder Fragen, wie dies am besten realisiert werden kann. Im folgenden Artikel soll daher exemplarisch die Vorgehensweise zur Einrichtung von WordPress neben ownCloud/Nextcloud gezeigt werden.
WordPress dient dazu lediglich als Beispiel für eine PHP-Anwendung, daher wird hier nicht weiter auf die Details der Konfiguration und Absicherung des Content-Management-Systems eingegangen. Das gezeigte Konzept sollte allerdings auch auf andere Web-Applikationen übertragbar sein. Wenn es mal nicht klappen sollte, liefert der Artikel Tipps und Tricks zur Fehlersuche.
Kein WordPress? Hinweise für andere Web-AnwendungenAndere Anwendungen haben im Vergleich zu WordPress evtl. andere Anforderungen an den Webserver. Daher kann es notwendig sein, dass für andere Applikationen eine leicht geänderte Herangehensweise bzw. zusätzliche Schritte notwendig sind. (Allgemeine) Hinweise hierzu gibt es immer in einem separaten Dropdown-Text wie diesem hier.
Update-Historie
- 07.10.2017:
- Einrichtung für FHEM hinzugefügt.
- 09.10.2017:
- Genauere Beschreibung, wo die Anpassungen an der wp-config.php vorgenommen werden müssen
- location-Block für WordPress angepasst (location ^~ /wordpress > location ^~ /wordpress/).
- 26.10.2017:
- open_basedir im virtuellen Host für WordPress angepasst, so dass auch ein Upload von Dateien möglich ist.
- 07.11.2017:
- Virtuellen Host für WordPress angepasst, so dass nun auch anders aufgebaute Permalinks für WordPress möglich sind.
Ausgangssituation
Als Basis dient die Konfiguration, die im Artikel ownCloud 9 auf Ubuntu Server 16.04 LTS mit nginx, MariaDB, PHP 7 und Let’s Encrypt gezeigt wird. Daher sollte der Artikel bereits bekannt sein, weil nicht mehr auf spezielle Details der Konfiguration eingegangen wird.
Folgende Programmversionen kommen hier zum Einsatz:
- Ubuntu Server 16.04.1 LTS („Xenial Xerus“)
- nginx 1.11.3
- MariaDB 10.1.17
- PHP 7
Das Tutorial zu ownCloud weist dabei mehrere Besonderheiten auf, welche die Flexibilität des Webservers erhöhen, leider aber auch die Komplexität:
- Zunächst sollen die einzelnen Anwendungen in einem Unterverzeichnis des Webroots (https://owncloud9tutorial.goip.de) liegen. So erfolgt der Aufruf von ownCloud beispielsweise über https://owncloud9tutorial.goip.de/owncloud.
- Zum anderen werden alle Client-Anfragen zunächst von einem zentralen Gateway-Host entgegengenommen – über die Standard-Ports 80 (HTTP) und 443 (HTTPS). Neben diesem Gateway-Host gibt es darüber hinaus für jede Web-Anwendung (z.B. ownCloud/Nextcloud) einen einzelnen virtuellen Host, der sich exklusiv um diese Applikation kümmert. Der Gateway-Host nutzt nun die Reverse-Proxy-Fähigkeiten von nginx (proxy_pass), um die Anfragen der Clients an die jeweiligen (Anwendungs-)Hosts weiter zu leiten.
- Die gesamte Kommunikation soll dabei nur über gesicherte SSL-Verbindungen möglich sein (HTTPS). Alle HTTP-Anfragen werden daher zu HTTPS weitergeleitet. Für die Kommunikation mittels HTTPS kommt dabei ein Zertifikat von Let’s Encrypt zum Einsatz.
Im Folgenden werden Dateinamen, URLs, o.ä. analog zum ownCloud-Tutorial benannt. Auf diese Weise können die Zusammenhänge am besten dargestellt werden.
Virtuellen Host für WordPress anlegen
Für WordPress soll (wie schon für ownCloud) ein eigener virtueller Host zuständig sein. Angelegt wird dieser über folgenden Befehl. Der Dateiname ist an dieser Stelle egal, er muss nur auf .conf enden, damit diese Konfiguration von nginx geladen werden kann.
1 | nano /etc/nginx/conf.d/owncloud9tutorial.goip.de_wordpress.conf |
Hier wird nun die (minimale) Konfiguration des Webservers für WordPress hinzugefügt:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 | server { server_name 127.0.0.1; listen 127.0.0.1:83; root /var/www/; location ^~ /wordpress { index index.php; location /wordpress { try_files $uri $uri/ /wordpress/index.php$args; } location = /wordpress/favicon.ico { log_not_found off; access_log off; } location = /wordpress/robots.txt { allow all; log_not_found off; access_log off; } location ~ \.php$ { try_files $uri =404; fastcgi_split_path_info ^(.+\.php)(/.+)$; include fastcgi_params; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; fastcgi_param PATH_INFO $fastcgi_path_info; fastcgi_pass php-handler; fastcgi_connect_timeout 60; fastcgi_index index.php; fastcgi_param PHP_VALUE "open_basedir=/var/www/wordpress:/tmp/ upload_max_filesize = 1G post_max_size = 1G max_execution_time = 3600"; } location ~* /wordpress/\.(js|css|png|jpg|jpeg|gif|ico)$ { expires max; log_not_found off; } } } |
Wichtig: Für diesen virtuellen Host sind folgende Punkte zu beachten:
- Der server Block behandelt nur HTTP-Anfragen, also kein HTTPS. Wovon allerorts abgeraten wird, macht hier Sinn, da sich der Gateway-Host (und nur dieser!) um die HTTPS-Kommunikation kümmert. Nach außen hin wird auch WordPress später ausschließlich mittels HTTPS zu erreichen sein.
- listen 127.0.0.1:83 und server_name 127.0.0.1: Damit wird angegeben, dass dieser Host nur über die Loopback-Adresse (127.0.0.1) angesprochen werden kann. Dadurch ist es nicht möglich, diesen „von außen“, d.h. ohne den Gateway-Host passiert zu haben, zu erreichen.
Ebenfalls von Bedeutung ist die Port-Angabe (83): Jeder virtuelle Host muss hier seinen eigenen Port bekommen. Da der ownCloud-Host in der Beispiel-Konfiguration bereits auf Port 82 lauscht, nehmen wir hier einfach die nächste Port-Nummer. - Es gibt einen umgebene location Block (location ^~ /wordpress {…}). Innerhalb dieses Blocks sind alle anwendungsspezifischen Anweisungen enthalten. Diese sind dann analog zu einer Standalone-Installation, d.h. wenn WordPress über eine Domain (ohne Unterverzeichnis) als einzige Webanwendung auf dem Server laufen würde (diese Konfiguration findet man in zahlreichen Online-Tutorials). Der einzige Unterschied ist hierbei, dass alle enthaltenen location Blöcke mit der Pfadangabe /wordpress ergänzt werden müssen.
- Der für PHP-Dateien zuständige location Block setzt mit fastcgi_param PHP_VALUE explizit die Variable open_basedir. Dadurch kann der Host für WordPress (bzw. die dazugehörenden PHP-Skripte) nur auf das eigene Verzeichnis zugreifen. Andere PHP-Anwendungen haben hier im Vergleich ihre eigene Definition von open_basedir mit jeweils eigenen Verzeichnissen.
Der gezeigte virtuelle Host stellt eine minimale Konfiguration für WordPress dar. Andere Web-Applikationen benötigen hier u.U. andere und/oder zusätzliche Anweisungen. Dies wird besonders klar, wenn man sich dagegen den virtuellen Host für ownCloud ansieht.
Leider ist diese Konfiguration von Applikation zu Applikation verschieden. Einen guten Anhaltspunkt erhält man dabei meist über eine Google-Suche (<Name der Anwendung> nginx, z.B. Koken nginx).
Erweiterung des Gateway-Hosts
Damit die Weiterleitung vom Gateway-Host zum WordPress-Host funktionieren kann, muss der Gateway-Host noch bearbeitet werden:
1 | nano /etc/nginx/conf.d/owncloud9tutorial.goip.de.conf |
Die WordPress-Installation soll später unter der URL https://owncloud9tutorial.goip.de/wordpress erreichbar sein. Dazu muss an dieser Stelle ein separater location Block eingefügt werden (direkt unter dem Block für ownCloud):
1 2 3 4 5 6 7 8 9 | location ^~ /wordpress/ { proxy_set_header Host $host; proxy_set_header X-Forwarded-Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; proxy_pass http://127.0.0.1:83; proxy_redirect off; } |
Diese Anweisungen sorgen dafür, dass sämtliche Anfragen an https://owncloud9tutorial.goip.de/wordpress an den virtuellen Host für WordPress weitergeleitet werden.
Wichtig: Die eigentliche Weiterleitung verbirgt sich hinter dem proxy_pass. Hier gibt es drei Dinge zu beachten:
- Die Weiterleitung erfolgt auf die Loopback-Adresse 127.0.0.1. Auf dieser Adresse lauscht der virtuelle Host für WordPress.
- Der Port (hier 83) muss mit der Port-Angabe des virtuellen Hosts für WordPress übereinstimmen.
- Die Weiterleitung erfolgt über HTTP (nicht HTTPS). Der Gateway-Host übernimmt das HTTPS-Handling, die Hosts für die einzelnen Web-Anwendungen laufen (intern) über HTTP.
Wenn man den Gateway-Host bearbeitet, sollte man auch gleich kontrollieren, ob hier der Handler für PHP zu finden ist. Folgende Zeilen sollten in der Datei ganz oben stehen:
1 2 3 | upstream php-handler { server unix:/run/php/php7.0-fpm.sock; } |
Falls nicht, ist der Handler vermutlich in der Config-Datei für ownCloud zu finden (owncloud9tutorial.goip.de_owncloud.conf). In diesem Fall muss der Handler im ownCloud-Host gelöscht werden und im Gateway-Host neu hinzugefügt werden. Er darf auch nicht mehrfach in unterschiedlichen virtuellen Hosts enthalten sein.
Hinweise für andere Web-AnwendungenWie schon im virtuellen Host der Web-Applikation kann es sein, dass eine andere Anwendung abweichende oder zusätzliche Angaben für die Weiterleitung benötigen. Trotzdem sollte die hier gezeigte Weiterleitung in den meisten Fällen funktionieren bzw. einen guten Ansatzpunkt bieten.
Installation WordPress
Nachdem der Webserver nun für die neue Anwendung vorbereitet wurde, ist es nun an der Zeit, WordPress zu installieren.
Anlegen der Datenbank
WordPress ist ein Datenbank-gestütztes Content-Management-System und so sollte die Datenbank bereits vor dem ersten Aufruf angelegt werden. Dazu wird die Verwaltung für MariaDB/MySQL aufgerufen:
1 | mysql -u root -p |
Nach der Eingabe des Root-Passworts kann die Datenbank mit folgenden Befehlen angelegt werden:
1 2 3 4 5 | create database wordpress_db; create user wordpress_db_user@localhost identified by 'MeInPasSw0rT'; grant all privileges on wordpress_db.* to wordpress_db_user@localhost; flush privileges; exit; |
Dabei sorgt die Angabe localhost dafür, dass der Zugriff auf die Datenbank nur vom lokalen Rechner aus möglich ist.
WordPress Dateien herunterladen und Anpassen der Verzeichnisrechte
Als nächstes besorgen wir uns die aktuelle Version von WordPress und entpacken diese in das Verzeichnis /var/www/wordpress. Die Pfadangabe hinter /var/www muss dabei identisch zur Pfadangabe im entsprechenden virtuellen Host sein. Siehe umgebener location Block (location ^~ /wordpress {…}) im Host für WordPress.
1 2 3 | cd ~ wget https://wordpress.org/latest.tar.gz tar xzvf latest.tar.gz -C /var/www |
Nun werden auch gleich die entsprechenden Verzeichnisrechte:
1 2 3 | find /var/www/wordpress/ -type f -print0 | xargs -0 chmod 0640 find /var/www/wordpress/ -type d -print0 | xargs -0 chmod 0750 chown -R www-data:www-data /var/www/wordpress |
Anpassen der wp-config.php
Das Blog-System speichert die grundlegenden Einstellungen in der Datei wp-config.php im WordPress-Verzeichnis. Dazu muss erst einmal die Beispiel-Konfiguration kopiert und angepasst werden:
1 2 3 | cd /var/www/wordpress cp wp-config-sample.php wp-config.php nano wp-config.php |
Hier muss zunächst einmal die bereits angelegte Datenbank bekannt gemacht werden (Name der Datenbank, Benutzername und dazugehöriges Passwort):
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 | // ** MySQL settings - You can get this info from your web host ** // /** The name of the database for WordPress */ define('DB_NAME', 'wordpress_db'); /** MySQL database username */ define('DB_USER', 'wordpress_db_user'); /** MySQL database password */ define('DB_PASSWORD', 'MeInPasSw0rT'); /** MySQL hostname */ define('DB_HOST', 'localhost'); /** Database Charset to use in creating database tables. */ define('DB_CHARSET', 'utf8'); /** The Database Collate type. Don't change this if in doubt. */ define('DB_COLLATE', ''); |
Wenn wir schon mal in der Config von WordPress sind, dann können wir gleich noch zwei Sicherheits-relevante Änderungen vornehmen. Dazu gehört zum einen die Anpassung der Authentifizierungs-Keys. Dazu ruft man zunächst den Key-Generator im Browser seiner Wahl auf (WordPress-Key-Generator) und übernimmt diese Inhalte einfach per Copy & Paste in den Bereich Authentication Unique Keys and Salts in die wp-config.php.
Zum anderen kann man an dieser Stelle den Tabellen-Prefix für WordPress ändern. Standard ist hier wp_. Dies sollte nach Möglichkeit gleich geändert werden, am Besten in eine Bezeichnung, die keine Rückschlüsse auf WordPress zulässt:
1 2 3 4 5 6 7 | /** * WordPress Database Table prefix. * * You can have multiple installations in one database if you give each * a unique prefix. Only numbers, letters, and underscores please! */ $table_prefix = 'ow5n6_'; |
An dieser Stelle bitte nicht einfach den Code übernehmen, sondern ein eigenes Prefix vergeben.
WordPress: Aufruf und Setup
Nachdem WordPress nun mitsamt Datenbank und Konfiguration eingerichtet ist, sollte das Content-Management-System einsatzbereit sein. Bitte diesen Abschnitt vorher komplett lesen, da es hier nochmal einige Fallstricke gibt, die im weiteren Verlauf aufgelöst werden können. Mit diesen Erkenntnissen muss man dann nicht mehr den „Umweg“ per Trial & Error gehen.
WordPress-Setup: erster Versuch
Weil Änderungen an den virtuellen Hosts vorgenommen wurden, muss der Webserver zunächst einmal neu gestartet werden:
1 | service nginx restart |
Wenn man danach allerdings in freudiger Erwartung die WordPress-URL aufruft (https://owncloud9tutorial.goip.de/wordpress), erlebt man einen herben Rückschlag:
Das WordPress-Setup wird zwar angezeigt, allerdings sieht die Seite komisch aus – sämtliche Formatierungen und Bilder scheinen zu fehlen. Offensichtlich werden die CSS-Dateien für die Formatierung von Text und Seite nicht korrekt geladen. Ein Blick in die Log-Datei von nginx (/var/log/nginx/error.log) liefert jedoch keinen Hinweis darauf, dass es beim Aufruf dieser Dateien zu Problemen kommt. Dies ist schon mal ein Hinweis darauf, dass es nicht an der Struktur des virtuellen Hosts für WordPress liegt.
Ein weiteres Indiz: Wenn man einen Blick auf den Seitenquelltext wirft (z.B. in Chrome: Rechtsklick auf freien Bereich der Website > Seitenquelltext anzeigen) und die URL einer konkreten CSS-Datei kopiert, lässt sich diese im Browser eingeben und der Dateiinhalt wird anschließend korrekt geladen. Die Dateien werden also vom Webserver definitiv richtig ausgeliefert.
Den entscheidenden Hinweis liefert erst die Developer-Konsole von Chrome (Shortcut: F12): Der Browser hat Mixed Content erkannt (HTTP/HTTPS) und den vermeintlich unsicheren (HTTP-)Inhalt blockiert.
Wie sich (nach langer Web-Recherche) herausstellt, handelt es sich hier um ein Problem von WordPress selbst: URLs von CSS- oder auch JavaScript-Dateien (*.js) werden hier absolut mittels einer Basis-URL angegeben. Durch das Konstrukt von Gateway-Host und Anwendungs-Host (letzterer wird intern nur über HTTP aufgerufen) ergibt sich hier die Problematik mit Mixed Content. Besser wäre es, wenn WordPress die URLs relativ angeben würde…
Die Lösung
Nun wollen wir natürlich nicht den Quellcode von WordPress direkt anpassen. Das Problem lässt sich aber zum Glück auch anderweitig in den Griff bekommen: Mit einem Zusatz in der wp-config.php weisen wir WordPress an, dass sämtliche Anfragen, die per HTTPS kommen, auch über HTTPS beantwortet werden. Dazu fügen wir in der wp-config.php ganz am Anfang, aber nach dem <?php (wichtig!) – also am besten nach dem großen Kommentar-Block ganz am Anfang – folgende Zeilen hinzu:
1 2 3 4 5 6 7 8 | if (strpos($_SERVER['HTTP_X_FORWARDED_PROTO'], 'https') !== false) $_SERVER['HTTPS']='on'; if(isset($_SERVER['HTTP_X_FORWARDED_HOST'])) $_SERVER['HTTP_HOST'] = $_SERVER['HTTP_X_FORWARDED_HOST']; define('WP_HOME', 'https://owncloud9tutorial.goip.de/wordpress'); define('WP_SITEURL', 'https://owncloud9tutorial.goip.de/wordpress'); |
Nach dem Speichern der Datei kann die URL im Browser aktualisiert werden und wird nun korrekt angezeigt:
Wozu der Umweg?
Den Umweg (erster Aufruf, Nachbesserung und zweiter Versuch) kann man sich natürlich sparen, wenn man weiß, wo hier die Probleme liegen. Die geschilderten Ausführungen zeigen jedoch bewusst den Weg, den man bei der Einrichtung einer weiteren Web-Applikation gehen würde. Dies soll ein deutlicher Hinweis darauf sein, dass man schnell mit Problemen konfrontiert wird, die bei einer Standalone-Installation so nicht auftreten sollten und man ein wenig rumprobieren muss, bis man letzten Endes zum Ziel kommt. Gerade wenn das Problem zunächst einmal nichts mit der Konfiguration des Webservers bzw. der virtuellen Hosts zu tun hat (z.B. falsch angegebene location Blöcke), muss man ggf. die Anwendung selbst bzw. deren Konfiguration anpassen.
Hinweise für andere Web-AnwendungenDie notwendigen Änderungen sind dabei ganz individuell von der jeweiligen Applikation abhängig! Manchmal funktioniert es out-of-the-box und es sind keine weiteren Anpassungen nötig, manchmal aber eben nicht. Daher gibt es hier leider keine allgemeingültige Lösung, die für jede Anwendung passt.
Weitere Schritte in WordPress
Auch wenn WordPress nun soweit funktioniert, sollte man sich um die Sicherheit des Blog-Systems kümmern. In diesem Artikel wurden nur grundlegende Anpassungen bzw. der Sicherheit durchgeführt (z.B. Erzeugen der Authentication Keys oder auch das Ändern des Prefixes für WordPress-Tabellen).
Eine komplette Beschreibung der Optimierung und Absicherung von WordPress würde den Rahmen des Artikels sprengen. Hier liefert folgende Artikel-Serie eine Menge Infos und Anregungen: WordPress absichern.
Prinzipiell sollte man sich grundlegend mit der gehosteten Applikation vertraut machen und gezielte Optimierungen vornehmen.
Tipps & Tricks
Die in diesem Artikel gezeigten Schritte gelten (zumindest grundlegend) auch für andere Web-Anwendungen.
Wenn es dabei mal hakt, sollten folgende Tipps dabei helfen, das Problem schnell zu erkennen und zu beseitigen:
Neustart Webserver/PHP-FPM
Wenn gemachte Änderungen anscheinend keinerlei Auswirkungen zu haben scheinen, dann fehlt vermutlich ein Neustart bestimmter Dienste:
Nach Anpassungen an virtuellen Hosts sollte nginx immer neu gestartet werden:
1 | service nginx restart |
Wenn es hierbei bereits zu Fehlern kommt (erfahrungsgemäß sind dies dann einfache Tippfehler in einem der Hosts), hilft ein Testen der Konfiguration mit:
1 | nginx -t |
Der Befehl zeigt die betroffene Datei und die genaue Stelle, an dem das Problem aufgetreten ist.
Falls Änderungen an der PHP-Konfiguration durchgeführt werden müssen (eher unwahrscheinlich), dann sollte auch der Dienst für PHP neu gestartet werden:
1 | service php-fpm restart |
Log-Dateien kontrollieren
Bei auftretenden Problemen lohnt meist ein Blick in die Log-Dateien. Gerade bei HTTP-Statusfehlern (z.B. Fehler 403) sollte hier ein erster Ansatzpunkt zu finden sein. Dies liegt meistens an einer falschen Webserver-Konfiguration (virtuelle Hosts). Die zu prüfenden Logs sind dabei:
- nginx Fehler-Log: /var/log/nginx/error.log
- Log der Web-Anwendung: Wo dieser zu finden ist, hängt von der jeweiligen Anwendung ab
Developer-Konsole (Browser)
Falls keine Hinwiese in den Log-Dateien zu finden sind, hilft (wie in diesem konkreten Beispiel mit WordPress) ein Blick in die Developer-Konsole des verwendeten Browsers. Diese wird meistens über den Shortcut F12 gestartet (Chrome, Firefox, Internet Explorer). Die Vorgänge beim Laden einer Seite findet man meistens in einem Tab Konsole bzw. Console.
Web-Suche
Dieser Tipp ist zwar offensichtlich, soll aber trotzdem nicht unerwähnt bleiben: Die Konfiguration unter nginx mit einem Gateway-Host ist recht ungewöhnlich und unterscheidet sich z.T. erheblich von einer Standalone-Konfiguration (oftmals beschreiben Tutorials lediglich die Einrichtung unter nginx unter dem Webroot, bzw. als Subdomain). Eine Web-Suche nach <Anwendung> nginx SSL Proxy sollte Ergebnisse liefern, die zumindest die grobe Richtung des Unterfangens weisen.
Vorgehenswiese für andere Web-Applikationen
Nun seid ihr gefragt: Habt ihr andere Anwendungen mit der Konfiguration mit einem Gateway-Host und einzelnen (spezialisierten) virtuellen Hosts zum Laufen bekommen? Dann hinterlasst doch einen Kommentar oder schreibt mir besser noch eine E-Mail mit detaillierten Anweisungen. Ggf. wird der Artikel dann um konkrete Anweisungen für weitere Web-Applikationen erweitert.
FHEM
FHEM ist eine Software zur Heimautomatisierung, mit der verschiedenste Geräte/Protokolle verwaltet werden können. Damit wird klar, dass man hier besondere Vorsicht walten lassen muss, wenn die eigene Heimautomatisierung über das Internet erreichbar sein soll – es soll ja schließlich nicht jeder Zugriff auf die IT in den eigenen vier Wänden haben.
Die Installation der Software ist auf der FHEM-Homepage recht gut beschrieben. Hier geht es zwar um ein Paket für Debian, dies ist aber auch für andere Linux-Distributionen zu verwenden.
Daher wird dringend empfohlen, den Zugriff auf FHEM per Basic Authentication abzusichern. Dies kann direkt in FHEM erledigt werden, dennoch bevorzuge ich die Absicherung über den Webserver selbst.
Um die Basic Authentication einzurichten, muss zunächst einmal ein Paket installiert werden (ja, es ist ein Apache-Modul, aber dies wird auch für nginx verwendet):
1 | apt-get install apache2-utils |
Als nächstes wird eine .htpasswd-Datei generiert:
1 | htpasswd -c /etc/nginx/.htpasswd MeinBenutzer |
Für MeinBenutzer sollte der Benutzer angegeben werden, der später Zugriff auf FHEM haben soll. Anschließend wird nach einem Passwort gefragt, welches nochmals bestätigt werden muss.
Nach der Installation von FHEM kann die Heimautomatisierung auf drei verschiedenen Wegen aufgerufen werden:
- serverhostnameoderIP:8083: Optimierte Oberfläche für Desktop-PCs.
- serverhostnameoderIP:8084: Optimierte Version für Smartphones.
- serverhostnameoderIP:8085: Optimierte Darstellung für Tablets.
Diese drei Möglichkeiten sollen nun auch über nginx abgebildet werden. Da der Webserver von außen nur über die Ports 80 und 443 erreichbar ist, soll für jede Darstellung ein eigenes Verzeichnis auf dem Webserver dienen.
Dazu wird zunächst ein virtueller Host für FHEM angelegt:
1 | nano /etc/nginx/conf.d/owncloud.goip.de_fhem.conf |
Der Inhalt der Datei sieht folgendermaßen aus (wie immer muss der Port bei listen sich von allen anderen Ports der virtuellen Hosts unterscheiden):
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 | server { listen 83; server_name 127.0.0.1; location /fhem { set $my_http_upgrade ""; set $my_connection "Connection"; if ($http_upgrade = "websocket") { set $my_http_upgrade $http_upgrade; set $my_connection "upgrade"; } proxy_set_header Upgrade $my_http_upgrade; proxy_set_header Connection $my_connection; proxy_read_timeout 3600; proxy_pass http://127.0.0.1:8083; proxy_redirect off; proxy_buffering off; } location /fhemphone{ proxy_pass http://127.0.0.1:8084; proxy_redirect off; proxy_buffering off; } location /fhemtablet { proxy_pass http://127.0.0.1:8085; proxy_redirect off; proxy_buffering off; } } |
Die if-Anweisung im location-Block für fhem ist zwar etwas unschön, wird aber für den Zugriff per Websocket benötigt. Dies muss im Prinzip nur eingestellt werden, wenn die Oberfläche von FHEM ständig aktuell gehalten werden soll (siehe FHEMWEB). Wenn Websockets auch für den Zugriff über Smartphone/Tablets verwendet werden sollen, sind diese Zeilen auch in die anderen location-Blöcke zu übernehmen.
Als nächstes folgt der Gateway-Host:
1 | nano /etc/nginx/conf.d/owncloud.goip.de.conf |
Hier fügen wir am Ende die Anweisungen für FHEM hinzu:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 | # # FHEM # location ~* /(fhem|fhemphone|fhemtablet) { auth_basic "Restricted"; auth_basic_user_file /etc/nginx/htpasswd/.htpasswd; set $my_http_upgrade ""; set $my_connection "Connection"; if ($http_upgrade = "websocket") { set $my_http_upgrade $http_upgrade; set $my_connection "upgrade"; } proxy_set_header Upgrade $my_http_upgrade; proxy_set_header Connection $my_connection; proxy_read_timeout 3600; proxy_pass http://127.0.0.1:83; proxy_redirect off; proxy_buffering off; } |
Hier kommt auch die zuvor angelegte .htpasswd-Datei zum Einsatz, die den kompletten Zugriff auf FHEM begrenzt. Wie schon für den vHost für FHEM ist hier eine „Spezialbehandlung“ für Websockets notwendig.
Nun wird der Webserver noch neu gestartet, damit die Änderungen übernommen werden:
1 | service nginx restart |
Anschließend kann FHEM über die drei URLs aufgerufen werden:
- https://owncloud9tutorial.goip.de/fhem: Version für Desktop-Rechner.
- https://owncloud9tutorial.goip.de/fhemphone: Darstellung für Smartphones.
- https://owncloud9tutorial.goip.de/fhemtablet: Optimierte Version für Tablets.
Netdata
Netdata ist eine Monitoring-Anwendung, die es erlaubt, Daten (wie z.B. Auslastung, Zugriffe auf einen Webserver, etc.) von einem Server übersichtlich darzustellen und auszuwerten. Demo-Anwendungen zu Netdata sind hier zu finden.
Um Netdata als Web-Applikation zu installieren, muss es neben den benötigten Paketen die Anwendung selbst zunächst einmal installiert werden:
1 2 3 4 5 | apt-get update apt-get install zlib1g-dev uuid-dev libmnl-dev gcc make autoconf autoconf-archive autogen automake pkg-config curl git clone https://github.com/firehol/netdata.git --depth=1 ~/netdata cd ~/netdata ./netdata-installer.sh |
Nach der Installation kann Netdata konfiguriert werden:
1 | nano /etc/netdata/netdata.conf |
Beispielsweise kann hier in der [global] Sektion festgelegt werden, wie umfangreich die History der erfassten Daten sein soll. Dazu den Kommentar bei der folgenden Zeile entfernen:
1 | history = 14400 |
Um das sog. Kernel Samepage Merging zu aktivieren, sind dann folgende Schritte notwendig: In der Datei /etc/rc.local sind diese Zeilen zu ergänzen:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 | #!/bin/sh -e # # rc.local # # This script is executed at the end of each multiuser runlevel. # Make sure that the script will "exit 0" on success or any other # value on error. # # In order to enable or disable this script just change the execution # bits. # # By default this script does nothing. echo 1 > /sys/kernel/mm/ksm/run echo 1000 > /sys/kernel/mm/ksm/sleep_millisecs exit 0 |
Um Netdata nun in der Konfiguration mit einem nginx Gateway-Host zum Laufen zu bekommen, muss zunächst einmal der Gateway-Host ergänzt werden:
1 | nano /etc/nginx/conf.d/owncloud9tutorial.goip.de.conf |
Hier wird wie gewohnt eine Weiterleitung an einen nicht belegten Port des Webservers hinzugefügt:
1 2 3 4 | # netdata configuration location ^~ /netdata { proxy_pass http://127.0.0.1:84; } |
Die eigentliche Arbeit übernimmt ein spezieller vHost für Netdata:
1 | nano /etc/nginx/conf.d/owncloud.goip.de_netdata.conf |
Dabei sieht der Inhalt der Datei wie folgt aus:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 | upstream netdata { server 127.0.0.1:19999; keepalive 64; } server { listen 84; # the virtual host name of this subfolder should be exposed server_name 127.0.0.1; location /netdata { return 301 /netdata/; } location ~ /netdata/(?<ndpath>.*) { proxy_redirect off; proxy_set_header Host $host; proxy_set_header X-Forwarded-Host $host; proxy_set_header X-Forwarded-Server $host; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_http_version 1.1; proxy_pass_request_headers on; proxy_set_header Connection "keep-alive"; proxy_store off; proxy_pass http://netdata/$ndpath$is_args$args; gzip on; gzip_proxied any; gzip_types *; } } |
Zum Abschluss der Installation sollte sowohl Netdata, als auch nginx neu gestartet werden:
1 2 | systemctl restart netdata service nginx restart |
Der Aufruf erfolgt dann über ein Unterverzeichnis des Webservers: http://owncloud9tutorial.goip.de.conf/netdata
Zu guter letzt kann Netdata auch über Skripte upgedated (oder sogar deinstalliert werden):
1 2 | ./netdata-uninstaller.sh ./netdata-updater.sh |
Um ein Update vollautomatisch per Cronjob erledigen zu lassen, ist dieser wie folgt anzulegen:
1 | sudo ln -s /home/[BENUTZER]/netdata/netdate-update.sh /etc/cron.daily/netdata-update |
Vielen Dank an Hans für die umfangreiche Anleitung!
Roundcube
Roundcube ist eine Anwendung für Webmail über IMAP. Leser Adrian K. hat dazu eine Konfiguration entwickelt, die es erlaubt, Roundcube neben ownCloud/Nextcloud auf dem gleichen Server laufen zu lassen.
Der Gateway-vHost wird dazu analog zu ownCloud/Nextcloud erweitert (hier wird z.B. der freie Port 83 für die Weiterleitung verwendet):
1 2 3 4 5 6 7 8 9 | location ^~ /mail { proxy_set_header Host $host; proxy_set_header X-Forwarded-Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto https; proxy_pass http://127.0.0.1:83; proxy_redirect off; } |
Für Roundcube wird anschließend ein eigenständiger vHost verwendet:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 | server { server_name 127.0.0.1; listen 127.0.0.1:83; root /var/www/; location ^~ /mail { index index.php; location ~ ^/favicon.ico$ { root /var/www/mail/skins/default/images; log_not_found off; access_log off; expires max; } location = /mail/robots.txt { allow all; log_not_found off; access_log off; } location ~ \.php$ { try_files $uri =404; fastcgi_split_path_info ^(.+\.php)(/.+)$; include fastcgi_params; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; fastcgi_param PATH_INFO $fastcgi_path_info; fastcgi_pass php-handler; fastcgi_connect_timeout 60; fastcgi_index index.php; fastcgi_param PHP_VALUE "open_basedir=/var/www/mail:/tmp/ upload_max_filesize = 1G post_max_size = 1G max_execution_time = 3600"; } location ~* /mail/\.(js|css|png|jpg|jpeg|gif|ico)$ { expires max; log_not_found off; } } } |
Vielen Dank an Adrian für die Konfiguration.
shellinabox
shellinabox ist ein Terminal, welches über eine Weboberfläche aufgerufen werden kann.
Um shellinabox mit einen Gateway-Host laufen zu lassen, ist erstmal eine Anpassung in der Konfiguration von shellinabox notwendig (nano /etc/default/shellinabox):
1 | SHELLINABOX_ARGS="--no-beep --localhost-only --disable-ssl" |
Besonders der letzte Parameter (–disable-ssl) ist hier wichtig, da der proxy_pass vom Gateway-Host an shellinabox unverschlüsselt über HTTP läuft. Dies ist aber kein Sicherheitsrisiko, da die Verschlüsselung „eine Ebene höher“ vom Gateway-Host übernommen wird.
Darüber hinaus sind folgende Erweiterungen im Gateway-vHost notwendig (angenommen, Port 83 ist noch nicht belegt):
1 2 3 4 | location ^~ /shellinabox { proxy_pass http://127.0.0.1:83; proxy_read_timeout 90; } |
1 2 3 4 5 6 7 8 9 10 | server { listen 83; server_name 127.0.0.1; location /shellinabox/ { rewrite ^/shellinabox/(.*) /$1 break; proxy_pass http://127.0.0.1:4200; proxy_read_timeout 90; } } |
Weiterführende Artikel
- ownCloud 9 auf Ubuntu Server 16.04 LTS mit nginx, MariaDB, PHP 7 und Let’s Encrypt
- Ubuntu Server als Hyper-V Gastsystem installieren und optimal einrichten
- HTTPS für alle: SSL-Zertifikate mit Let’s Encrypt und nginx
Links
- WordPress
- Let’s Encrypt
- WordPress-Key-Generator
- Cascading Style Sheets (Wikipedia)
- HTTP-Statuscode (Wikipedia)
- WordPress absichern (Artikel-Serie von Kuketz IT-Security)
- FHEM
- Roundcube
- shellinabox
Windows Server Advanced Power Management: Version 1.5.3 Windows Server Advanced Power Management: Version 1.5.4
Hay Jan,
Danke für die Rückmeldung.
Habe es hinbekommen.
Falles wer wissen möchte wie man seinen Admin-/Benutzernamen ändern kann hier eine „Mini-Anleitung“ anhand der Daten aus der Anleitung von Jan. Natürlich lassen sich auch andere Nutzernamen dort ändern indem man die jeweilige ID anpasst.
sudo mysql -u root -p
MeInPasSw0rT
use wordpress_db
show tables;
SELECT ID, user_login, user_pass FROM ow5n6_users;
UPDATE ow5n6_users SET user_login = „wordpress_db_new_user_name“ WHERE ID = 1;
SELECT ID, user_login, user_pass FROM ow5n6_users;
exit
Grüße
Hi,
hey super, danke für die Anleitung. Ist vielleicht auch für andere interessant.
Gruß,
Jan
Hallo Jan,
echt toll deine Anleitungen! Habe nun zum ersten Mal einen Linux Server am Laufen. Mit Nextcloud und WordPress parallel im Betrieb.
Jetzt komme ich allerdings nicht weiter. Ich möchte den WordPress Admin Bereich und das Login durch auth_basic sichern. Die Datei htpasswd habe ich erzeugt und mit generierten Daten gefüllt. Aber wie sieht mein location Eintrag aus? Und wo genau kommt der hin?
Danke dir!
Meiko
Hi Meiko,
ein Basic-Auth nachträglich hinzuzufügen ist prinzipiell kein Problem. Allerdings ist der Admin-Bereich in WP ja bereits durch ein Passwort geschützt. Man hätte dann immer eine zweimalige Passwort-Abfrage.
Erst einmal brauchst du dazu folgendes Paket:
apt-get install apache2-utils
Danach lässt du eine htaccess-Datei generieren (wenn dein User z.B. „Admin“ heißt):
sudo htpasswd -c /etc/nginx/htpasswd/.htpasswd_wpadmin Admin
Hier wirst du dann zwei mal nach einem Passwort gefragt.
Zum Schluss wird die Datei noch in den WP-vHost eingebunden. Dazu eine neue Location anlegen:
location /wordpress/wp-admin/ {
auth_basic "Authorization Required";
auth_basic_user_file /etc/nginx/htpasswd/.htpasswd_wpadmin;
}
Den Webserver anschließend neu starten und nun sollte der Admin-Bereich zusätzlich durch Basic-Auth gesichert sein.
Gruß,
Jan
Großartig! Das hat jetzt geklappt. Ich hatte es zuvor mit einem online-generierten Inhalt der htpasswd nicht hinbekommen. Dann muss es daran gelegen haben. Vielen Dank.
Hallo Jan,
hättest du Lust eine Erweiterung für den RSS-Reader miniflux hinzuzufügen? 🙂
Viele Grüße
Kai
Hallo Kai,
hast du denn miniflux schon zum Laufen bekommen? Dann kann ich die Konfiguration gern in den Artikel mit aufnehmen.
Gruß,
Jan