Proxy Auto-Configuration (PAC) Datei

url

Die abgerufene URL. Die Pfad- und Abfragekomponenten von https:// URLs werden entfernt. In Chrome (Versionen 52 bis 73) kann dies deaktiviert werden, indem PacHttpsUrlStrippingEnabled in den Richtlinien auf false gesetzt oder mit dem --unsafe-pac-url Befehlszeilenflag gestartet wird (ab Chrome 74 funktioniert nur noch das Flag und ab Version 75 gibt es keine Möglichkeit mehr, das Entfernen des Pfads zu deaktivieren; ab Chrome 81 gilt das Entfernen des Pfads nicht für HTTP-URLs, es wird jedoch erwogen, dieses Verhalten an HTTPS anzupassen); in Firefox ist die Option network.proxy.autoconfig_url.include_path.

host

Der aus der URL extrahierte Hostname. Dies ist nur zur Vereinfachung; es ist der gleiche String wie zwischen :// und dem ersten : oder / danach. Die Portnummer ist in diesem Parameter nicht enthalten, kann jedoch bei Bedarf aus der URL extrahiert werden.

Gibt einen String zurück, der die Konfiguration beschreibt. Das Format dieses Strings ist im Abschnitt Format des Rückgabewertes unten definiert.

• Die JavaScript-Funktion gibt einen einzelnen String zurück
• Ist der String null, sollen keine Proxys verwendet werden
• Der String kann eine beliebige Anzahl der folgenden Bausteine enthalten, die durch ein Semikolon getrennt sind:

DIRECT

Verbindungen sollten direkt hergestellt werden, ohne Proxys

PROXY host:port

Der angegebene Proxy sollte verwendet werden

SOCKS host:port

Der angegebene SOCKS-Server sollte verwendet werden

Neuere Versionen von Firefox unterstützen zusätzlich:

HTTP host:port

Der angegebene Proxy sollte verwendet werden

HTTPS host:port

Der angegebene HTTPS-Proxy sollte verwendet werden

SOCKS4 host:port, SOCKS5 host:port

Der angegebene SOCKS-Server (mit der angegebenen SOCKS-Version) sollte verwendet werden

Wenn es mehrere durch Semikolon getrennte Einstellungen gibt, wird die ganz links stehende Einstellung verwendet, bis Firefox die Verbindung zum Proxy nicht herstellen kann. In diesem Fall wird der nächste Wert verwendet usw.

Der Browser versucht automatisch nach 30 Minuten, einen zuvor nicht ansprechbaren Proxy erneut zu verwenden. Weitere Versuche beginnen nach einer Stunde und es werden immer 30 Minuten zur verstrichenen Zeit zwischen den Versuchen hinzugefügt.

Sind alle Proxys ausgefallen und es wurde keine DIRECT-Option angegeben, fragt der Browser, ob Proxys vorübergehend ignoriert und Direktverbindungen versucht werden sollen. Nach 20 Minuten fragt der Browser, ob die Proxys erneut versucht werden sollen, und fragt erneut nach 40 weiteren Minuten. Die Fragen gehen weiter und fügen immer 20 Minuten zur verstrichenen Zeit zwischen den Fragen hinzu.

Beispiele

PROXY w3proxy.netscape.com:8080; PROXY mozilla.netscape.com:8081

Der Hauptproxy ist w3proxy:8080; falls dieser ausfällt, wird mozilla:8081 verwendet, bis der Hauptproxy wieder verfügbar ist.

PROXY w3proxy.netscape.com:8080; PROXY mozilla.netscape.com:8081; DIRECT

Wie oben, aber falls beide Proxys ausfallen, werden automatisch Direktverbindungen hergestellt. (Im ersten Beispiel oben wird Netscape den Benutzer um Bestätigung bitten, ob Direktverbindungen hergestellt werden sollen; in diesem Fall ist keine Benutzereingabe erforderlich.)

