Sdílet prostřednictvím

Nastavení dev proxy serveru

  • Článek

Dev Proxy je nástroj příkazového řádku, který vám pomůže simulovat chování a chyby cloudových rozhraní API, které vám pomůžou vytvářet odolné aplikace.

V tomto kurzu se dozvíte, jak nainstalovat a spustit Dev Proxy.

Instalace dev proxy serveru

Nejjednodušší způsob instalace Dev Proxy je použití sady winget. Případně můžete dev Proxy nainstalovat ručně.

Pokud chcete nainstalovat Dev Proxy pomocí wingetu, spusťte následující příkaz:

winget install Microsoft.DevProxy --silent

Důležitý

Instalační program dev Proxy přidá novou položku do path. Pokud chcete po instalaci používat Dev Proxy, je nutné restartovat příkazový řádek, aby se aktualizovala proměnná prostředí PATH.

Poznámka

Pokud chcete vyzkoušet nejnovější funkce preview, nainstalujte beta verzi Dev Proxy.

Pokud chcete nainstalovat Dev Proxy pomocí wingetu, spusťte následující příkaz:

winget install Microsoft.DevProxy.Beta --silent

Pokud chcete spustit beta verzi Dev Proxy, použijte devproxy-beta

Nejjednodušší způsob instalace Dev Proxy je použití Homebrew. Případně můžete dev Proxy nainstalovat ručně.

Pokud chcete nainstalovat Dev Proxy pomocí Homebrew, spusťte následující příkazy:

brew tap dotnet/dev-proxy
brew install dev-proxy

Poznámka

Pokud chcete vyzkoušet nejnovější funkce preview, nainstalujte beta verzi Dev Proxy.

Pokud chcete nainstalovat Dev Proxy pomocí Homebrew, spusťte následující příkazy:

brew tap dotnet/dev-proxy
brew install dev-proxy-beta

Pokud chcete spustit beta verzi Dev Proxy, použijte devproxy-beta

Nejjednodušší způsob instalace Dev Proxy je použití instalačního skriptu. Případně můžete dev Proxy nainstalovat ručně.

Pokud chcete nainstalovat Dev Proxy pomocí instalačního skriptu, spusťte následující příkazy:

bash -c "$(curl -sL https://aka.ms/devproxy/setup.sh)"

Pokud používáte PowerShell, spusťte následující příkaz:

