Udostępnij za pośrednictwem

Konfigurowanie serwera proxy deweloperskiego

  • Artykuł

Dev Proxy to narzędzie wiersza polecenia, które pomaga symulować zachowania i błędy interfejsów API w chmurze, które ułatwiają tworzenie odpornych aplikacji.

W tym samouczku nauczysz się, jak zainstalować i uruchomić Dev Proxy.

Instalowanie serwera proxy deweloperskiego

Najprostszym sposobem instalowania serwera proxy deweloperskiego jest użycie zestawu winget. Alternatywnie można zainstalować serwer proxy deweloperów ręcznie.

Aby zainstalować serwer proxy deweloperów przy użyciu zestawu winget, uruchom następujące polecenie:

winget install Microsoft.DevProxy --silent

Ważny

Instalator Dev Proxy dodaje nowy wpis do zmiennej "PATH". Aby użyć serwera proxy deweloperskiego po instalacji, należy ponownie uruchomić wiersz polecenia, aby odświeżyć zmienną środowiskową PATH.

Notatka

Aby wypróbować najnowsze funkcje w wersji zapoznawczej, zainstaluj wersję beta serwera proxy dev.

Aby zainstalować serwer proxy deweloperów przy użyciu zestawu winget, uruchom następujące polecenie:

winget install Microsoft.DevProxy.Beta --silent

Aby uruchomić wersję beta serwera proxy dev, użyj devproxy-beta

Najprostszym sposobem zainstalowania serwera proxy deweloperskiego jest użycie oprogramowania Homebrew. Alternatywnie można zainstalować serwer proxy deweloperów ręcznie.

Aby zainstalować serwer proxy deweloperów przy użyciu oprogramowania Homebrew, uruchom następujące polecenia:

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

Notatka

Aby wypróbować najnowsze funkcje w wersji zapoznawczej, zainstaluj wersję beta serwera proxy dev.

Aby zainstalować serwer proxy deweloperów przy użyciu oprogramowania Homebrew, uruchom następujące polecenia:

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

Aby uruchomić wersję beta serwera proxy dev, użyj devproxy-beta

Najprostszym sposobem zainstalowania serwera proxy deweloperskiego jest użycie skryptu konfiguracji. Alternatywnie można zainstalować serwer proxy deweloperów ręcznie.

Aby zainstalować serwer proxy deweloperów przy użyciu skryptu instalacji, uruchom następujące polecenia:

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

Jeśli używasz programu PowerShell, uruchom następujące polecenie:

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

Notatka

Aby wypróbować najnowsze funkcje w wersji zapoznawczej, zainstaluj wersję beta serwera proxy dev.

Aby zainstalować serwer proxy deweloperów przy użyciu skryptu instalacji, uruchom następujące polecenia:

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

Jeśli używasz programu PowerShell, uruchom następujące polecenie:

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

Aby uruchomić wersję beta serwera proxy dev, użyj devproxy-beta

Uruchamianie serwera proxy deweloperskiego po raz pierwszy

