Sdílet prostřednictvím


nástroj pro konfiguraci proxy serveru ProxyCfg.exe

Důležitý

ProxyCfg.exe se od systému Windows Vista a Windows Server 2008 už nepoužívá. Nahrazuje se Netsh.exe (viz Netsh.exe příkazy).

Toto téma vysvětluje použití nástroje pro konfiguraci proxy serveru systému Microsoft Windows HTTP Services (WinHTTP)ProxyCfg.exe.

Existují dva způsoby přístupu k serverům HTTP a SECURE Hypertext Transfer Protocol (HTTPS) prostřednictvím proxy serveru pomocí služeb HTTP systému Microsoft Windows (WinHTTP). Nejprve můžete zadat nastavení proxy serveru z aplikace WinHTTP. Za druhé můžete zadat výchozí nastavení proxy serveru mimo vaši aplikaci pomocí konfiguračního nástroje proxy, který se nachází v adresáři %windir%\system32.

Data proxy serveru můžete nastavit prostřednictvím kódu programu v rámci aplikace nebo skriptu. Pokud píšete aplikaci pomocí rozhraní API WinHTTP, použijte jednu z následujících dvou technik ke změně nastavení proxy serveru.

  • Použijte funkci WinHttpOpen. Zadejte typ přístupu v druhém parametru, název proxy serveru ve třetím parametru a seznam obejití ve čtvrtém parametru. Následující příklad ukazuje, jak lze k nastavení dat proxy serveru použít funkci WinHttpOpen.

    hSession = WinHttpOpen( L"WinHTTP Example/1.0",  
                            WINHTTP_ACCESS_TYPE_NAMED_PROXY,
                            L"proxy_name", 
                            L"<local>", 
                            0);
    
  • Použijte funkci WinHttpSetOption. Příznak WINHTTP_OPTION_PROXY umožňuje zadat nastavení proxy serveru se strukturou WINHTTP_PROXY_INFO. Následující příklad kódu ukazuje, jak WinHttpSetOption funkci lze použít k nastavení dat proxy.

    WINHTTP_PROXY_INFO proxyInfo;
    proxyInfo.dwAccessType = WINHTTP_ACCESS_TYPE_NAMED_PROXY;
    proxyInfo.lpszProxy = L"proxy_name";
    proxyInfo.lpszProxyBypass = L"<local>";
    
    // Set the proxy information for this session.
    WinHttpSetOption( hSession, 
                      WINHTTP_OPTION_PROXY, 
                      &proxyInfo, 
                      sizeof(proxyInfo));
    

Pokud píšete skript nebo aplikaci pomocí objektu WinHttpRequest, změňte nastavení proxy serveru pomocí následujícího postupu.

  • Použijte metodu SetProxy. Zadejte typ přístupu v prvním parametru, název proxy serveru v druhém parametru a seznam obejití třetího parametru. Následující příklad ukazuje, jak SetProxy metoda lze použít ve skriptu k nastavení proxy dat.

    WinHttpReq.SetProxy( HTTPREQUEST_PROXYSETTING_PROXY, 
                         "proxy_server:80", 
                         "*.microsoft.com");
    

Pokud chcete zadat výchozí nastavení a eliminovat potřebu použít metoduSetProxy nebo funkciWinHttpSetOption, použijte konfigurační nástroj proxy serveru. Pomocí tohoto nástroje můžete určit, že vaše aplikace přistupuje k síti buď přímo, prostřednictvím proxy serveru, nebo prostřednictvím kombinace přímého a proxy přístupu zadáním seznamu obejití. Pokud používáte rozhraní WINHTTP API, nástroj pro konfiguraci proxy serveru určuje nastavení pouze při předání příznaku WINHTTP_ACCESS_TYPE_DEFAULT do rozhraní API WinHttpOpen. Objekt WinHttpRequest ve výchozím nastavení používá nastavení nástroje konfigurace proxy serveru.

Nastavení proxy serveru pro WinHTTP nejsou nastavení proxy serveru pro Aplikaci Microsoft Internet Explorer. Nastavení proxy serveru pro WinHTTP nelze nakonfigurovat v Ovládacích panelech Systému Microsoft Windows. Použití nástroje konfigurace proxy serveru WinHTTP nemění nastavení, která používáte pro Aplikaci Internet Explorer.

Poznámka

Pokud se pokusíte otevřít a odeslat požadavek HTTP pomocí winHTTP a nastavení proxy serveru je nesprávné, dojde k chybě.

Parametry příkazového řádku

Následující tabulka uvádí parametry příkazového řádku, které jsou k dispozici s nástrojem "ProxyCfg.exe".

