Dela via


Konfigurera Dev Proxy

Dev Proxy är ett kommandoradsverktyg som hjälper dig att simulera beteenden och fel i moln-API:er som hjälper dig att skapa motståndskraftiga appar.

I den här självstudien får du lära dig hur du installerar och kör Dev Proxy.

Installera Dev Proxy

Det enklaste sättet att installera Dev Proxy är att använda winget. Du kan också installera Dev Proxy manuellt.

Om du vill installera Dev Proxy med winget kör du följande kommando:

winget install Microsoft.DevProxy --silent

Viktig

Installationsprogrammet för Dev Proxy lägger till en ny post i PATH. Om du vill använda Dev Proxy efter installationen måste du starta om kommandotolken för att uppdatera PATH-miljövariabeln.

Obs

Om du vill prova de senaste förhandsversionsfunktionerna installerar du betaversionen av Dev Proxy.

Om du vill installera Dev Proxy med winget kör du följande kommando:

winget install Microsoft.DevProxy.Beta --silent

Om du vill köra betaversionen av Dev Proxy använder du devproxy-beta

Det enklaste sättet att installera Dev Proxy är att använda Homebrew. Du kan också installera Dev Proxy manuellt.

Om du vill installera Dev Proxy med Homebrew kör du följande kommandon:

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

Notera

Om du vill prova de senaste förhandsversionsfunktionerna installerar du betaversionen av Dev Proxy.

Om du vill installera Dev Proxy med Homebrew kör du följande kommandon:

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

Om du vill köra betaversionen av Dev Proxy använder du devproxy-beta

Det enklaste sättet att installera Dev Proxy är med hjälp av installationsskriptet. Du kan också installera Dev Proxy manuellt.

Om du vill installera Dev Proxy med installationsskriptet kör du följande kommandon:

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

Om du använder PowerShell kör du följande kommando:

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

Obs

Om du vill prova de senaste förhandsversionsfunktionerna installerar du betaversionen av Dev Proxy.

Om du vill installera Dev Proxy med installationsskriptet kör du följande kommandon:

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

Om du använder PowerShell kör du följande kommando:

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

Om du vill köra betaversionen av Dev Proxy använder du devproxy-beta

Starta Dev Proxy för första gången

Första gången du startar Dev Proxy på datorn finns det några steg att följa för att säkerställa att Dev Proxy kan fånga upp begäranden från datorn och svara korrekt. Du behöver inte upprepa de här stegen efter den första körningen.

  1. Starta Dev Proxy. Öppna ett kommandotolksfönster. Ange devproxy och tryck på Retur.
  2. Förtroendecertifikat. Dev Proxy installerar ett certifikat med namnet Dev Proxy CA. En varning visas. Välj Yes för att bekräfta att du vill installera certifikatet. Dev Proxy använder det här certifikatet för att dekryptera HTTPS-trafik som skickas från datorn.
  3. Tillåt brandväggsåtkomst. Windows-brandväggen blockerar proxyn. En varning visas på skärmen. Välj knappen Allow access för att tillåta trafik genom brandväggen.
  1. Starta Dev Proxy. Öppna ett kommandotolksfönster. Ange devproxy och tryck på Retur.
  2. Förtroendecertifikat. Dev Proxy installerar ett certifikat med namnet Dev Proxy CA, som används för att dekryptera HTTPS-trafik som skickas från datorn. En varning visas. Tryck på y för att bekräfta att du vill lita på certifikatet.
  3. Acceptera inkommande anslutningar. En varning visas. Välj Allow för att bekräfta.
  1. Starta Dev Proxy. Öppna ett kommandotolksfönster. Ange devproxy och tryck på Retur.

  2. Förtroendecertifikat. Dev Proxy använder ett anpassat SSL-certifikat för att dekryptera HTTPS-trafik som skickas från datorn.

    Viktig

    Följande instruktioner gäller för Ubuntu. För andra Linux-distributioner kan stegen skilja sig åt.

    Om du vill installera och lita på certifikatet kör du följande kommandon i en ny kommandotolk:

    # 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
    

Kommandotolken visar följande utdata:

 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

Som standard är Dev Proxy konfigurerat för att:

  • Avlyssna begäranden som görs till varje JSON Placeholder-API-slutpunkt
  • Simulera API-felsvar och begränsning av API-anrop med en felfrekvens på 50%

Bekräfta att Dev Proxy fungerar korrekt

Dev Proxy fångar upp begäranden som program på datorn gör till URL:er som du registrerar med Dev Proxy. När Dev Proxy identifierar en begäran skickar den den antingen till API:et (vidta ingen åtgärd) eller returnerar ett svar. Nu ska vi bekräfta att Dev Proxy fungerar som förväntat.

I PowerShell använder du cmdleten Invoke-WebRequest för att skicka en GET-begäran till JSON-platshållar-API:et.

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

Om du använder curlskickar du en GET-begäran till JSON-platshållar-API:et med hjälp av följande kommando.

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

Du kan också använda en API-klient som Postman för att skicka en GET-begäran till https://jsonplaceholder.typicode.com/posts.

På kommandoraden där Dev Proxy körs visas information om begäran och den åtgärd som Dev Proxy utförde. Som standard simulerar Dev Proxy ett felsvar med 50% chans. Om din begäran inte returnerar ett fel skickar Dev Proxy igenom den.

 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

Om Dev Proxy returnerar ett felsvar visas felmeddelandet i utdata.

 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

Viktig

Om du inte ser några utdata i kommandotolken är det troligt att Dev Proxy inte fångar upp begäranden. Mer hjälp finns i avsnittet vanliga problem.

Stoppa Dev Proxy på ett säkert sätt

När du inte längre kräver att Dev Proxy körs bör du alltid stoppa den på ett säkert sätt.

  • Tryck på Ctrl + C för att stoppa Dev Proxy på ett säkert sätt.

Om du stänger kommandotolken avregistrerar sig Dev Proxy inte korrekt som systemproxy, och du kan uppleva några vanliga problem.

Nästa steg

Lär dig hur du konfigurerar Dev Proxy efter dina behov. Dev Proxy är mycket flexibelt och stöder många olika scenarier. Läs mer om hur du konfigurerar det till ditt specifika scenario.