(Invoke-WebRequest https://aka.ms/devproxy/setup.ps1).Content | Invoke-Expression

Poznámka

Pokud chcete vyzkoušet nejnovější funkce preview, nainstalujte beta verzi Dev Proxy.

Pokud chcete nainstalovat Dev Proxy pomocí instalačního skriptu, spusťte následující příkazy:

bash -c "$(curl -sL https://aka.ms/devproxy/setup-beta.sh)"

Pokud používáte PowerShell, spusťte následující příkaz:

(Invoke-WebRequest https://aka.ms/devproxy/setup-beta.ps1).Content | Invoke-Expression

Pokud chcete spustit beta verzi Dev Proxy, použijte devproxy-beta

První spuštění dev proxy serveru

Při prvním spuštění dev proxy serveru na počítači je několik kroků, které je potřeba provést, abyste zajistili, že dev proxy server dokáže zachycovat požadavky z počítače a úspěšně reagovat. Po prvním spuštění nebudete muset tyto kroky opakovat.

  1. Spustit Dev Proxy. Otevřete okno příkazového řádku. Zadejte devproxy a stiskněte Enter.
  2. důvěryhodný certifikát. Dev Proxy nainstaluje certifikát s názvem Dev Proxy CA. Zobrazí se upozornění. Vyberte Yes a potvrďte, že chcete certifikát nainstalovat. Dev Proxy používá tento certifikát k dešifrování provozu HTTPS odeslaného z vašeho počítače.
  3. Povolit přístup k bráně firewall. Windows Firewall blokuje proxy server. Zobrazí se upozornění. Výběrem tlačítka Allow access povolte provoz přes bránu firewall.
  1. Spustitdev proxy . Otevřete relaci příkazového řádku. Zadejte devproxy a stiskněte Enter.
  2. certifikát důvěry. Dev Proxy nainstaluje certifikát s názvem Dev Proxy CA, který používá k dešifrování provozu HTTPS odeslaného z vašeho počítače. Zobrazí se upozornění. Stisknutím y potvrďte, že chcete certifikátu důvěřovat.
  3. Přijímat příchozí připojení. Zobrazí se upozornění. Potvrďte výběr Allow.

  1. SpustitDev Proxy . Otevřete relaci příkazového řádku. Zadejte devproxy a stiskněte Enter.

  2. Certifikát důvěryhodnosti. Dev Proxy používá vlastní certifikát SSL k dešifrování provozu HTTPS odesílaných z vašeho počítače.

    Důležitý

    Následující pokyny jsou určené pro Ubuntu. U jiných linuxových distribucí se kroky můžou lišit.

    Pokud chcete certifikát nainstalovat a důvěřovat mu, spusťte na novém příkazovém řádku následující příkazy:

    # Export Dev Proxy root certificate
openssl pkcs12 -in ~/.config/dev-proxy/rootCert.pfx -clcerts -nokeys -out dev-proxy-ca.crt -passin pass:""
# Install the certificate
sudo cp dev-proxy-ca.crt /usr/local/share/ca-certificates/
# Update certificates
sudo update-ca-certificates

Příkazový řádek zobrazí následující výstup:

 info    8 error responses loaded from devproxy-errors.json
 info    Dev Proxy API listening on http://localhost:8897...
 info    Dev Proxy Listening on 127.0.0.1:8000...

Hotkeys: issue (w)eb request, (r)ecord, (s)top recording, (c)lear screen
Press CTRL+C to stop Dev Proxy

Ve výchozím nastavení je dev proxy nakonfigurovaný na:

  • Zachytávat požadavky adresované na libovolný koncový bod zástupného rozhraní API JSON .
  • Simulace chybových odpovědí rozhraní API a omezování rozhraní API s rychlostí selhání 50%

Ověřte, že dev proxy server funguje správně.

Dev Proxy zachytává požadavky, které aplikace na vašem počítači vytvářejí k adresám URL, jež zaregistrujete pomocí Dev Proxy. Když Dev Proxy zjistí požadavek, buď ho předá do rozhraní API (neprovedou žádnou akci), nebo vrátí odpověď. Pojďme si ověřit, že dev proxy funguje podle očekávání.

V PowerShellu použijte rutinu Invoke-WebRequest k odeslání požadavku GET do zástupného rozhraní API JSON.

Invoke-WebRequest -Uri https://jsonplaceholder.typicode.com/posts

Pokud používáte curl, pomocí následujícího příkazu odešlete do zástupného rozhraní API JSON požadavek GET.

curl -ikx http://localhost:8000 https://jsonplaceholder.typicode.com/posts

Můžete také použít klienta rozhraní API, jako je Postman, odeslat požadavek GET na https://jsonplaceholder.typicode.com/posts.

Na příkazovém řádku, na kterém běží Dev Proxy, se zobrazí informace o požadavku a akci, kterou dev proxy provedl. Dev Proxy ve výchozím nastavení simuluje chybovou odpověď s 50% pravděpodobností. Pokud váš požadavek nevrátí chybu, Dev Proxy jej zpracuje dál.

 req   ╭ GET https://jsonplaceholder.typicode.com/posts
 time  │ 1/31/2025 12:12:14 PM +00:00
 skip  │ RetryAfterPlugin: Request not throttled
 skip  │ GenericRandomErrorPlugin: Pass through
 api   ╰ Passed through

Pokud dev proxy server vrátí chybovou odpověď, zobrazí se ve výstupu chybová zpráva.

 req   ╭ GET https://jsonplaceholder.typicode.com/posts
 time  │ 1/31/2025 12:12:37 PM +00:00
 skip  │ RetryAfterPlugin: Request not throttled
 oops  ╰ 403 Forbidden

Důležitý

Pokud na příkazovém řádku nevidíte žádný výstup, je pravděpodobné, že Dev Proxy nezachycuje požadavky. Podívejte se do části Běžné problémy pro nápovědu.

Bezpečné zastavení dev proxy serveru

Pokud už nepotřebujete, aby Dev Proxy běžel, měli byste ho vždy bezpečně zastavit.

  • Stisknutím kláves Ctrl + C bezpečně zastavíte dev proxy server.

Pokud relaci příkazového řádku vypnete, Dev Proxy se neregistruje správně jako systémový proxy server a může dojít k některým běžných problémů.

Další krok

Zjistěte, jak nakonfigurovat Dev Proxy podle vašich potřeb. Dev Proxy je vysoce flexibilní a podporuje mnoho různých scénářů. Přečtěte si další informace o tom, jak ho nakonfigurovat pro váš konkrétní scénář.

Konfigurovat dev proxy