Content
Dateianzeige für mini_httpd (2.3.4)
usr/share/doc/mini_httpd/mini_httpd.txt
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