PROXY w3proxy.netscape.com:8080; SOCKS socks:1080

SOCKS verwenden, wenn der Hauptproxy ausfällt.

Die Auto-Konfigurationsdatei sollte unter einer Datei mit der Endung .pac gespeichert werden: proxy.pac.

Und der MIME-Typ sollte auf application/x-ns-proxy-autoconfig gesetzt werden.

Als nächstes sollten Sie Ihren Server so konfigurieren, dass er die .pac-Dateierweiterung auf den MIME-Typ abbildet.

Diese Funktionen können zur Erstellung der PAC-Datei verwendet werden:

• Hostname-basierte Bedingungen

  • isPlainHostName()
  • dnsDomainIs()
  • localHostOrDomainIs()
  • isResolvable()
  • isInNet()

• Verwandte Dienstprogramme

  • dnsResolve()
  • convert_addr()
  • myIpAddress()
  • dnsDomainLevels()

• URL/Hostname basierte Bedingungen

  • shExpMatch()

• Zeitbasierte Bedingungen

  • weekdayRange()
  • dateRange()
  • timeRange()

• Protokollierungs-Dienstprogramm

  • alert()

• Es gab ein bereits definiertes assoziatives Array (Objekt), da zum Zeitpunkt JavaScript-Code es nicht selbst definieren konnte:

  • ProxyConfig.bindings Veraltet

Syntax

isPlainHostName(host)

Parameter

host

Der Hostname aus der URL (ohne Portnummer).

Beschreibung

Wahr, wenn und nur wenn kein Domänenname im Hostnamen vorhanden ist (keine Punkte).

Beispiele

isPlainHostName("www.mozilla.org"); // false
isPlainHostName("www"); // true

Syntax

dnsDomainIs(host, domain)

Parameter

host

Ist der Hostname aus der URL.

domain

Ist der Domänenname, gegen den der Hostname getestet wird.

Beschreibung

Gibt true zurück, wenn und nur wenn die Domäne des Hostnamens übereinstimmt.

Beispiele

dnsDomainIs("www.mozilla.org", ".mozilla.org") // true
dnsDomainIs("www", ".mozilla.org") // false

Syntax

localHostOrDomainIs(host, hostDom)

Parameter

host

Der Hostname aus der URL.

hostDom

Vollständig qualifizierter Hostname zum Abgleich.

Beschreibung

Ist true, wenn der Hostname genau mit dem angegebenen Hostname übereinstimmt, oder wenn im Hostnamen kein Domänenteil enthalten ist, der nicht qualifizierte Hostname jedoch übereinstimmt.

Beispiele

localHostOrDomainIs("www.mozilla.org", "www.mozilla.org") // true (exact match)
localHostOrDomainIs("www", "www.mozilla.org") // true (hostname match, domain not specified)
localHostOrDomainIs("www.google.com", "www.mozilla.org") // false (domain name mismatch)
localHostOrDomainIs("home.mozilla.org", "www.mozilla.org") // false (hostname mismatch)

Syntax

isResolvable(host)

Parameter

host

ist der Hostname aus der URL.

Versucht, den Hostnamen aufzulösen. Gibt true zurück, wenn er erfolgreich ist.

Beispiele

isResolvable("www.mozilla.org") // true

Syntax

isInNet(host, pattern, mask)

Parameter

host

ein DNS-Hostname oder eine IP-Adresse. Wird ein Hostname übergeben, wird er von dieser Funktion in eine IP-Adresse umgewandelt.

pattern

ein IP-Adresse-Muster im punktienten Format.

mask

Maske für das IP-Adresse-Muster, die angibt, welche Teile der IP-Adresse abgeglichen werden sollen. 0 bedeutet ignorieren, 255 bedeutet übereinstimmen.

Wahr, wenn und nur wenn die IP-Adresse des Hosts dem angegebenen IP-Adresse-Muster entspricht.

