Megosztás a következőn keresztül:

Dev Proxy beállítása

  • Cikk

A Dev Proxy egy parancssori eszköz, amely segít szimulálni a felhőalapú API-k viselkedését és hibáit, hogy rugalmas alkalmazásokat hozzon létre.

Ebben az oktatóanyagban megismerheti a Dev Proxy telepítését és futtatását.

Fejlesztői proxy telepítése

A Dev Proxy telepítésének legegyszerűbb módja a winget használata. Másik lehetőségként manuálisan is telepítheti a dev proxyt.

A Dev Proxy winget használatával történő telepítéséhez futtassa a következő parancsot:

winget install Microsoft.DevProxy --silent

Fontos

A fejlesztői proxytelepítő új bejegyzést ad hozzá a PATH-hoz. A dev proxy telepítés utáni használatához újra kell indítania a parancssort a PATH környezeti változó frissítéséhez.

Jegyzet

A legújabb előzetes verziójú funkciók kipróbálásához telepítse a Dev Proxy bétaverzióját.

A Dev Proxy winget használatával történő telepítéséhez futtassa a következő parancsot:

winget install Microsoft.DevProxy.Beta --silent

A Dev Proxy bétaverziójának futtatásához használja a devproxy-beta

A Dev Proxy telepítésének legegyszerűbb módja a Homebrew használata. Másik lehetőségként manuálisan is telepítheti a dev proxyt.

A Dev Proxy Homebrew használatával történő telepítéséhez futtassa a következő parancsokat:

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

Jegyzet

A legújabb előzetes verziójú funkciók kipróbálásához telepítse a Dev Proxy bétaverzióját.

A Dev Proxy Homebrew használatával történő telepítéséhez futtassa a következő parancsokat:

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

A Dev Proxy bétaverziójának futtatásához használja a devproxy-beta

A Dev Proxy telepítésének legegyszerűbb módja a beállítási szkript használata. Másik lehetőségként manuálisan is telepítheti a dev proxyt.

A dev proxy telepítési szkripttel való telepítéséhez futtassa a következő parancsokat:

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

Ha a PowerShellt használja, futtassa a következő parancsot:

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

Jegyzet

A legújabb előzetes verziójú funkciók kipróbálásához telepítse a Dev Proxy bétaverzióját.

A dev proxy telepítési szkripttel való telepítéséhez futtassa a következő parancsokat:

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

Ha a PowerShellt használja, futtassa a következő parancsot:

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

A Dev Proxy bétaverziójának futtatásához használja a devproxy-beta

Indítsa el a fejlesztői proxy-t először

Amikor először indítja el a Dev Proxyt a számítógépen, néhány lépést kell követnie annak érdekében, hogy a Dev Proxy képes legyen elfogni a számítógépről érkező kérelmeket, és sikeresen válaszolhasson. Az első futtatás után nem kell megismételnie ezeket a lépéseket.

  1. Fejlesztői proxy indítása. Nyisson meg egy parancssori munkamenetet. Írja be devproxy, majd nyomja le Enterbillentyűt.
  2. Megbízhatósági tanúsítvány. A Dev Proxy egy Dev Proxy CAnevű tanúsítványt telepít. Megjelenik egy figyelmeztetés. Válassza Yes a tanúsítvány telepítésének megerősítéséhez. A Dev Proxy ezt a tanúsítványt használja a gépről küldött HTTPS-forgalom visszafejtéséhez.
  3. Tűzfalhozzáférés engedélyezése. A Windows tűzfal blokkolja a proxyt. Megjelenik egy figyelmeztetés. Válassza Allow access gombot a tűzfalon keresztüli forgalom engedélyezéséhez.
  1. Fejlesztői proxy indítása. Nyisson meg egy parancssori munkamenetet. Írja be devproxy, majd nyomja le Enterbillentyűt.
  2. Megbízhatósági tanúsítvány. A Dev Proxy egy Dev Proxy CAnevű tanúsítványt telepít, amelyet a gépről küldött HTTPS-forgalom visszafejtésére használ. Megjelenik egy figyelmeztetés. Nyomja le az y billentyűt a tanúsítvány megbízhatóságának megerősítéséhez.
  3. Fogadja bejövő kapcsolatokat. Megjelenik egy figyelmeztetés. A megerősítéshez válassza a Allow.

  1. Fejlesztői proxy indítása. Nyisson meg egy parancssori munkamenetet. Írja be devproxy, majd nyomja le Enterbillentyűt.

  2. Megbízhatósági tanúsítvány. A Dev Proxy egyéni SSL-tanúsítványt használ a gépről küldött HTTPS-forgalom visszafejtéséhez.

    Fontos

    Az alábbi utasítások az Ubuntu-hoz tartoznak. Más Linux-disztribúciók esetében a lépések eltérhetnek.

    A tanúsítvány telepítéséhez és megbízhatóságához futtassa az alábbi parancsokat egy új parancssorban:

    # 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

A parancssor a következő kimenetet jeleníti meg:

 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

Alapértelmezés szerint a Dev Proxy a következőre van konfigurálva:

  • Bármely JSON helyőrző API- végpontra irányuló kérések elfogása
  • API hibaválaszok és API-korlátozás szimulálása 50%-os hibaaránnyal

Ellenőrizze, hogy a fejlesztői proxy megfelelően működik-e

A Dev Proxy elfogja azokat a kéréseket, amelyeket a számítógépen lévő alkalmazások a Dev Proxyban regisztráló URL-címekre küldenek. Amikor a Dev Proxy észlel egy kérést, vagy átadja azt az API-nak (nem hajt végre semmilyen műveletet), vagy választ ad vissza. Győződjön meg arról, hogy a Dev Proxy a várt módon működik.

A PowerShellben a Invoke-WebRequest parancsmaggal küldjön GET kérést a JSON Helyőrző API-nak.

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

Ha curlhasznál, küldjön GET kérést a JSON Placeholder API-nak az alábbi paranccsal.

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

A Postman API klienst is használhatja egy GET-kérés küldéséhez https://jsonplaceholder.typicode.com/posts.

A dev proxy futtatásának parancssorában láthatja a kéréssel és a Dev Proxy által végrehajtott műveletsel kapcsolatos információkat. A Dev Proxy alapértelmezés szerint 50% eséllyel szimulál egy hibaválaszt. Ha a kérés nem ad vissza hibát, a Dev Proxy átadja azt.

 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

Ha a Dev Proxy hibaüzenetet ad vissza, a hibaüzenet megjelenik a kimenetben.

 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

Fontos

Ha nem lát kimenetet a parancssorban, valószínű, hogy a Dev Proxy nem fogja elfogni a kéréseket. Segítségért tekintse meg a gyakori problémákat szakaszt.

Állítsa le biztonságosan a fejlesztői proxy-t

Ha már nincs szüksége a Dev Proxy futtatására, mindig állítsa le biztonságosan.

  • A dev proxy biztonságos leállításához nyomja le a Ctrl + C billentyűkombinációt.

Ha leállítja a parancssori munkamenetet, a Dev Proxy nem szünteti meg a rendszerproxyként való regisztrációt, és gyakori problémákat tapasztalhat.

Következő lépés

Megtudhatja, hogyan konfigurálhatja a Dev Proxyt az igényei szerint. A fejlesztői proxy rendkívül rugalmas, és számos különböző forgatókönyvet támogat. További információ arról, hogyan konfigurálhatja az adott forgatókönyvhöz.

Fejlesztői proxy konfigurálása