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.
-
Starta Dev Proxy. Öppna ett kommandotolksfönster. Ange
devproxy
och tryck på Retur. -
Förtroendecertifikat. Dev Proxy installerar ett certifikat med namnet
Dev Proxy CA
. En varning visas. VäljYes
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. -
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.
-
Starta Dev Proxy. Öppna ett kommandotolksfönster. Ange
devproxy
och tryck på Retur. -
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. -
Acceptera inkommande anslutningar. En varning visas. Välj
Allow
för att bekräfta.
Starta Dev Proxy. Öppna ett kommandotolksfönster. Ange
devproxy
och tryck på Retur.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 curl
skickar 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.