Die Angabe von Muster und Maske erfolgt auf die gleiche Weise wie bei der SOCKS-Konfiguration.

Beispiele

function alertEval(str) {
  alert(`${str} is ${eval(str)}`);
}
function FindProxyForURL(url, host) {
  alertEval('isInNet(host, "192.0.2.172", "255.255.255.255")');
  // "PAC-alert: isInNet(host, "192.0.2.172", "255.255.255.255") is true"
}

dnsResolve(host)

Parameter

host

Hostname zur Auflösung.

Löst den angegebenen DNS-Hostnamen in eine IP-Adresse auf und gibt diesen im punktierten Format als String zurück.

Beispiel

dnsResolve("www.mozilla.org"); // returns the string "104.16.41.2"

Syntax

convert_addr(ipaddr)

Parameter

ipaddr

Jede punktierte Adresse wie eine IP-Adresse oder Maske.

Verkettet die vier punktierten Bytes in ein 4-Byte-Wort und wandelt es in dezimal um.

Beispiel

convert_addr("192.0.2.172"); // returns the decimal number 1745889538

Syntax

myIpAddress()

Parameter

(keine)

Rückgabewert

Gibt die Server-IP-Adresse der Maschine zurück, auf der Firefox läuft, als String im punktierten Ganzzahlformat.

Beispiel

myIpAddress() //returns the string "127.0.1.1" if you were running Firefox on that localhost

Syntax

dnsDomainLevels(host)

Parameter

host

ist der Hostname aus der URL.

Gibt die Anzahl (Ganzzahl) der DNS-Domänenebenen (Anzahl der Punkte) im Hostnamen zurück.

Beispiele

dnsDomainLevels("www") // 0
dnsDomainLevels("mozilla.org") // 1
dnsDomainLevels("www.mozilla.org"); // 2

Syntax

shExpMatch(str, shExp)

Parameter

str

ist ein beliebiger String zum Vergleich (z.B. die URL oder der Hostname).

shExp

ist ein Shell-Ausdruck, gegen den verglichen werden soll.

Gibt true zurück, wenn der String mit dem angegebenen Shell-Glob-Ausdruck übereinstimmt.

Die Unterstützung für bestimmte Glob-Ausdrücke variiert zwischen den Browsern: * (übereinstimmen mit einer beliebigen Anzahl von Zeichen) und ? (übereinstimmen mit einem Zeichen) werden immer unterstützt, während [characters] und [^characters] zusätzlich von einigen Implementierungen (einschließlich Firefox) unterstützt werden.

Beispiele

shExpMatch("http://home.netscape.com/people/ari/index.html", "*/ari/*"); // returns true
shExpMatch("http://home.netscape.com/people/montulli/index.html", "*/ari/*"); // returns false

Syntax

weekdayRange(wd1, wd2, [gmt])

Parameter

wd1 und wd2

Einer der geordneten Wochentags-Strings: "SUN", "MON", "TUE", "WED", "THU", "FRI", "SAT"

gmt

Ist entweder der String "GMT" oder wird ausgelassen.

Nur der erste Parameter ist obligatorisch. Entweder der zweite, der dritte oder beide können weggelassen werden.

Wenn nur ein Parameter vorhanden ist, gibt die Funktion an dem Wochentag, den der Parameter darstellt, true zurück. Wird der String "GMT" als zweiter Parameter angegeben, werden die Zeiten als GMT-Zeiten erkannt. Andernfalls werden sie als Zeiten in der lokalen Zeitzone angenommen.

Sind sowohl wd1 als auch wd2 definiert, ist die Bedingung true, wenn der aktuelle Wochentag zwischen diesen beiden geordneten Wochentagen liegt. Grenzen sind einschließlich, aber die Grenzen sind geordnet. Wenn der "GMT"-Parameter angegeben ist, werden die Zeiten als GMT-Zeiten erkannt. Andernfalls wird die lokale Zeitzone verwendet.

