Składnia PAC (Proxy auto-config)
Jeśli znajdziesz błąd w dokumentacji lub masz sugestie, zostaw wiadomość na forum Mudfish (https://forums.mudfish.net). Przykłady i opisy poniżej przygotowano na podstawie tłumaczeń lub informacji z następujących stron:
Rozszerzenie przeglądarkowe Mudfish obsługuje format plików PAC (Proxy auto-config).
Funkcje PAC
Przeglądarki obsługujące PAC zwykle udostępniają funkcje określone w standardowym formacie Netscape.
Działają one jednak w ściśle ograniczonym środowisku sandbox. Na przykład dostęp do informacji User Agent jest całkowicie zablokowany.
Poniżej opisano funkcje dozwolone w tym środowisku. Kod przykładów zachowano w oryginale, a znaczenie koreańskich komentarzy podano przed każdym przykładem.
dnsDomainIs
Sprawdza nazwę hosta i zwraca true, jeśli pasuje. Zwykle służy do sprawdzania pojedynczych wyjątków nazw hostów.
Znaczenie komentarzy w przykładzie: Jeśli nazwa hosta to google.com lub pasująca subdomena (na przykład maps.google.com albo www.google.com), przeglądarka łączy się bezpośrednio, bez proxy.
// 만약 hostname 이 google.com 과 같거나 하위 주소들이 매치된다면
// (예를 들어 maps.google.com, www.google.com),
// 브라우저로 하여금 proxy 을 거치지 않고 직접 접속하게 합니다.
if (dnsDomainIs(host, "google.com"))
return "DIRECT";
shExpMatch
Porównuje nazwę hosta lub URL z ciągiem określonym wyrażeniem powłoki i zwraca true przy dopasowaniu.
Znaczenie komentarzy w przykładzie: Pierwszy warunek kieruje bezpośrednio wszystkie żądania pasujące do nazw kończących się na .local. Drugi pozwala na bezpośredni dostęp do vpn.domain.com oraz wszystkich plików i folderów pod http://abcdomain.com/folder/.
// 모든 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
Sprawdza adres IP hosta i zwraca true, jeśli należy on do określonej podsieci. Jeśli argumentem jest nazwa hosta, jest ona zamieniana na IP przez DNS.
Znaczenie komentarzy w przykładzie: Jeśli adres IP żądanego hosta po rozwiązaniu DNS należy do podanego zakresu, połączenie jest bezpośrednie.
// 만약 요청한 hostname 의 IP 주소가 (DNS resolving 후) 인자로 넘겨진
// IP 대역에 포함되는 것이면 직접 접속합니다.
if (isInNet(dnsResolve(host), "172.16.0.0", "255.240.0.0"))
return "DIRECT";
myIpAddress
Zwraca adres IP bieżącego komputera.
Znaczenie komentarzy w przykładzie: Jeśli komputer należy do określonego zakresu IP, żądania są kierowane przez proxy 10.10.5.1 na porcie 8080.
// 만약 나의 컴퓨터가 특정 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
Zamienia nazwę hosta na adres IP za pomocą DNS.
Znaczenie komentarzy w przykładzie: Jeśli IP żądanego hosta należy do któregoś ze wskazanych zakresów, połączenie jest bezpośrednie.
// 만약 요청한 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
Zwraca true, jeśli nazwa hosta nie zawiera kropki. Przykładem jest http://intranet; funkcja przydaje się przy adresach witryn w sieci wewnętrznej.
Znaczenie komentarzy w przykładzie: Żądania prostych nazw hostów, takich jak http://intranet/ lub http://webserver-name01/, są kierowane bezpośrednio.
// 만약 사용자가 plain hostname (예를 들면, http://intranet/ 혹은
// http://webserver-name01/) 를 요청할 경우, 직접 접속하도록 합니다.
if (isPlainHostName(host))
return "DIRECT";
localHostOrDomainIs
Sprawdza nazwę hosta i zwraca true, jeśli części nazwy hosta są zgodne.
Znaczenie komentarzy w przykładzie: Jeśli żądana nazwa hosta to „www” lub „www.google.com”, połączenie jest bezpośrednie.
// 만약 요청한 hostname 이 "www" 혹은 "www.google.com" 일 경우, 직접
// 접속합니다.
if (localHostOrDomainIs(host, "www.google.com"))
return "DIRECT";
isResolvable
Zamienia nazwę hosta na IP i zwraca true, jeśli operacja się powiedzie.
Jeśli rozwiązanie nazwy domeny nie działa prawidłowo, przeglądarka może na chwilę się zawiesić. Używaj ostrożnie.
Znaczenie komentarzy w przykładzie: Jeśli serwer DNS potrafi rozwiązać żądaną nazwę hosta, żądanie przechodzi przez proxy1.example.com.
// 만약 요청한 hostname 이 DNS 서버로 부터 resolving 이 될 수 있다면,
// proxy1.example.com 프록시를 통해 요청합니다.
if (isResolvable(host))
return "PROXY proxy1.example.com:8080";
dnsDomainLevels
Zwraca liczbę kropek w nazwie hosta. Może służyć na przykład do wykluczania serwerów WWW w sieci wewnętrznej.
Znaczenie komentarzy w przykładzie: Jeśli nazwa hosta zawiera co najmniej jedną kropkę, używane jest proxy1.example.com; w przeciwnym razie połączenie jest bezpośrednie.
// 만약 hostname 이 . (dot) 을 하나라도 포함하고 있으면 proxy1.example.com
// 프록시를 통해 접속하고 그렇지 않으면 직접 접속합니다.
if (dnsDomainLevels(host) > 0)
return "PROXY proxy1.example.com:8080";
else
return "DIRECT";
weekdayRange
Pozwala tworzyć reguły zależne od czasu, na przykład zwracać ustawienia proxy tylko w określone dni tygodnia.
Znaczenie komentarzy w przykładzie: Od poniedziałku do piątku używane jest proxy1.example.com; w pozostałe dni połączenie z internetem jest bezpośrednie.
// 만약 월요일부터 금요일 사이에는 proxy1.example.com 프록시를 사용하도록
// 하고 그렇지 않을 경우는 직접 인터넷에 접속하도록 합니다.
if (weekdayRange("MON", "FRI"))
return "PROXY proxy1.example.com:8080";
else
return "DIRECT";
dateRange
Pozwala tworzyć reguły zależne od daty, na przykład używać proxy tylko w określonych miesiącach.
Znaczenie komentarzy w przykładzie: Od stycznia do marca używane jest proxy1.example.com; poza tym okresem połączenie jest bezpośrednie.
// 만약 1월부터 3월까지는 proxy1.example.com 프록시를 사용하도록 설정하고
// 그렇지 않을 경우는 직접 접속하도록 조치합니다.
if (dateRange("JAN", "MAR"))
return "PROXY proxy1.example.com:8080";
else
return "DIRECT";
timeRange
Pozwala używać proxy tylko w określonych godzinach.
Znaczenie komentarzy w przykładzie: Proxy1.example.com jest używane tylko od 8 rano do 18; poza tymi godzinami połączenie jest bezpośrednie.
// 오직 아침 8 시부터 오후 6 시까지만 proxy1.example.com 을 사용하도록
// 하고 그렇지 않을 경우는 직접 접속합니다.
if (timeRange(8, 18))
return "PROXY proxy1.example.com:8080";
else
return "DIRECT";
alert
Funkcji nie było w pierwotnej definicji PAC, ale Internet Explorer i Firefox udostępniają ją do rozwiązywania problemów.
Znaczenie komentarzy w przykładzie: Wynik rozwiązania DNS jest wyświetlany w konsoli błędów przeglądarki.
// 브라우저의 error 콘솔창에 DNS resolving 한 결과를 출력하도록 합니다.
resolved_host = dnsResolve(host);
alert(resolved_host);