PAC (Proxy auto-config) szintaxis
Ha hibát talál a dokumentációban, vagy javaslata van, írjon a Mudfish fórumára (https://forums.mudfish.net). A példák és leírások az alábbi oldalak fordítására vagy tartalmára támaszkodnak:
A Mudfish böngészőbővítménye támogatja a PAC (Proxy auto-config) fájlformátumot.
PAC-függvények
A PAC-ot támogató böngészők általában a Netscape által meghatározott szabványos formátum függvényeit támogatják. Ezek jellemzően szigorúan korlátozott sandboxban futnak; például a User Agent adatainak lekérdezése nem megengedett. Az alábbiak a sandboxban engedélyezett függvények.
A kódpéldák eredeti megjegyzéseit megtartottuk; jelentésüket a magyar magyarázatok ismertetik.
dnsDomainIs
Ellenőrzi a gépnevet, és egyezés esetén true értéket ad. Általában egyedi gépnevek kivételként kezelésére szolgál.
A példa: Ha a gépnév google.com vagy annak aldomainje (például maps.google.com, www.google.com), a böngésző proxy nélkül, közvetlenül kapcsolódik.
// 만약 hostname 이 google.com 과 같거나 하위 주소들이 매치된다면
// (예를 들어 maps.google.com, www.google.com),
// 브라우저로 하여금 proxy 을 거치지 않고 직접 접속하게 합니다.
if (dnsDomainIs(host, "google.com"))
return "DIRECT";
shExpMatch
A gépnevet vagy URL-t shellmintával hasonlítja össze; egyezéskor true értéket ad.
A példa: A .local végű gépnevekhez közvetlen kapcsolatot használ. A második példa a vpn.domain.com gépet és a http://abcdomain.com/folder/ alatti összes fájlt és mappát éri el proxy nélkül.
// 모든 request 들 (.local 로 끝나는 모든 hostname 에 해당) 이
// 브라우저로 하여금 proxy 을 거치지 않고 직접 접속하게 합니다.
if (shExpMatch(url, "*.local"))
return "DIRECT";
// vpn.domain.com 에 접속할려고 하거나
// http://abcdomain.com/folder/ 하위의 모든 폴더 혹은 파일에 접속하는
// 요청들을 proxy 경유없이 직접 접속합니다.
if (shExpMatch(host, "vpn.domain.com") ||
shExpMatch(url, "http://abcdomain.com/folder/*"))
return "DIRECT";
isInNet
Ellenőrzi, hogy a gépnévhez tartozó IP-cím egy megadott alhálózatba esik-e; ha igen, true értéket ad. Gépnév argumentumnál DNS-feloldással alakítja IP-címmé.
A példa: Ha a DNS-feloldás után kapott IP-cím a megadott tartományban van, közvetlenül kapcsolódik.
// 만약 요청한 hostname 의 IP 주소가 (DNS resolving 후) 인자로 넘겨진
// IP 대역에 포함되는 것이면 직접 접속합니다.
if (isInNet(dnsResolve(host), "172.16.0.0", "255.240.0.0"))
return "DIRECT";
myIpAddress
Visszaadja a saját számítógép IP-címét.
A példa: Ha a számítógép a megadott IP-tartományba tartozik, a 10.10.5.1 proxy 8080 portján keresztül küldi a kérést.
// 만약 나의 컴퓨터가 특정 IP 대역에 속할 경우 proxy 10.10.5.1 (포트는 8080)
// 를 통해 요청하도록 합니다.
if (isInNet(myIpAddress(), "10.10.1.0", "255.255.255.0"))
return "PROXY 10.10.5.1:8080";
dnsResolve
DNS-feloldással IP-címmé alakít egy gépnevet.
A példa: Ha a kért gép IP-címe valamelyik felsorolt tartományba esik, közvetlenül kapcsolódik.
// 만약 요청한 host 의 IP 가 지정한 범위에 속할 경우 직접 접속하도록
// 합니다.
if (isInNet(dnsResolve(host), "10.0.0.0", "255.0.0.0") ||
isInNet(dnsResolve(host), "172.16.0.0", "255.240.0.0") ||
isInNet(dnsResolve(host), "192.168.0.0", "255.255.0.0") ||
isInNet(dnsResolve(host), "127.0.0.0", "255.255.255.0"))
return "DIRECT";
isPlainHostName
True értéket ad, ha a gépnév nem tartalmaz pontot. Például a http://intranet ilyen cím; belső hálózati webhelyekhez használható.
A példa: Egyszerű gépnév, például http://intranet/ vagy http://webserver-name01/ kérésekor közvetlenül kapcsolódik.
// 만약 사용자가 plain hostname (예를 들면, http://intranet/ 혹은
// http://webserver-name01/) 를 요청할 경우, 직접 접속하도록 합니다.
if (isPlainHostName(host))
return "DIRECT";
localHostOrDomainIs
Ellenőrzi a gépnevet, és a gépnévrész egyezésekor true értéket ad.
A példa: A www vagy www.google.com gépnév kérésekor közvetlenül kapcsolódik.
// 만약 요청한 hostname 이 "www" 혹은 "www.google.com" 일 경우, 직접
// 접속합니다.
if (localHostOrDomainIs(host, "www.google.com"))
return "DIRECT";
isResolvable
Megpróbálja a gépnevet IP-címre feloldani, és siker esetén true értéket ad.
Sikertelen névfeloldáskor a böngésző rövid időre lefagyhat vagy megállhat. Körültekintően használja.
A példa: Ha a DNS-szerver fel tudja oldani a kért gépnevet, a proxy1.example.com proxyt használja.
// 만약 요청한 hostname 이 DNS 서버로 부터 resolving 이 될 수 있다면,
// proxy1.example.com 프록시를 통해 요청합니다.
if (isResolvable(host))
return "PROXY proxy1.example.com:8080";
dnsDomainLevels
Megadja, hány pont van a gépnévben. Például belső webszerverek kivételként kezelésére használható.
A példa: Ha a gépnév legalább egy pontot tartalmaz, a proxy1.example.com proxyt használja, különben közvetlenül kapcsolódik.
// 만약 hostname 이 . (dot) 을 하나라도 포함하고 있으면 proxy1.example.com
// 프록시를 통해 접속하고 그렇지 않으면 직접 접속합니다.
if (dnsDomainLevels(host) > 0)
return "PROXY proxy1.example.com:8080";
else
return "DIRECT";
weekdayRange
Időalapú szabályokhoz használható, például ha csak bizonyos napokon szeretne proxybeállítást visszaadni.
A példa: Hétfőtől péntekig a proxy1.example.com proxyt használja, máskor közvetlenül éri el az internetet.
// 만약 월요일부터 금요일 사이에는 proxy1.example.com 프록시를 사용하도록
// 하고 그렇지 않을 경우는 직접 인터넷에 접속하도록 합니다.
if (weekdayRange("MON", "FRI"))
return "PROXY proxy1.example.com:8080";
else
return "DIRECT";
dateRange
Időalapú szabályokhoz használható, például csak meghatározott hónapokban alkalmazott proxyhoz.
A példa: Januártól márciusig a proxy1.example.com proxyt használja, máskor közvetlenül kapcsolódik.
// 만약 1월부터 3월까지는 proxy1.example.com 프록시를 사용하도록 설정하고
// 그렇지 않을 경우는 직접 접속하도록 조치합니다.
if (dateRange("JAN", "MAR"))
return "PROXY proxy1.example.com:8080";
else
return "DIRECT";
timeRange
Meghatározott napszakokra korlátozhatja a proxy használatát.
A példa: Csak reggel 8 és este 18 óra között használja a proxy1.example.com proxyt, máskor közvetlenül kapcsolódik.
// 오직 아침 8 시부터 오후 6 시까지만 proxy1.example.com 을 사용하도록
// 하고 그렇지 않을 경우는 직접 접속합니다.
if (timeRange(8, 18))
return "PROXY proxy1.example.com:8080";
else
return "DIRECT";
alert
A PAC eredeti meghatározásában nem szerepelt, de az Internet Explorer és a Firefox hibakereséshez biztosítja.
A példa: Kiírja a DNS-feloldás eredményét a böngésző hibakonzoljára.
// 브라우저의 error 콘솔창에 DNS resolving 한 결과를 출력하도록 합니다.
resolved_host = dnsResolve(host);
alert(resolved_host);