Przy pierwszym uruchomieniu serwera proxy deweloperskiego na maszynie należy wykonać kilka kroków, aby upewnić się, że serwer proxy deweloperów może przechwytywać żądania z maszyny i pomyślnie odpowiadać. Nie trzeba powtarzać tych kroków po pierwszym uruchomieniu.

  1. uruchom serwer proxy deweloperskiego. Otwórz sesję wiersza polecenia. Wprowadź devproxy i naciśnij Enter.
  2. certyfikat zaufania. Proxy deweloperski instaluje certyfikat o nazwie Dev Proxy CA. Zostanie wyświetlone ostrzeżenie. Wybierz Yes, aby potwierdzić, że chcesz zainstalować certyfikat. Dev Proxy używa tego certyfikatu do odszyfrowywania ruchu HTTPS wysyłanego z twojego komputera.
  3. Zezwalaj na dostęp do zapory. Zapora systemu Windows blokuje serwer proxy. Zostanie wyświetlone ostrzeżenie. Wybierz przycisk Allow access, aby zezwolić na ruch przez zaporę.
  1. uruchom serwer proxy deweloperskiego. Otwórz sesję wiersza polecenia. Wprowadź devproxy i naciśnij Enter.
  2. certyfikat zaufania. Dev Proxy instaluje certyfikat o nazwie Dev Proxy CA, którego używa do odszyfrowywania ruchu HTTPS wysyłanego z twojej maszyny. Zostanie wyświetlone ostrzeżenie. Naciśnij y, aby potwierdzić, że chcesz ufać certyfikatowi.
  3. Akceptuj połączenia przychodzące. Zostanie wyświetlone ostrzeżenie. Wybierz Allow, aby potwierdzić.

  1. uruchom serwer proxy deweloperskiego. Otwórz sesję wiersza polecenia. Wprowadź devproxy i naciśnij Enter.

  2. certyfikat zaufania. Dev Proxy korzysta z niestandardowego certyfikatu SSL, aby deszyfrować ruch HTTPS wysyłany z twojego komputera.

    Ważny

    Poniższe instrukcje dotyczą systemu Ubuntu. W przypadku innych dystrybucji systemu Linux kroki mogą się różnić.

    Aby zainstalować i zaufać certyfikatowi, w nowym wierszu polecenia uruchom następujące polecenia:

    # 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

Wiersz polecenia wyświetla następujące dane wyjściowe:

 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

Domyślnie Proxy deweloperski jest skonfigurowany do:

  • Przechwytywanie żądań wysyłanych do dowolnego punktu końcowego JSON Placeholder API
  • Symulowanie odpowiedzi na błędy API i ograniczanie przepustowości API z częstością awarii 50%

Upewnij się, że Serwer Proxy Dev działa prawidłowo

Dev Proxy przechwytuje żądania, które aplikacje na twojej maszynie wysyłają do adresów URL, które zarejestrujesz w Dev Proxy. Gdy serwer proxy deweloperów wykryje żądanie, przekazuje je do interfejsu API (nie podejmij żadnej akcji) lub zwraca odpowiedź. Upewnijmy się, że Dev Proxy działa zgodnie z oczekiwaniami.

W programie PowerShell użyj polecenia cmdlet Invoke-WebRequest, aby wysłać żądanie GET do JSON Placeholder API.

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

Jeśli używasz curl, wyślij żądanie GET do interfejsu API JSON Placeholder, używając następującego polecenia.

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

Możesz również użyć klienta interfejsu API, takiego jak Postman, aby wysłać żądanie GET do https://jsonplaceholder.typicode.com/posts.

W wierszu polecenia, w którym jest uruchomiony Dev Proxy, zobaczysz informacje o żądaniu i akcji wykonanej przez Dev Proxy. Domyślnie Dev Proxy symuluje odpowiedź błędu z 50% szansą. Jeśli twoje żądanie nie zwraca błędu, Proxy Dev przekazuje je dalej.

 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

Jeśli Dev Proxy zwraca odpowiedź o błędzie, w wynikach zostanie wyświetlony komunikat o błędzie.

 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

Ważny

Jeśli w wierszu polecenia nie widzisz żadnych danych wyjściowych, prawdopodobnie serwer proxy dewelopera nie przechwytuje żądań. Zapoznaj się z sekcją typowe problemy, aby uzyskać pomoc.

Bezpieczne zatrzymanie serwera proxy deweloperskiego

Gdy Dev Proxy przestanie być potrzebny, zawsze należy go bezpiecznie zatrzymać.

  • Naciśnij Ctrl + C, aby bezpiecznie zatrzymać Dev Proxy.

Jeśli zamkniesz sesję wiersza poleceń, Dev Proxy nie wyrejestruje się poprawnie jako serwer proxy systemu, i możesz napotkać kilka typowych problemów.

Następny krok

Dowiedz się, jak skonfigurować serwer proxy deweloperski zgodnie z potrzebami. Serwer proxy deweloperów jest wysoce elastyczny i obsługuje wiele różnych scenariuszy. Dowiedz się więcej o sposobie konfigurowania go w określonym scenariuszu.

konfigurowanie serwera proxy deweloperskiego