Das Mini_HTTPD-Paket Das Mini_HTTPD-Paket enthaelt einen kleiner HTTP-Server. Seine Performance ist nicht grossartig, aber fuer Seiten mit geringem Datenverkehr ist er ausreichend. Die Einleitung Dem Mini_HTTPD wurden alle Standardfunktionen eines HTTP-Servers implementiert, darunter: * GET, HEAD und POST Methoden * CGI * Basic authentication. * Sicherung gegen `..' Dateischnueffeln * die allgemeinen MIME Typen * index.html, index.htm, index.cgi (Abrufreihenfolge) * Ordnerinhalt ausgeben * virtuelle Hosts * Standard loggen * benutzerdefinierte Fehlerseiten * SSL/HTTPS und IPv6. Mini_HTTPD wurde aus einer Reihen von Gruenden programmiert. Zum einen als Experiment um zu sehen wie langsam ein alter Webserver auf heutigen Betriebssystems sein wuerde. Ueberraschenderweise lautet die Antwort `nicht sehr langsam'. Auf einem FreeBSD v3.2-System erreicht der Mini_HTTPD ungefaehr 90% der Geschwindigkeit des Apache-Webservers. Ein weiterer Grund fuer die Entwicklung des Mini_HTTPD war, auf einer einfachen Plattform mit Webserver-Technologien zu experimentieren, z.B. mit SSL. Quelle: [1]http://www.acme.com/software/mini_httpd/ Die Funktionen Das Mini_HTTPD-Paket-Paket besteht aus folgenden Komponenten: * mini_httpd - Small HTTP server ([2]http://acme.com/software/mini_httpd/) * bytes2read - Calculate kiB, MiB, GiB etc. from bytes ([3]https://www.fli4l.de/ * proccgi - Processing form data in shell CGI scripts ([4]http://www.fpx.de/fp/Software/) Es ist moeglich zusaetzliche, optionale Module zu installieren. Die Installation Das Mini_HTTPD-Paket wird ueber das Setup-Menue installiert. Wird eine aeltere Paketversion vorgefunden, so wird diese deinstalliert bevor die neuen Programmdateien installiert werden. Das Menue im Setup-Programm Das Menue im Setup-Programm ist wie folgt aufgebaut: * View documentation: Anzeigen der Dokumentation * Edit configuration: Bearbeiten der Konfiguration * Advanced configuration file handling: Konfigurationen verwalten * Status of Mini_HTTPD: Status des Webservers anzeigen * Stop Mini_HTTPD: Webserver anhalten * Start Mini_HTTPD: Webserver starten * Goto modules: Zum Modulmenue verzweigen * View log file: Die Logdatei anzeigen * View access log file: Die Zugriffslogdatei anzeigen (optional) * Exit: Untermenue verlassen Die Menuepunkte duerften selbsterklaerend sein, da sie keinerlei weiteren Eingaben erwarten. Aus diesem Grund wird auf deren Funktion nicht weiter eingegangen. Die Konfigurationsdatei In der Konfigurationsdatei, die ueber das Menue zugaenglich ist, sind folgende Parameter vorhanden; wer sie von Hand editieren will findet sie unter /etc/config.d/mini_httpd. Die Parameter START_MINI_HTTPD Wird der Wert dieses Parameter auf `yes' gestellt, so wird der Mini_HTTPD-Webserver aktiviert, der Wert `no' deaktiviert ihn. Gueltige Werte: IP-Adresse Standardwert: START_MINI_HTTPD='no' MINI_HTTPD_PORT Ueber diesen Parameter wird der TCP-Port festgelegt, ueber welchen auf den Webserver zugegriffen werden soll. Es muss darauf geachtet werden, dass der eingestellte Port nicht bereits von einem anderen Programm verwendet wird, da dies verstaendlicherweise zu Problemen fuehrt. ACHTUNG Wer seinen eisfair-Server als Router verwendet sollte sicher stellen, dass dieser Port nach aussen blockiert ist. Gueltige Werte: Zahl Standardwert: MINI_HTTPD_PORT='443' MINI_HTTPD_HEADER Wird der Wert dieses Parameter auf `yes' gestellt, so wird ein Header im Webbrowser angezeigt, der Wert `no' schaltet die Anzeige des Headers ab. Gueltige Werte: yes, no Standardwert: MINI_HTTPD_HEADER='yes' MINI_HTTPD_SSL Wird der Wert dieses Parameter auf `yes' gestellt, so wird die Verwendung des SSL-Protokolls fuer den Zugriff auf die Weboberflaeche aktiviert. Der Wert `no' hingegen erlaubt den unverschluesselten Zugriff auf die Weboberflaeche. Hinweis Bei MINI_HTTPD_SSL='yes' ist darauf zu bedenken, dass die Adresse im Webbrowser mit `https://' beginnt. Gueltige Werte: yes, no Standardwert: MINI_HTTPD_SSL='yes' MINI_HTTPD_BIND_HOST Ueber diesen Parameter kann ein Hostname festgelegt werden um den Zugriff auf den Mini_HTTPD einzuschraenken. Wird der Wert `none' gesetzt, so wird der Zugriff nicht eingeschraenkt. Gueltige Werte: none, Hostname Standardwert: MINI_HTTPD_BIND_HOST='none' MINI_HTTPD_USER_N Ueber diesen Parameter wird die Anzahl der Anwender festgelegt, welche ueber die folgenden Parameter definiert werden. Gueltige Werte: Zahl Standardwert: MINI_HTTPD_USER_N='1' MINI_HTTPD_USER_x_ACTIVE Wird der Wert dieses Parameters auf `yes' gesetzt, so wird der zugehoerige Datensatz aktiviert, `no' deaktiviert ihn. Gueltige Werte: yes, no Beispiel: MINI_HTTPD_USER_1_ACTIVE='no' MINI_HTTPD_USER_x_RIGHTS Ueber diese Parameter wird ein Anwendername, ein Kennwort und die Zugriffsrechte fuer den Zugriff auf die Weboberflaeche, pro einen Anwender festgelegt. Beispiel: MINI_HTTPD_USER_1_USER='admin' MINI_HTTPD_USER_1_PASS='admin' MINI_HTTPD_USER_1_RIGHTS='all' MINI_HTTPD_LOG Wurde der Parameter MINI_HTTPD_LOGFILE ungleich `none' gesetzt, so kann ueber diesen Parameter festgelegt werden, ob Servermeldungen in eine Logdatei geschrieben werden sollen oder nicht. Gueltige Werte: yes, no Standardeinstellungen: MINI_HTTPD_LOG='no' MINI_HTTPD_LOG_FILE (Optionaler Parameter) Wurde der Parameter MINI_HTTPD_LOGFILE ungleich `none' gesetzt, so kann ueber diesen Parameter ein Logdateiname, inkl. des Verzeichnispfades, angegeben werden. Wird dieser Parameter nicht gesetzt, so wird standardmaessig die Logdatei `/var/log/mini_httpd.log' verwendet. Gueltige Werte: Logdateiname inkl. Pfad Beispiel: MINI_HTTPD_LOG_FILE='/var/log/mini_httpd.log' MINI_HTTPD_LOG_COUNT Wurde der Parameter MINI_HTTPD_LOGFILE ungleich `none' gesetzt, so kann ueber diesen Parameter eingestellt werden, wie viele Logdateien vorgehalten werden sollen. Wird dieser Wert ueberschritten, so wird die aelteste Logdatei geloescht. Gueltige Werte: Zahl Standardeinstellungen: MINI_HTTPD_LOG_COUNT='10' MINI_HTTPD_LOG_INTERVAL Wurde der Parameter MINI_HTTPD_LOGFILE ungleich `none' gesetzt, so kann ueber diesen Parameter bestimmt werden in welchen Intervallen die Logdateien archiviert werden sollen. Zur Auswahl stehen die Schluesselwoerter 'daily' - taeglich, 'weekly' - woechentlich und 'monthly - monatlich. Gueltige Werte: daily, weekly, monthly Standardeinstellungen: MINI_HTTPD_LOG_INTERVAL='weekly' Verschiedenes 1 Wurde der Parameter MINI_HTTPD_SSL='yes' gesetzt, so sollte man beim Zugriff mittels Webbrowser der URL unbedingt das Protokoll `https://' voranstellen ;-) 2 Der Parameter MINI_HTTPD_BIND_HOST wurde vorerst nur zu Testzwecken eingebunden. __________________________________________________________________ Juergen Edner 2018-10-29