Parametr Popis
žádný Pokud nejsou zadány žádné parametry, zobrazí se aktuální nastavení proxy serveru WinHTTP.
? Zobrazí se informace nápovědy.
d Určuje, že aplikace WinHTTP přistupuje k síti přímo bez proxy serveru.
p Určuje proxy server. Můžete také zadat volitelný seznam serverů, ke kterým se přistupuje bez proxy serveru.
u Určuje, že aplikace WinHTTP používají nastavení proxy serveru aktuálního uživatele pro Aplikaci Internet Explorer. Tento parametr nefunguje, pokud Internet Explorer automaticky rozpozná nastavení proxy serveru nebo pokud k nastavení informací o proxy serveru používá automatickou adresu URL konfigurace.
Určuje, že aplikace WinHTTP používají nastavení proxy serveru aktuálního uživatele pro Aplikaci Internet Explorer. To funguje jenom v případě, že ProxyCfg.exe nebyly dříve použity. Pokud je nainstalován ProxyCfg.exe, zadejte, že parametr příkazového řádku "u" používá ruční nastavení. Tento parametr nefunguje, pokud Internet Explorer automaticky zjistí nastavení proxy serveru nebo pokud k nastavení informací o proxy serveru používá automatickou adresu URL konfigurace.

Proxy servery můžete zadat v řetězci s oddělovači mezerami. Výpisy proxy serveru můžou obsahovat číslo portu, které se používá pro přístup k proxy serveru. Chcete-li zobrazit seznam proxy pro určitý protokol, řetězec musí dodržovat formát, <protokol>=https://<proxy_name>. Platné protokoly jsou HTTP a HTTPS. Pokud chcete například uvést proxy server HTTP, platný řetězec je http=https://http_proxy_name:80, kde http_proxy_name je název proxy serveru a 80 je číslo portu, které musíte použít pro přístup k proxy serveru. Pokud proxy server používá výchozí číslo portu pro tento protokol, můžete číslo portu vynechat. Pokud je název proxy serveru uvedený samostatně, můžete ho použít jako výchozí proxy pro všechny protokoly, které nemají zadaný proxy server. Například http=https://http_proxy other_proxy používá http_proxy pro všechny operace HTTP, zatímco protokol HTTPS používá proxy s názvem other_proxy.

V seznamu obejití proxy serveru můžete vypsat místně známé názvy hostitelů nebo IP adresy. Tento seznam může obsahovat zástupné kóty, například "*", což způsobí, že aplikace vynechá proxy server pro adresy, které odpovídají zadanému vzoru, například "*.microsoft.com" nebo "*.org". Zástupné znaky musí být nejvíce znaků vlevo v seznamu. Například aaa.*se nepodporuje. Pokud chcete vypsat více adres a názvů hostitelů, oddělte je prázdnými mezerami nebo středníky v řetězci obejití proxy serveru. Pokud zadáte <místním> makrem, funkce obchází jakýkoli název hostitele, který neobsahuje tečku.

Varování

Po Proxycfg.exe spuštění nelze obnovit předchozí nastavení proxy serveru. Nastavení proxy serveru ale můžete úplně odebrat.

Zvyk

Pokud chcete použít konfigurační nástroj proxy serveru, otevřete okno příkazového řádku a spusťte nástroj pro konfiguraci proxy serveru s příslušnými parametry příkazového řádku. Následující část obsahuje příklady syntaxe.

Příklad syntaxe

Příklad 1: Použití proxy serveru pouze pro externí prostředky

Toto je nejběžnější použití pro Proxycfg.exe. Tento příkaz určuje, že servery HTTP a HTTPS jsou přístupné prostřednictvím proxy serveru s názvem "proxy_server", s výjimkou názvů hostitelů, které neobsahují tečku.

-p proxy_server -p proxy_server proxycfg<místní>

Příklad 2: Použití proxy serveru pro všechny prostředky

Následující příklad určuje, že servery HTTP a HTTPS jsou přístupné prostřednictvím proxy serveru s názvem "proxy_server". Není zadán žádný seznam obejití.

-p proxy_server proxycfg

Příklad 3: Použití jiného proxy serveru pro zabezpečené prostředky

Následující příklad určuje, že k serverům HTTP se přistupuje prostřednictvím http_proxy proxy serveru a k serverům HTTPS se přistupuje prostřednictvím https_proxy. Místní intranetové weby a všechny weby v doméně *.microsoft.com obejít proxy server.

proxycfg -p "http=http_proxy https=https_proxy"<místní>;*.microsoft.com"

Odebrání ProxyCfg.exe

Po použití konfiguračního nástroje proxy nemůžete obnovit původní nastavení proxy serveru. V případě potřeby však můžete odebrat nastavení registru, které nástroj vytvoří. Chcete-li odebrat položky registru, které ProxyCfg.exe vytvoří, je nutné odstranit hodnotu WinHttpSettings z následujícího klíče registru.

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Nastavení internetu\Připojení\WinHttpSettings

Odstraněním hodnoty WinHttpSettings odeberete všechny konfigurace proxy serveru.

ProxyCfg.exe a ověřování

Konfigurační nástroj proxy nastaví výchozí zásady ověřování. Vzhledem k tomu, že byste neměli provádět ověřování NTLM s nedůvěryhodnými hostiteli, ve výchozím nastavení se ověřování NTLM provádí automaticky pouze u hostitelů v seznamu obejití proxy serveru. Pokud neexistuje žádný proxy server, můžete pomocí ProxyCfg.exe zadat seznam hostitelů, kterým důvěřujete za účelem ověřování NTLM. Při použití ProxyCfg.exe pro tento účel se vyžaduje název proxy serveru, ale místo skutečného názvu proxy serveru můžete použít libovolný platný řetězec.

Další informace o zásadách automatického přihlášení naleznete v tématu zásady automatického přihlášení.