Beispiele

weekdayRange("MON", "FRI") // returns true Monday through Friday (local timezone)
weekdayRange("MON", "FRI", "GMT") // returns true Monday through Friday (GMT timezone)
weekdayRange("SAT") // returns true on Saturdays local time
weekdayRange("SAT", "GMT") // returns true on Saturdays GMT time
weekdayRange("FRI", "MON") // returns true Friday and Monday only (note, the order does matter!)

Syntax

dateRange(<day> | <month> | <year>, [gmt])  // ambiguity is resolved by assuming year is greater than 31
dateRange(<day1>, <day2>, [gmt])
dateRange(<month1>, <month2>, [gmt])
dateRange(<year1>, <year2>, [gmt])
dateRange(<day1>, <month1>, <day2>, <month2>, [gmt])
dateRange(<month1>, <year1>, <month2>, <year2>, [gmt])
dateRange(<day1>, <month1>, <year1>, <day2>, <month2>, <year2>, [gmt])

Parameter

day

Ist der geordnete Tag des Monats zwischen 1 und 31 (als Ganzzahl).

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

month

Ist einer der geordneten Monats-Strings unten.

"JAN"|"FEB"|"MAR"|"APR"|"MAY"|"JUN"|"JUL"|"AUG"|"SEP"|"OCT"|"NOV"|"DEC"

year

Ist die geordnete vollständige Jahreszahl. Zum Beispiel 2016 (nicht 16).

gmt

Ist entweder der String "GMT", wodurch der Zeitvergleich in GMT-Zeitzone erfolgt, oder wird ausgelassen. Wenn nicht angegeben, werden Zeiten in der lokalen Zeitzone berücksichtigt.

Wenn nur ein einzelner Wert angegeben wird (aus jeder Kategorie: Tag, Monat, Jahr), gibt die Funktion nur an den Tagen, die dieser Angabe entsprechen, true zurück. Sind beide Werte angegeben, ist das Ergebnis zwischen diesen Zeiten einschließlich der Grenzen true, aber die Grenzen sind geordnet.

Beispiele

dateRange(1) // returns true on the first day of each month, local timezone
dateRange(1, "GMT") // returns true on the first day of each month, GMT timezone
dateRange(1, 15) // returns true on the first half of each month
dateRange(24, "DEC");// returns true on 24th of December each year
dateRange("JAN", "MAR"); // returns true on the first quarter of the year

dateRange(1, "JUN", 15, "AUG");
// returns true from June 1st until August 15th, each year
// (including June 1st and August 15th)

dateRange(1, "JUN", 1995, 15, "AUG", 1995);
// returns true from June 1st, 1995, until August 15th, same year

dateRange("OCT", 1995, "MAR", 1996);
// returns true from October 1995 until March 1996
// (including the entire month of October 1995 and March 1996)

dateRange(1995);
// returns true during the entire year of 1995

dateRange(1995, 1997);
// returns true from beginning of year 1995 until the end of year 1997

Syntax

// The full range of expansions is analogous to dateRange.
timeRange(<hour1>, <min1>, <sec1>, <hour2>, <min2>, <sec2>, [gmt])

Parameter

hour

Ist die Stunde von 0 bis 23. (0 ist Mitternacht, 23 ist 23 Uhr.)

min

Minuten von 0 bis 59.

sec

Sekunden von 0 bis 59.

gmt

Entweder der String "GMT" für die GMT-Zeitzone oder nicht spezifiziert, für die lokale Zeitzone.

Wenn nur ein einzelner Wert angegeben ist (aus jeder Kategorie: Stunde, Minute, Sekunde), gibt die Funktion nur zu Zeiten zurück, die dieser Angabe entsprechen, true zurück. Sind beide Werte angegeben, ist das Ergebnis zwischen diesen Zeiten einschließlich der Grenzen true, aber die Grenzen sind geordnet.

