WWWOFFLE - Konfigurations-Datei - Version 2.7
=============================================
Einführung
Die Konfigurations-Datei (wwwoffle.conf) beinhaltet alle Parameter,
die den Betrieb des Proxy-Sservers steuern. Diese Datei ist in
Abschnitte aufgeteilt, die jeweils eine Reihe von Parametern wie unten
beschrieben beinhalten. Die Datei CHANGES.CONF erläutert die
Änderungen in der Konfigurationsdatei zwischen dieser Version des
Programms und früheren Versionen.
Die Datei ist in Abschnitte unterteilt, die jeweils leer sein können
oder einen oder mehrere Zeilen Konfigurations-Informationen beinhalten
können. Die Abschnitte sind benannt und die Reihenfolge in der sie in
der Datei erscheinen ist unwichtig.
Das allgemeine Format der jeweiligen Abschnitte ist das gleiche. Der
Name des Abschnitts steht in einer eigenen Zeile, um den Beginn des
Abschnitts zu markieren. Der Inhalt des Abschnitts ist durch ein Paar
von Zeilen eingeschlossen, die nur die Zeichen '{' und '}' oder '['
und ']' enthalten. Wenn die Zeichen '{' und '}' verwendet werden, sind
die Zeilen dazwischen Konfigurations-Informationen. Werden die Zeichen
'[' und ']' verwendet, dann darf dazwischen nur eine einzige nicht
leere Zeile stehen, die den Namen der Datei (im gleichen Verzeichnis)
enthält, in der die Konfigurations-Informationen dieses Abschnitts
gespeichert sind.
Kommentare werden durch das Zeichen '#' am Anfang der Zeile
gekennzeichnet und werden ignoriert. Leerzeilen sind ebenfalls
zulässig und werden ignoriert.
Die Ausdrücke URL-SPECIFICATION (oder kurz URL-SPEC) und
WILDCARD haben besondere Bedeutungen in der Konfigurations-Datei
und sind am Ende der Datei beschrieben. Jede in in '(' und ')'
eingeschlossene Option in den Beschreibungen meint, dass ein Parameter
vom Benutzer angegeben werden soll, alles zwischen '[' and ']' ist
optional, das Symbol '|' wird zur Kennzeichnung alternativer
Möglichkeiten verwendet. Einige Optionen sind nur auf bestimmte URLs
anzuwenden, dies wird durch eine URL-SPECIFICATION von '<' & '>'
eingeschlossen in der Option gekennzeichnet, die erste passende
URL-SPECIFICATION wird verwendet. Ist keine URL-SPECIFICATION
gegeben, passt dazu jede URL.
StartUp
Dieser Abschnitt enthält die Parameter, die während des Programm-Starts
verwendet werden, Änderungen and diesem Abschnitt werden igoriert, wenn die
Konfigurations-Datei neu eingelesen wird, während das Programm läuft.
bind-ipv4 = (hostname) | (ip-address) | none
Geben Sie den Hostnamen oder die IP-Adresse, an die der HTTP-Proxy und der
WWWOFFLE-Steuerungs-Port unter Verwendung von IPv4 gebunden werden soll
(Standard='0.0.0.0'). Wir hier 'none' angegeben, so wird kein IPv4-Socket
gebunden. Wird der Standardwert geändert, so muß evtl. der erste Eintrag
im Abschnitt Localhost auch passend geändert werden.
bind-ipv6 bind-ipv6 = (hostname) | (ip-address) | none
Geben Sie den Hostnamen oder die IP-Adresse, an die der HTTP-Proxy und der
WWWOFFLE-Steuerungs-Port unter Verwendung von IPv6 gebunden werden
soll (Standard='::'). Wird hier 'none' angegeben, so wird kein
IPv6-Socket gebunden. Diese Option benötigt die IPv6-Option beim
compilieren. Wird der Standardwert geändert, so muß evtl. der erste
Eintrag im Abschnit Localhost auch passend geändert werden.
http-port = (port)
Geben Sie eine Integer-Zahl für die Port-Nummer für den HTTP-Proxy an
(Standard:8080). Dies ist die Port-Nummer, die auch im Browser angegeben
werden muss, um eine Verbindung zum WWWOFFLE-Proxy zu bekommen.
wwwoffle-port = (port)
Eine Integer-Zahl, die die Port-Nummer, die für die
WWWOFFLE-Steuerungs-Verbindungen verwendet wird festlegt (Standard:8081)
spool-dir = (dir)
Der komplette Pfadname des Top-Level-Cache-Verzeichnisses (Spool-Verzeichnis)
(Standard:/var/spool/wwwoffle oder wasimmer verwendet wurde, als das
Programm compiliert wurde).
run-uid = (user) | (uid) Der
Benutzername oder die numerische UID, auf die gewechselt werden soll,
wenn der Server gestartet wird (Standard:keine). Diese Option ist
nicht für die Win32-Version anwendbar und funktioniert nur, wenn der
Server unter UNIX als root gestartet wurde.
run-gid = (group) | (gid)
Der Gruppenname oder die numerische GID, auf die gewechselt werden soll,
wenn der Server gestartet wird (Standard:keine). Diese Option ist nicht
für die Win32-Version anwendbar und funktioniert nur, wenn der Server
unter UNIX als root gestartet wurde.
use-syslog = yes | no Legt
fest, ob der Server von Syslog für Meldungen Gebrauch machen soll (yes)
oder nicht (no) (Standard:yes)
password = (word)
Das Passwort, das zur Authentifizierung für die Steuerungs-Seiten, für
das Löschen gespeicherter Seiten usw. benötigt wird (Standard:keins).
Damit dieses Passwort in der Konfigurations-Datei sicher ist, müssen die
Zugriffsrechte der Datei so eingestellt werden, dass nur authorisierte
Benutzer sie lesen können.
max-servers = (integer)
Die maximale Anzahl der Server-Prozesse, die bei Online und
automatischen Abrufen gestartet werden (Standard:8)
max-fetch-servers = (integer)
Die maximale Anzahl der Server-Prozesse, die bei Start des Abrufs der
im Offline-Modus markierten Seiten gestartet werden (Standard:4)
Dieser Wert muß kleiner als die max.Anzahl der Server sein, oder Sie
sind nicht Lage WWWOFFLE während des Abrufs interaktiv zu nutzen.
Options
Optionen, die steuern, wie das Programm arbeitet
log-level = debug | info | important | warning | fatal
Der minimale Log-Level für Meldungen in Syslog oder stderr
(Standard:important)
socket-timeout = (time)
Die Zeit in Sekunden, die WWWOFFLE maximal auf Daten von einer
Verbindung wartet, bevor der Vorgang aufgegeben wird (Standard:120)
dns-timeout = (time)
Die Zeit in Sekunden, die WWWOFFLE auf die Auflösung eines Hostnamens
(DNS=Domain Name Service) wartet, bevor der Vorgang aufgegeben wird
(Standard:60)
connect-timeout = (time)
Die Zeit in Sekunden, die WWWOFFLE auf den Verbindungsaufbau
wartet, bevor der Vorgang aufgegeben wird (Standard=30)
connect-retry = yes | no
Falls die Verbindung zu einem entfernten Server nicht hergestellt
werden kann, soll WWWOFFLE es nach einer kurzen Pause erneut versuchen
(Standard=no - also nein)
ssl-allow-port = (integer)
Eine Port-Nummer über die verschlüsselte Secure Socket Layer
(SSL)-Verbindungen, also https über den Proxy laufen dürfen.
Diese Options sollte auf 443 gesetzt werden, um https zu erlauben,
es darf mehr als einen ssl-port-Eintag geben, wenn andere Ports
benötigt werden.
dir-perm = (octal int)
Die Verzeichnis-Zugriffsrechte, die beim Erstellen von
Spool-Verzeichnissen verwendet werden (Standard: 0755). Diese Option
übergeht die umask-Einstellungen des Benutzers und muss als Oktal-Wert
beginnend mit '0' angegeben werden.
file-perm = (octal int)
Die Datei-Zugriffsrechte, die beim Erstellen von Spool-Files verwendet
werden (Standard: 0644). Diese Option übergeht die umask-Einstellungen
des Benutzers und muss als Oktal-Wert beginnen mit '0' angegeben werden.
run-online = (filename)
Der Name eines Programms, das gestartet werden soll, wenn WWWOFFLE in
den Online-Modus geschaltet wird (Standard:keins). Das Programm wird
mit einem einzigen Parameter gestartet, dem aktuellen Modus-Namen
"online".
run-offline = (filename)
Der Name eines Programms, das gestartet werden soll, wenn WWWOFFLE in
den Offline-Modus geschaltet wird (Standard:keins). Das Programm wird
mit einem einzigen Parameter gestartet, dem aktuellen
Modus-Namen "offline".
run-autodial = (filename)
Der Name eines Programms, das gestartet werden soll, wenn WWWOFFLE in
den Autodial-Modus geschaltet wird (Standard:keins). Das Programm wird
mit einem einzigen Parameter gestartet, dem aktuellen Modus-Namen
"autodial".
run-fetch = (filename)
Der Name eines Programms, das gestartet werden soll wenn WWWOFFLE mit
dem Abruf von Bestellungen beginnt oder beendet. Das Programm wird mit
zwei Parametern gestartet, der erste ist das Wort "fetch" und der zweite
ist "start" oder "stop".
lock-files = yes | no
Schalter zur Verwendung eines Lock-Files, um zu verhindern, dass mehr
als ein WWWOFFLE-Prozess die gleiche URL zur gleichen Zeit abruft
(Standard=no - kein Lockfile)
reply-compressed-data = yes | no
Ob die Antworten die an den Browser gegeben werden, auf Anfrage
komprimierte Daten enthalten sollen (Standard:no = Nein). Benötigt die
zlib-Option beim Compilieren.
exec-cgi = (pathname)
Schaltet die Verwendung von CGI-Scripts für die lokalen Seiten auf dem
WWWOFFLE-Server, die der angegeben Pfad-Wildcard entsprechen
(Standard:keine)
OnlineOptions
Optionen, die das Verhalten von WWWOFFLE im Online-Modus steueren
[<URL-SPEC>] request-changed = (time)
Im Online-Modus werden Seiten nur dann wirklich aus dem Netz geholt,
wenn die Version im Cache älter als die angegebene Zeit in Sekunden ist
(Standard=600). Wird dieser Wert auf einen negativen Wert gesetzt,
zeigt dies an, dass die Seiten im Cache immer im Online-Modus verwendet
werden. Längere Zeitangaben können durch Verwendung von 'm' (Minuten),
'h' (Stunden),'d' (Tage),'w' (Wochen) angegeben werden (z.B. 10m=600).
[<URL-SPEC>] request-changed-once = yes | no
Im Online-Modus werden Seiten nur dann wirklich aus dem Netz geholt,
wenn die Version im Cache nicht schon einmal in der gleichen
Online-Sitzung abgerufen wurde. (Standard=yes - Ja). Diese Option hat
gegenüber der request-changed-Option Vorrang.
[<URL-SPEC>] request-expired = yes | no
Im Online-Modus werden abgelaufene Seiten immer nochmal abgerufen
(Standard=no - nein). Diese Option hat gegenüber der
request-changed-Option und der request-changed-once-Option Vorrang.
[<URL-SPEC>] request-no-cache = yes | no
Im Online-Modus werden Seiten die nicht im Cache gespeichert werden
sollen immer neu abgerufen (Standard=no - nein). Diese Option hat
gegenüber den request-changed- und reqest-changed-once-Optionen
Vorrang.
[<URL-SPEC>] request-redirection = yes | no
Im Online-Modus werden Seiten die den Browser zeitweilig auf eine
andere URL umleiten neu abgerufen (Standard=no - nein).
Diese Option hat gegenüber den request-changed- und
reqest-changed-once-Optionen Vorrang.
[<URL-SPEC>] try-without-password = yes | no
Wird eine Seite die einen Usernamen und ein Passwort enthält abgerufen,
dann wird ein Abruf der gleichen Seite ohne angegebenen Usernamen
und Passwort durchgeführt. (Standard=yes - Ja). Dies erlaubt es für
Anfragen nach der Seite ohne ein Passwort den Browser auf die Seiten
mit Passwort umzuleiten.
[<URL-SPEC>] intr-download-keep = yes | no
Wenn im Online-Modus der Browser die Verbindung schliesst, soll die
gerade heruntergeladene, unvollständige Seite erhalten bleiben.
(Standard: no - nein)
[<URL-SPEC>] intr-download-size = (integer)
Wenn im Online-Modus der Browser die Verbindung schliesst, wird die
Seite weitergeladen, wenn sie kleiner als die angegebene Grösse in
kByte ist.(Standard=1).
[<URL-SPEC>] intr-download-percent = (integer)
Wenn im Online-Modus der Browser die Verbindung schliesst, wird die
Seite weitergeladen, wenn sie zu mehr als dieser Prozentangabe
bereits vollständig ist (Standard=80)
[<URL-SPEC>] timeout-download-keep = yes | no
Wenn die Server-Verbindung während eines Lesezugriffs zu lange
keine Daten sendet (timeout), soll die gerade heruntergeladene,
unvollständige Seite erhalten bleiben (Standard=no - nein).
[<URL-SPEC>] request-compressed-data = yes | no
Ob die Anfragen, die an die Server geschickt werden, komprimierte Daten
anfordern solllen (Standard=yes - ja). Benötigt die zlib-Option beim
Compilieren.
OfflineOptions
Optionen, die das Verhalten von WWWOFFLE im Offline-Modus steuern
[<URL-SPEC>] pragma-no-cache = yes | no
Ob eine neue Kopie der Seite abgerufen werden soll, wenn der Browser
in der Anfrage 'Pragma: no-cache' gesetzt hat (Standard=yes - Ja).
Diese Option sollte auf 'no' (Nein) gesetzt werden, wenn beim
Offline-Browsen alle Seiten von einem "fehlerhaften" Browser neu
angefragt werden.
[<URL-SPEC>] confirm-requests = yes | no
Ob im Offline-Modus jeweils eine Seite erscheint, die um Benutzer-
Bestätigung bittet, anstatt automatisch Bestellungen zu speichern.
(Standard=no - nein)
[<URL-SPEC>] dont-request = yes | no
Seiten die dieser URL-Spezifikation entsprechen im Offline-Modus
nicht abrufen. (Standard=keine)
FetchOptions
Optionen die steuern, was beim Abruf offline bestellter Seiten
heruntergeladen wird.
[<URL-SPEC>] stylesheets = yes | no
Ob Style-Sheets abgerufen werden sollen (Standard=no - nein)
[<URL-SPEC>] images = yes | no
Ob Bilder abgerufen werden sollen (Standard=no - nein)
[<URL-SPEC>] webbug-images = yes | no
Ob Bilder, die nur 1x1 -Pixel groß sind, auch abgerufen werden sollen,
benötigt auch die Auswahl der images-Option. (Standard=yes - ja).
Diese Option ist zur Verwendung in Verbindung mit der
replace-webbug-images-Option im ModfiyHTML-Abschnitt gedacht.
[<URL-SPEC>] frames = yes | no
Ob Frames abgerufen werden sollen (Standard=no - nein)
[<URL-SPEC>] scripts = yes | no
Ob Scripte (z.B. Javascript) abgerufen werden sollen
(Standard=no - nein)
[<URL-SPEC>] objects = yes | no
Ob Objekte (z.B. Java class files) abgerufen werden sollen
(Standard=no - nein)
IndexOptions
Option die steuern, was in den Seiten-Verzeichnissen angezeigt wird.
no-lasttime-index = yes | no
Deaktiviert die Erstellung von Verzeichnissen der letzten/vorherigen
Online-Sitzung (Standard=no - nein)
cycle-indexes-daily = yes | no
Zyklus für die Zählung letzte/vorherige Onlinesitzungen-Verzeichnisse
wechselt nur täglich anstatt mit jeder Online-Situng oder jedem Abruf
(Standard=no).
<URL-SPEC> list-outgoing = yes | no
Wählt, ob die URL im Verzeichnis der Bestellung aufgeführt werden soll
(Standard=yes - ja)
<URL-SPEC> list-latest = yes | no
Wählt, ob die URL im Verzeichnis der letzten/vorherigen Onlinesitzung
und der letzten/vorherigen Bestellungen aufgeführt werden soll.
(Standard=yes - ja)
<URL-SPEC> list-monitor = yes | no
Wählt, ob die URL im Verzeichniss der abonnierten URLs aufgeführt
werden soll (Standard=yes - ja)
<URL-SPEC> list-host = yes | no
Wählt, ob die URL im Verzeichnis der Hosts aufgeführt werden soll
(Standard=yes - ja)
<URL-SPEC> list-any = yes | no
Wählt, ob die URL in irgendeinem der Verzeichnisse aufgeführt werden
soll (Standard=yes)
ModifyHTML
Optionen die steuern, in welcher Weise der HTML-Code, der im Cache
gespeichert ist, verändert wird.
<URL-SPEC> enable-modify-html = yes | no
Aktivieren der HTML-Veränderungen dieses Abschnitts (Standard=no -nein).
Ist diese Option nicht aktiviert, haben die folgenden HTML-Optionen
keinerlei Effekt. Ist diese Option aktiviert, ist WWWOFFLE ein
bißchen langsamer.
[<URL-SPEC>] enable-modify-online = yes | no
Aktivieren der Veränderungen dieses Abschnitts auch im Online-Modus so
wie im Offline-Modus (Standard=no - nein). Dies verursacht, dass die
HTML-Seite oder die GIF-Datei nicht im Browser erscheint, bevor
WWWOFFLE nicht alles abgearbeitet hat. Dies trifft nicht auf Seiten zu,
die nicht im Cache gespeichert werden.
[<URL-SPEC>] add-cache-info = yes | no
Am unteren Ende aller übertragenen Seiten wird das Datum, an dem die
Seite im Cache gespeichert wurde und einige Navigations-Elemente
hinzugefügt (Standard=nein).
[<URL-SPEC>] anchor-cached-begin = (HTML code) |
Links in der übertragenen Seite, die im Cache gespeichert sind,
erhalten den angegebenen HTML-Code vorangestellt. (Standard="").
[<URL-SPEC>] anchor-cached-end = (HTML code) |
Links in der übertragenen Seite, die im Cache gespeichert sind,
erhalten den angegebenen HTML-Code angehängt. (Standard="").
[<URL-SPEC>] anchor-requested-begin = (HTML code) |
Links in der übertragenen Seite, die bereits zum Download bestellt
sind, erhalten den angegebenen HTML-Code vorangestellt (Standard="").
[<URL-SPEC>] anchor-requested-end = (HTML code) |
Links in der übertragenen Seite, die bereits zum Download bestellt
sind, erhalten den angegebenen HTML-Code angehängt (Standard="").
[<URL-SPEC>] anchor-not-cached-begin = (HTML code) |
Links in der übertragenen Seite, die nicht im Cache gespeichert oder
bestellt sind, erhalten den angegebenen HTML-Code vorangestellt
(Standard="").
[<URL-SPEC>] anchor-not-cached-end = (HTML code) |
Links in der übertragenen Seite, die nicht im Cache gespeichert oder
bestellt sind, erhalten den angegebenen HTML-Code angehängt
(Standard="").
[<URL-SPEC>] disable-script = yes | no
Entfernt alle Skripte (Standard=no - nein)
[<URL-SPEC>] disable-applet = yes | no
Entfernt alle Java-Applets (Standard=no - nein)
[<URL-SPEC>] disable-style = yes | no
Entfernt alle Style-Sheets und Style-Verweise (Standard=no - nein)
[<URL-SPEC>] disable-blink = yes | no
Entfernt den <blink>-tag (Standard=no - nein).
[<URL-SPEC>] disable-flash = yes | no
Entfernt Shockwave-Flash-Animationen (Standard=no - nein).
[<URL-SPEC>] disable-meta-refresh = yes | no
Entfernt alle Meta-Tags im HTML-Header, die den Browser nach einer
Zeit auf eine andere Seite umleiten. (Standard=no - nein).
[<URL-SPEC>] disable-meta-refresh-self = yes | no
Entfernt alle Meta-Tags im HTML-Header, die den Browser nach einer
Zeit dazu veranlassen, die gleiche Seite erneut zu laden
(Standard=no - nein).
[<URL-SPEC>] disable-dontget-links = yes | no
Deaktiviert alle Links auf URLS, die im DontGet-Abschnitt der
Konfigurations-Datei aufgeführt sind (Standard=no - nein).
[<URL-SPEC>] disable-dontget-iframes = yes | no
Deaktivert Inline-Frames-(iframe)-URLs, die im DontGet-Abschnitt der
Konfigurations-Datei aufgeführt sind (Standard=no - nein).
[<URL-SPEC>] replace-dontget-images = yes | no
Ersetzt Bild-URLs, die im DontGet-Abschnitt der Konfigurations-Datei
aufgeführt werden mit eine statischen URL (Standard=no - nein)
[<URL-SPEC>] replacement-dontget-image = (URL)
Die Ersatz-Bild-Datei zur Verwendung für URLs, die im DontGet-Abschnitt
der Konfigurations-Datei aufgeführt sind.
(Standard=/local/dontget/replacement.gif).
[<URL-SPEC>] replace-webbug-images = yes | no
Ersetzt die URLs, die ein 1x1-Pixel-Bild enthalten durch eine statische
URL (Standard=no - nein). Diese Option ist gedacht zur Verwendung in
Verbindung mit der webbug-images-Option im FetchOptions-Abschnitt.
[<URL-SPEC>] replacement-webbug-image = (URL)
Die Ersatz-Bild-Datei zur Verwendung für Bilder, die ein 1x1-Pixel Bild
sind. (Standard=/local/dontget/replacement.gif).
[<URL-SPEC>] disable-animated-gif = yes | no
Deaktiviert die Animationen animierter GIF-Dateien (Standard=no - nein).
[<URL-SPEC>] demoronise-ms-chars = yes | no
Ersetzt einige merkwürdige Zeichen, die einige Microsoft-Anwendungen
in HTML-Code verwenden, mit Entsprechungen, die von den meisten Browsern
dargestellt werden können (Standard=no - nein). Die Idee hierzu kommt
von dem Public-Domain Demoroniser-perl Script.
LocalHost
Eine Liste der Hostnamen unter denen der Host, auf dem der WWWOFFLE-Server
läuft, bekannt ist. Diese Option existiert, damit der Proxy sich nicht selbst
kontaktieren muss, wenn die Anfrage einen anderen Namen für den selben Server
verwendet.
(host)
Ein Hostname oder eine IP-Adresse, die in Verbindung mit der
Port-Nummer (im Startup-Abschnitt) den WWWOFFLE-Proxy-HTTP-Server
angibt. Der Hostname muss exakt passen, es ist keine WILDCARD. Der
erste benannte Host wird als Server-Name für verschiedene Funktionen
verwendet, es muss sich daher um einen Namen handeln, der für jeden
Client-Host funktioniert. Keiner der hier benannten Hosts wird im
Cache gespeichert oder über einen Proxy abgerufen.
LocalNet
Eine Liste der Hostnamen deren Web-Server immer zugreifbar sind, auch im
Offline-Modus und die nicht im WWWOFFLE-Cache gespeichert werden sollen, da
sie im lokalen Netzwerk sind.
(host)
Ein Hostname oder eine IP-Adresse, die immer verfügbar ist und nicht
im WWWOFFLE-Cache gespeichert werden soll. Beim Hostname dürfen
WILDCARDs verwendet werden. Ein Host kann ausgeschlossen werden durch
Einfügen eines '!' an den Anfang des Namens, alle möglichen Aliases
und IP-Adressen für den Host müssen ebenfalls angegeben werden.
Zu allen hier eingetragenen Hosts wird angenommen, dass sie erreichbar
sind - auch im Offline-Modus. Keiner der hier genannten Hosts wird
im Cache gespeichert oder über ein Proxy abgerufen.
AllowedConnectHosts
Eine Liste der Client-Hostnamen, denen es erlaubt ist, zum WWWOFFLE-Server
Verbindungen aufzubauen.
(host)
Ein Hostname oder eine IP-Adresse, der es erlaubt ist, eine Verbindung
zum Server aufzubauen. Beim Hostnamen dürfen WILDCARDs verwendet werden.
Ein Host kann ausgeschlossen werden durch Einfügen eines '!' an den
Anfang des Namens, alle möglichen Aliases und IP-Adressen für den Host
müssen ebenfalls angegeben werden. Alle im Abschnitt LocalHost
genannten Hosts dürfen ebenfalls eine Verbindung herstellen.
AllowedConnectUsers
Eine Liste der User die eine Verbindung zum Server herstellen dürfen und ihre
Passwörter.
(username):(password)
Der Username und das Passwort der User, die eine Verbindung zum Server
herstellen dürfen. Is dieser Abschnitt leer, wird keine
User-Authentifizierung durchgeführt. Der Username und das Passwort
werden beide in unverschlüsselter Form gespeichert. Die Option setzt
die Verwendung eines Browser voraus, der den
HTTP/1.1-Proxy-Authentifizierungs-Standard verarbeitet.
DontCache
Eine Liste von URLs, die nicht im WWWOFFLE-Cache gespeichert werden sollen.
Speichere keine URLs die zur angegebenen URL-Spezifikation passen.
Die URL-SPECIFICATION kann umgekehrt werden um passende URLs im Cache
zu speichern (Angabe von '!'). Die URLs, die nicht im Cache gespeichert
werden sollen, werden auch nicht offline bestellt.
DontGet
Eine Liste von URLs, die nicht von WWWOFFLE abgerufen werden soll
(z.B. weil sie nur Müll-Werbung enthalten)
Hole keine URLs, die zur angegebenen URL-Spezifikation passen.
Die URL-SPECIFICATION kann umgekehrt werden, um die passenden URLs
zuzulassen (Angabe von '!')
[<URL-SPEC>] replacement = (URL)
Die URL die zum Ersetzen jeglicher URLs, die zur angegebenen
URL-SPECIFICATION passen, anstelle einer Standard-Fehler-Meldung
(Standard=keine). Die URLs in /local/dontget/ sind vorgeschlagene
Ersatzdateien (z.B. replacement.gif oder replacement.png,
die 1x1 pixel transparente Bilder sind, oder replacement.js,
welches eine leeres Javascript-Datei ist).
<URL-SPEC> get-recursive = yes | no
Wählt ob die hierzu passenden URLs beim rekursiven Abruf abgerufen
werden (Standard=yes - ja).
<URL-SPEC> location-error = yes | no
Wenn die Antwort auf eine URL einen 'Location'-Header enthält, der
auf eine URL umleitet, die nicht (weil in diesem Abschnitt aufgeführt)
abgerufen werden soll, wird die Antwort stattdessen in eine
Fehlermeldung gewandelt (standard=no - nein). Dies verhindert, dass
ISP-Proxies ihre Benutzer auf Werbeseiten umleiten, wenn diese
Werbe-URLs in diesem Abschnitt gelistet werden.
DontCompress
Eine Liste derMIME-Typen und Datei-Erweiterungen, die nicht von WWWOFFLE
komprimiert werden sollen (weil sie bereits komprimiert sind oder es nicht
wert sind komprimiert zu werden). Dies benötigt die zlib-Option beim
Compilieren.
mime-type = (mime-type)/(subtype)
Der MIME-Typ einer URL, die nicht im Cache oder beim Übertragen
komprimierter Seiten zum Browser komprimiert werden soll.
file-ext = .(file-ext)
Die Datei-Erweiterung einer URL, die nicht komprimiert vom Server
angefordert werden soll.
CensorHeader
Eine Liste der HTTP-Header-Zeilen, die von den Anfragen, die an die
Webserver gehen, entfernt werden sollen, sowie von den Antworten, die
von ihnen zurückkommen.
[<URL-SPEC>] (header) = yes | no | (string)
Ein Header-Feld-Name (z.B. From, Cookie, Set-Cookie, User-Agent) und
der String, mit dem dieser Header ersetzt werden soll
(Standard=keiner). Der Header berücksichtigt Gross-/Kleinschreibung
und hat kein ':' am Ende. Ein Wert von 'no' meint, der Header wird
nicht verändert, "yes" oder kein String kann verwendet werden, um
den Header zu entfernen oder ein String kann verwendet werden, um den
Header zu ersetzen. Dies ersetzt nur vorgefundene Header, es werden
keine neuen erzeugt. Eine Option für 'Referer' an dieser Stelle hat
Vorrang gegenüber den referer-self- und referer-self-dir-Optionen.
[<URL-SPEC>] referer-self = yes | no
Setzt den Referer-Header auf die gleiche URL, die angefordert wird
(Standard=no - nein). Diese Option fügt einen Referer-Header hinzu,
wenn in der Original-Anfrage keiner vorhanden ist.
[<URL-SPEC>] referer-self-dir = yes | no
Setzt den Referer-Header auf den Verzeichnisnamen der URL, die
angefordert wird (Standard=no - nein). Diese Option fügt einen
Referer-Header hinzu, wenn in der Original-Anfrage keiner vorhanden
ist. Die Option hat Vorrang gegegenüber der referer-self-Option.
FTPOptions
Optionen zur Verwendung beim Abruf von Dateien über das ftp-Protokoll.
anon-username = (string)
Der Username zur Verwendung für anonymen ftp-Zugriff
(Standard=anonymous).
anon-password = (string)
Das Passwort zur Verwendung für anonymen ftp-Zugriff
(Standard wird zur Laufzeit festgestellt). Bei Verwendung einer
Firewall kann dies einen Wert enthalten, der für den FTP-Server nicht
gültig ist und es muss möglicheweise ein anderer Wert gesetzt werden.
<URL-SPEC> auth-username = (string)
Der Username zu Verwendung auf einem Host anstelle des
Standard-Usernamen für anonyme Zugriffe.
<URL-SPEC> auth-password = (string)
Das Passwort zur Verwendung auf einem Host anstelle des
Standard-Passwort für anonyme Zugriffe.
MIMETypes
MIME-Typen zur Verwendung beim Liefern von Dateien, die nicht über HTTP
angefordert wurden oder für Dateien vom eingauten Web-Server.
default = (mime-type)/(subtype)
Der Standard-MIME-Typ (Standard=text/plain).
.(file-ext) = (mime-type)/(subtype)
Der MIME-Typ, der zu einer Dateierweiterung assoziiert werden soll.
Der '.' muss in der Dateierweiterung mitangegeben werden. Wenn mehr als
eine Erweiterung passt, wird die längste verwendet.
Proxy
Dieser Abschnitt beinhaltet die Namen der HTTP-Proxies (oder andere) zur
externen Verwendung für den WWWOFFLE-Server
[<URL-SPEC>] proxy = (host[:port])
Der Hostname und Port zur Verwendung als Proxy [für die angegebene
URL-Spezifikation]
<URL-SPEC> auth-username = (string)
Der Username zur Verwendung auf einem Proxy-Host zur Authentifizierung
von WWWOFFLE. Die URL-SPECIFICATION bezieht sich in diesem Fall auf
den Proxy und nicht die angeforderte URL.
<URL-SPEC> auth-password = (string)
Das Passwort zur Verwendung auf einem Proxy-Host zur Authentifizierung
von WWWOFFLE. Die URL-SPECIFICATION bezieht sich in diesem Fall auf
den Proxy und nicht die angeforderte URL.
[<URL-SPEC>] ssl = (host[:port])
Ein Proxy-Server der für Secure Socket Layer (SSL)-Verbindungen
verwendet werden soll (https). Beachten Sie bei der
URL-SPECIFICATION, dass nur der Host geprüft wird und die
anderen Teile '*'-WILDCARDs sein müssen.
Alias
Eine Liste von Alias-Namen, die verwendet werden, um Server-Namen und Pfade in
andere Server-Namen und Pfade zu ersetzen.
Jegliche Anfragen, die zur ersten URL-SPECIFICATION passen, werden durch
die zweite URL-SPECIFICATION ersetzt. Die erste URL-SPECIFICATION ist
eine Wildcard für Protokoll und Port, der Pfad muss exakt mit dem
Beginn der angefragten URL übereinstimmen und schliesst sämtliche
Unterverzeichnisse ein.
Purge
Die Methode zum Feststellen, welche Seiten beim Reinigen des Cache gelöscht
werden sollen, das voreingestellte maximale Alter, das Host-spezifische
maximale Alter der Seiten in Tagen und die maximale Cache-Grösse.
use-mtime = yes | no
Die zu verwendende Methode zur Entscheidung welche Dateien gelöscht
werden sollen, nach letzter Zugriffs-Zeit (atime) oder letzter
Änderung (modification time / mtime)
(Standard=no nein, nicht mtime verwenden)
max-size = (size)
Die maximale Grösse des Cache im MB nach dem Reinigen (purge)
(Standard=0). Eine maximale Cache-Grösse von 0 meint, es
gibt keine Grössenbeschränkung. Wird diese Option zusammen mit der
min-free-Option verwendet, wird die kleinere Cache-Grösse verwendet.
Diese Option berücksichtig die URLs, die nie gelöscht werden sollen,
beim Ermitteln der Cache-Grösse, aber löscht diese nicht.
min-free = (size)
Der minimale freie Disk-Speicherplatz in MB nach dem Reinigen
(Standard=0). Ein minimaler freier Speicherplatz von 0 meint, dass
es keine Mindestanforderungen für den freien Speicher gibt. Wird
diese Option zusammen mit der max-size-Option benutzt, wird die
kleinere Cache-Grösse verwendet. Diese Option berücksichtigt die URLs,
die nie gelöscht werden sollen, beim Ermitteln der Cache-Grösse aber
löscht diese nicht.
use-url = yes | no
Wenn auf 'yes' gesetzt, wird die URL zur Feststellung des
Lösch-Alters verwendet, andernfalls nur das Protokoll und der Host
(Standard=no - nur Protokoll und Host)
del-dontget = yes | no
Wenn auf 'yes' gesetzt, werden URLs die im DontGet-Abschnitt
aufgeführt werden gelöscht. (Standard=no)
del-dontcache = yes | no
Wenn auf 'yes' gesetzt, wedren URLs, die zu Einträgen im
DontCache-Abschnitt passen, gelöscht. (Standard=no)
Das maximale Alter in Tagen der im Cache gespeicherten Seiten
für URLs die zur angegebenen URL-Spezifikation passen (Standard=14).
Ein Alter von 0 meint beim reinigen immer löschen, ein negativer Wert
meint nie löschen. Die URL-SPECIFICATION wird nur auf Protokoll und
Host geprüft, ausser die use-url-Option ist auf 'yes' gesetzt. Längere
Zeiträume können durch 'w (Wochen)', 'm (Monate)' oder 'y (Jahre)'
angegeben werden (z.B. 2w=14).
[<URL-SPEC>] compress-age = (age)
Das maximale Alter im Cache gespeicherter URLs, die zur Spezifikation
passen, bevor sie komprimiert werden. Benötigt die zlib-Option beim
Compilieren. Das Alter, das angegeben wird, hat die gleiche Bedeutung
WILDCARD
Eine WILDCARD ist eine Spezifikation die das Zeichen '*' als Ersatz für eine
Gruppe von Zeichen verwendet. Das ist im Grunde das gleiche, wie bei einem
Kommando-Zeilen-Datei-Ausdruck in DOS oder der UNIX-Shell, außer das ein '*'
auch das Zeichen '/' beinhalten kann.
Zum Beispiel
*.gif passt auf foo.gif und bar.gif
*.foo.com passt auf www.foo.com und ftp.foo.com
/foo/* passt auf /foo/bar.html und /foo/bar/foobar.html
URL-SPECIFICATION
Bei der Angabe eines Hosts und eines Protokolls und eines Pfades kann in vielen
Abschnitten eine URL-SPECIFICATION verwendet werden, das ist ein Weg zur
Erkennung einer URL.
Für den Gebrauch in dieser Erklärung wird angenommen, eine URL besteht
aus fünf Teilen
proto Das verwendete Protokoll (z.B. 'http', 'ftp')
host Der Server-Hostname (z.B. 'www.gedanken.demon.co.uk').
port Die Portnummer auf diesem Host (z.B. der Standard 80 für HTTP).
path Der Pfadname auf dem Host (z.B. '/bar.html') oder ein
Verzeichnisname (z.B. '/foo/').
args mögliche Argumente zur URL für CGI-Scripts u.ä.
(z.B.'search=foo')
Zum Beispiel die WWWOFFLE-Homepage http://www.gedanken.demon.co.uk/wwwoffle/
Das Protokoll ist 'http', der Host ist 'www.gedanken.demon.co.uk',
die Portnummer ist der Standard-Port (in diesem Fall 80), und der Pfadname
ist '/wwwoffle/'. Im allgemeinen wird dies geschrieben als
(proto)://(host)[:(port)]/[(path)][?(args)]
Wobei [] eine mögliche Angabe anzeigt, und () einen vom Benutzer angebenen
Namen oder eine Nummer kennzeichnet.
Einige Beispiel-URL-SPECIFICATIONen folgen:
*://*/* Beliebiges Protokoll, beliebiger Host, beliebiger Port,
beliebiger Pfad, beliebiege Argumente
(Das ist das gleiche wie 'default').
*://*/(path) Beliebiges Protokoll, beliebiger Host, beliebiger Port,
benannter Pfad, beliebige Argumente
*://*/*? Beliebiges Protokoll, beliebiger Host, beliebiger Port,
beliebiger Pfad, KEINE Argumente
*://*/(path)?* Beliebiges Protokoll, beliebiger Host, beliebiger Port,
benannter Pfad, beliebige Argumente
*://(host) Beliebiges Protokoll, benannter Host, beliebiger Port,
beliebiger Pfad, beliebige Argumente
(proto)://*/* Benanntes Protokoll, beliebiger Host, beliebiger Pfad,
beliebige Argumente
(proto)://(host)/* Benanntes Protokoll, benannter Host, beliebiger Port,
beliebiger Pfad, beliebige Argumente
(proto)://(host):/* Benanntes Protokoll, benannter Host, Standard-Port,
beliebiger Pfad und beliebige Argumente
*://(host):(port)/* Beliebiges Protokoll, benannter Host, benannter Port,
beliebiger Pfad, beliebiger Argumente
Bei der Beschreibung des Hosts, des Pfads und der Argumente können WILDCARDs
verwendet werden, wie oben beschrieben.
In einigen Abschnitten die [25]URL-SPECIFICATIONen akzeptieren, können
diese umgekehrt werden durch Einfügen des Zeichens '!' vor der URL-SPEZIFIKATION.
Das meint, dass der Vergleich einer URL mit der URL-SPECIFICATION den logisch
umgekehrten Wert zurückgibt, gegenüber dem, was ohne das '!' zurückgegeben
werden würde. Wenn alle der URL-SPECIFICATIONen in einem Abschnitt negiert
werden und '*://*/*' wird am Ende hinzugefügt, dann wird der gesamte Sinn des
Abschnitts umgekehrt.