Tworzenie i hostowanie tunelu deweloperskiego

Tunele developerskie to zaawansowane narzędzie umożliwiające bezpieczne otwieranie localhosta na potrzeby internetu oraz kontrolowanie dostępu, co pozwala łatwo testować i debugować aplikacje webowe i webhookie z niemal dowolnego miejsca. Utwórz, hostuj i połącz się z pierwszym tunelem deweloperskim w ciągu kilku sekund.

W tym przewodniku Szybki start dowiesz się, jak utworzyć, hostować i nawiązać połączenie z pierwszym tunelem deweloperskim w ciągu kilku sekund.

Instalowanie

Zanim utworzysz tunel deweloperski, najpierw musisz pobrać i zainstalować narzędzie interfejsu devtunnel wiersza polecenia odpowiadające twojemu systemowi operacyjnemu.

Windows

Windows Menedżer pakietów (winget)

Można użyć winget, menedżera pakietów Microsoft dla Windows, aby zainstalować i zaktualizować CLI devtunnel.

winget install Microsoft.devtunnel

To polecenie domyślnie instaluje najnowszą wersję i usuwa starszą wersję w tej samej lokalizacji, która jest %LOCALAPPDATA%\Microsoft\WinGet\Packages. Aby określić wersję, dodaj --version <version_number> z żądaną wersją do polecenia.

winget upgrade Microsoft.devtunnel

Skrypt programu PowerShell

Możesz również zainstalować devtunnel CLI przy użyciu programu PowerShell, uruchamiając następujące polecenie:

Invoke-WebRequest -Uri https://aka.ms/TunnelsCliDownload/win-x64 -OutFile devtunnel.exe
.\devtunnel.exe -h

Link pobierania bezpośredniego:

Windows (x64) — https://aka.ms/TunnelsCliDownload/win-x64

Uruchom polecenia devtunnel zamiast ./devtunnel:

1. Naciśnij klawisz Windows i wpisz "Zmienne środowiskowe".
2. Wybierz opcję "Edytuj zmienne środowiskowe systemu".
3. Wybierz przycisk "Zmienne środowiskowe...".
4. W tabeli "Zmienne systemowe" są widoczne dwie tabele, znajdź i wybierz zmienną PATH.
5. Wybierz przycisk "Edytuj...".
6. Powinno pojawić się okno. Wybierz przycisk "Nowy".
7. Wpisz ścieżkę katalogu pliku devtunnel.exe (katalog oznacza wykluczenie nazwy pliku ze ścieżki.
8. Aby znaleźć ciąg katalogu, możesz przejść do katalogu w programie PowerShell lub terminalu i wpisać "pwd"
9. Wybierz pozycję "OK" we wszystkich otwartych oknach i uruchom ponownie wiersz polecenia.

macOS

Homebrew

Możesz użyć Homebrew, aby zainstalować i zaktualizować interfejs wiersza polecenia devtunnel. Następujące polecenia mogą być używane z --cask lub bez.

brew install --cask devtunnel

brew uninstall --cask devtunnel

brew upgrade --cask devtunnel

brew list --versions devtunnel

Należy pamiętać, że następujące polecenie jest dostępne tylko wtedy, gdy zainstalowano wcześniej szukaną wersję oprogramowania Homebrew. Aby wyświetlić listę dostępnych wersji, uruchom powyższe polecenie.

brew switch --cask devtunnel <older_version>

Skrypt

curl -sL https://aka.ms/DevTunnelCliInstall | bash

Link pobierania bezpośredniego:

macOS (arm64) — https://aka.ms/TunnelsCliDownload/osx-arm64-zip

macOS (x64) — https://aka.ms/TunnelsCliDownload/osx-x64-zip

Linux

curl -sL https://aka.ms/DevTunnelCliInstall | bash

Link pobierania bezpośredniego:

Linux (x64) — https://aka.ms/TunnelsCliDownload/linux-x64

Zaloguj się

Aby uruchomić tunel deweloperski, najpierw musisz zalogować się przy użyciu konta Microsoft Entra ID, Microsoft lub GitHub. Tunele deweloperskie nie obsługują anonimowego hostowania tuneli. Aby uzyskać więcej informacji, zobacz dokumentację poleceń CLI .

devtunnel user login

Gospodarz

Po zalogowaniu możesz rozpocząć hostowanie tunelu host deweloperskiego przy użyciu polecenia . W poniższym przykładzie tunele deweloperskie zrobią następujące rzeczy:

• Uruchom serwer lokalny na porcie 8080, który odbija wysłane do niego żądania.
• Hostowanie tunelu deweloperskiego dla portu 8080 lokalnego, który jest dostępny dla Internetu.

# Start a http server on port 8080
devtunnel echo http -p 8080
# Tunnel port 8080
devtunnel host -p 8080

Pomyślne host polecenie wyświetla coś podobnego do poniższego przykładu w konsoli.

Connecting to host tunnel relay wss://usw2-data.rel.tunnels.api.visualstudio.com/api/v1/Host/Connect/<tunnel_id>
Hosting port 8080 at https://<tunnel_id>.usw2.devtunnels.ms:8080/, https://<tunnel_id>-8080.usw2.devtunnels.ms/ and inspect it at https:/<tunnel_id>-8080-inspect.usw2.devtunnels.ms/
Ready to accept connections for tunnel: <tunnel_id>

Tekst drukowany zawiera:

• tunnel_id - Identyfikator tunelu deweloperskiego.
• Publiczny adres URL — adres URL, który może służyć do uzyskiwania dostępu do tunelu deweloperskiego w https://<tunnel_id>.usw2.devtunnels.ms:8080/ tym przykładzie.
• Sprawdź adres URL — adres URL, którego można użyć do sprawdzenia ruchu wysyłanego przez tunel deweloperski w https:/<tunnel_id>-8080-inspect.usw2.devtunnels.ms/ tym przykładzie.

Połącz

Aby nawiązać połączenie z tunelem deweloperskim, należy wykonać następujące kroki:

1. Odwiedź ten adres URL w przeglądarce internetowej.
2. Zaloguj się przy użyciu tego samego konta, które zostało użyte do hostowania tunelu deweloperskiego. Domyślnie tunele deweloperskie są dostępne tylko dla Ciebie.

Gratulacje! Teraz możesz uzyskać dostęp do usługi lokalnej przez Internet.

Następne kroki

• Dokumentacja poleceń CLI