Beispiele

timerange(12); // returns true from noon to 1pm
timerange(12, 13) // returns true from noon to 1pm
timerange(12, "GMT") // returns true from noon to 1pm, in the GMT timezone
timerange(9, 17) // returns true from 9am to 5pm
timerange(8, 30, 17, 0) // returns true from 8:30am to 5:00pm
timerange(0, 0, 0, 0, 0, 30) // returns true between midnight and 30 seconds past midnight

Syntax

alert(message)

Parameter

message

Der zu protokollierende String

Protokolliert die Nachricht in der Browser-Konsole.

Beispiele

alert(`${host} = ${dnsResolve(host)}`) // logs the host name and its IP address
alert("Error: shouldn't reach this clause.") // log a simple message

Alle Hosts, die nicht vollständig qualifiziert sind oder die sich in der lokalen Domäne befinden, werden direkt verbunden. Alles andere wird durch w3proxy.mozilla.org:8080 geleitet. Fällt der Proxy aus, werden die Verbindungen automatisch direkt:

function FindProxyForURL(url, host) {
  if (isPlainHostName(host) || dnsDomainIs(host, ".mozilla.org")) {
    return "DIRECT";
  } else {
    return "PROXY w3proxy.mozilla.org:8080; DIRECT";
  }
}

Wenn es Hosts gibt (wie den Haupt-Webserver), die zur lokalen Domäne gehören, aber außerhalb der Firewall sind und nur über den Proxyserver erreichbar sind, können diese Ausnahmen mit der Funktion localHostOrDomainIs() behandelt werden:

function FindProxyForURL(url, host) {
  if (
    (isPlainHostName(host) || dnsDomainIs(host, ".mozilla.org")) &&
    !localHostOrDomainIs(host, "www.mozilla.org") &&
    !localHostOrDomainIs(host, "merchant.mozilla.org")
  ) {
    return "DIRECT";
  } else {
    return "PROXY w3proxy.mozilla.org:8080; DIRECT";
  }
}

Das obige Beispiel verwendet den Proxy für alles außer lokale Hosts in der mozilla.org-Domäne, mit der weiteren Ausnahme, dass die Hosts www.mozilla.org und merchant.mozilla.org durch den Proxy gehen.

Dieses Beispiel funktioniert in einer Umgebung, in der der interne DNS-Server so eingerichtet ist, dass er nur interne Hostnamen auflösen kann, und das Ziel ist, einen Proxy nur für Hosts zu verwenden, die nicht auflösbar sind:

function FindProxyForURL(url, host) {
  if (isResolvable(host)) {
    return "DIRECT";
  }
  return "PROXY proxy.mydomain.com:8080";
}

Oben muss bei jeder Abfrage DNS konsultiert werden; es kann intelligent mit anderen Regeln gruppiert werden, sodass DNS nur konsultiert wird, wenn andere Regeln keine Ergebnisse liefern:

function FindProxyForURL(url, host) {
  if (
    isPlainHostName(host) ||
    dnsDomainIs(host, ".mydomain.com") ||
    isResolvable(host)
  ) {
    return "DIRECT";
  }
  return "PROXY proxy.mydomain.com:8080";
}

In diesem Beispiel werden alle Hosts in einem bestimmten Subnetz direkt verbunden, andere über den Proxy:

function FindProxyForURL(url, host) {
  if (isInNet(host, "192.0.2.172", "255.255.0.0")) {
    return "DIRECT";
  }
  return "PROXY proxy.mydomain.com:8080";
}

Wieder kann die Nutzung des DNS-Servers oben minimiert werden, indem redundant Regeln am Anfang hinzugefügt werden:

function FindProxyForURL(url, host) {
  if (
    isPlainHostName(host) ||
    dnsDomainIs(host, ".mydomain.com") ||
    isInNet(host, "192.0.2.0", "255.255.0.0")
  ) {
    return "DIRECT";
  } else {
    return "PROXY proxy.mydomain.com:8080";
  }
}

Dieses Beispiel ist komplexer. Es gibt vier (4) Proxy-Server; einer davon ist ein Hot-Standby für alle anderen, sodass, wenn einer der verbleibenden drei ausfällt, der vierte die Kontrolle übernimmt. Darüber hinaus teilen die verbleibenden drei Proxy-Server die Last basierend auf URL-Mustern, was ihr Caching effektiver macht (es gibt nur eine Kopie eines Dokuments auf den drei Servern - im Gegensatz zu einer Kopie auf jedem von ihnen). Die Last wird wie folgt verteilt:

Alle lokalen Zugriffe sollen direkt erfolgen. Alle Proxy-Server laufen auf Port 8080 (das müssen sie nicht, Sie können einfach Ihren Port ändern, denken Sie jedoch daran, Ihre Konfigurationen auf beiden Seiten anzupassen). Beachten Sie, wie Strings im JavaScript mit dem + Operator verkettet werden können.

function FindProxyForURL(url, host) {
  if (isPlainHostName(host) || dnsDomainIs(host, ".mydomain.com")) {
    return "DIRECT";
  } else if (shExpMatch(host, "*.com")) {
    return "PROXY proxy1.mydomain.com:8080; PROXY proxy4.mydomain.com:8080";
  } else if (shExpMatch(host, "*.edu")) {
    return "PROXY proxy2.mydomain.com:8080; PROXY proxy4.mydomain.com:8080";
  } else {
    return "PROXY proxy3.mydomain.com:8080; PROXY proxy4.mydomain.com:8080";
  }
}

Der größte Teil der Standard-JavaScript-Funktionalität kann in der FindProxyForURL() Funktion verwendet werden. Um zum Beispiel unterschiedliche Proxys basierend auf dem Protokoll festzulegen, kann die Funktion startsWith() verwendet werden:

function FindProxyForURL(url, host) {
  if (url.startsWith("http:")) {
    return "PROXY http-proxy.mydomain.com:8080";
  } else if (url.startsWith("ftp:")) {
    return "PROXY ftp-proxy.mydomain.com:8080";
  } else if (url.startsWith("gopher:")) {
    return "PROXY gopher-proxy.mydomain.com:8080";
  } else if (url.startsWith("https:") || url.startsWith("snews:")) {
    return "PROXY security-proxy.mydomain.com:8080";
  }
  return "DIRECT";
}

Zum Beispiel:

if (shExpMatch(url, "http:*")) {
  return "PROXY http-proxy.mydomain.com:8080";
}

Proxy autoconfig wurde in den späten 1990ern mit Netscape Navigator 2.0 eingeführt, gleichzeitig mit der Einführung von JavaScript. Die Open-Source-Freigabe von Netscape führte schließlich zu Firefox selbst.

Die "originalste" Implementierung von PAC und seinen JavaScript-Bibliotheken ist daher nsProxyAutoConfig.js, wie in frühen Versionen von Firefox zu finden. Diese Dienstprogramme sind in vielen anderen Open-Source-Systemen zu finden, einschließlich Chromium. Später integrierte Firefox die Datei in ProxyAutoConfig.cpp als C++ Stringliteral. Um es in eine eigene Datei zu extrahieren, reicht es aus, das Stück in JavaScript mit einer console.log-Anweisung zu übertragen, um es auszugeben.

Microsoft hat im Allgemeinen seine eigene Implementierung entwickelt. Es gab einige Probleme mit ihren Bibliotheken, aber die meisten sind inzwischen gelöst. Sie haben einige neue Funktionen mit "Ex"-Suffixen rund um die Adressbearbeitungsteile definiert, um IPv6 zu unterstützen. Das Feature wird von Chromium unterstützt, aber noch nicht von Firefox (bugzilla #558253).