Dev Tunnel-opdrachtregelreferentie - Microsoft-Dev-Tunnel (2023)

Development Tunnels biedt een opdrachtregelinterface (CLI) om ontwikkeltunnels te maken en te beheren.

Algemene opties

• -v, --verbose: Uitgebreide uitvoer inschakelen.
• -?, -h, --help: Zie hulp en gebruiksinformatie.

Gebruikersreferenties beheren

De tunnelservice vereist een login om beheer en toegang tot tunnels te autoriseren. Een tunnel is standaard alleen toegankelijk voor de gebruiker die de tunnel heeft gemaakt, maar deze gebruiker kan ook anderen toegang verlenen.

Na het inloggen wordt het login-token in de cache van de beveiligingssleutelhanger van het systeem opgeslagen en is het meerdere dagen geldig voordat het verloopt. Als u zich afmeldt bij de CLI, wordt dit in de cache opgeslagen token gewist, maar worden browsercookies niet verwijderd die mogelijk tunneltoegangstokens bevatten als een browser is gebruikt voor authenticatie met een tunnel.

Hier zijn enkele voorbeelden van het gebruik van deze opdrachten:

Wees de gastheer van een tunnel

Dit is het hoofdcommando dat wordt gebruikt om uw tunnel te hosten. De opdracht moet worden uitgevoerd op het hostsysteem waarop de server draait waartoe u toegang wilt via de tunnel.

Hier zijn enkele voorbeelden van het gebruik van deze opdracht:

druk opStrg+Com het tunnelhostproces te stoppen en alle clientverbindingen via de tunnel te beëindigen. Als er geen bestaande tunnel is opgegeven, wordt de automatisch gemaakte tunnel door het proces verwijderd wanneer het proces wordt afgesloten.

Maak verbinding met een tunnel

Om de interface voor webdoorsturen te gebruiken:

vonDevtunnel-hostDe opdracht geeft uitvoer weer die er als volgt uitziet:

Hostingpoort 3000 onder https://l3rs99qw-3000.usw2.devtunnels.ms/

Het bleekhttps:De URI is uniek voor de tunnelpoort: het eerste onderdeel is een subdomein met het opgegeven tunnel-ID en poortnummer.

Wanneer de gehoste poort verbinding maakt met een webserver, is deze URI overal rechtstreeks in een browser toegankelijk. Als autorisatie vereist is om toegang te krijgen tot de tunnel, wordt het eerste verzoek aan de URI omgeleid naar een aanmeldingspagina en na autorisatie van de gebruiker teruggestuurd naar de site.

Als de gehoste poort verbinding maakt met een webservice, kan deze URI worden gebruikt als de basis-URI door een webserviceclienttoepassing. Als de tunnel echter geen anonieme toegang toestaat, weet de webserviceclient zichzelf meestal niet te authenticeren. Als de webservice veilig kan worden gepubliceerd, overweeg dan om anonieme toegang toe te staan. Anders kan een webserviceclient een aanvraagheader met een tunneltoegangstoken toevoegen om de verbinding te verifiëren.

De CLI gebruiken:

In plaats van een clientbrowser of -toepassing die rechtstreeks verbinding maakt met een tunnelrelay-URI, kan de CLI worden gebruikt om verbindingen van een poort op de client door te sturen naar een tunnelpoort. De client moet mogelijk ook inloggen als de tunnel geen anonieme toegang toestaat.

devtunnel verbindt TUNNEL

• Vervangen doorTUNNELDezelfde tunnel-ID die op de host wordt gebruikt.

Succesvolle klantoutput ziet er als volgt uit:

Verbonden met tunnel: l3rs99qwSSH: forward 127.0.0.1:3000 naar hostpoort 3000.SSH: forward [::1]:3000 naar hostpoort 3000.

Nu wordt de server gedeeld op hostpoort 3000 beschikbaar oplokale gastheer: 3000De client gebruikt IPv4 of IPv6. (Het voorvoegsel "SSH" is omdat de tunnelservice bovenop het standaard SSH port forwarding-protocol is gebouwd.) Als de gehoste poort verbinding maakt met een webserver,http://localhost:3000/Kan het in een browser worden geopend? In dit geval is geen verdere autorisatie vereist, aangezien het CLI-inlogtoken van de client mogelijk is gebruikt om de verbinding te verifiëren.

Geavanceerd: Beheer tunnels

Het is mogelijk om een ​​tunnel te maken zonder deze al te hosten. Dit is handig voor geavanceerde tunnelconfiguratie en -beheer, zoals:

• Laat al mijn tunnels zien
• Poorten in een tunnel toevoegen en verwijderen
• Toegangscontrole tunnel beheren
• Voeg metadata toe aan een tunnel, b.v. B. Beschrijving en tags

Hier zijn enkele voorbeelden van het gebruik van deze opdrachten:

Geavanceerd: Beheer tunnelpoorten

Een tunnel gemaakt metCreëer dev-tunnelopdracht, heeft aanvankelijk geen poorten. gebruikDevtunnel-poortOpdrachten om poorten toe te voegen vóór hosting:

Bij het aanmaken van een poort kan eventueel het protocol worden opgegeven als de automatische detectie niet goed werkt. De huidige opties zijn http, https of auto (standaard). Als de gehoste poort HTTPS is, wordt aanbevolen om het poortprotocol in te stellen op "https"; Anders is "Auto" waarschijnlijk prima.

Na het configureren van een tunnel met behulp van de bovenstaande opdrachten, begint u met het hosten van die tunnel:

Devtunnel-host

Geavanceerd: Beheer tunneltoegang

De volgende opdrachten kunnen tokens voor tunneltoegang uitgeven om andere clients toegang te geven tot uw tunnel zonder anonieme toegang toe te staan. Met de invoeropdrachten voor toegangscontrole kunt u toegangscontrole voor tunnels en tunnelpoorten configureren.

Hier zijn enkele voorbeelden van het gebruik van deze opdrachten:

Aanvullende opdrachten

Deze opdrachten kunnen worden gebruikt wanneer u deze lokale cache expliciet moet instellen of wissen voor de laatst gebruikte tunnel.

diagnostische commando's

problemen oplossen

Het volgende kan nuttig zijn bij het oplossen van problemen met de CLI:

• Zorg ervoor dat u de nieuwste versie van de CLI gebruikt. Controleer de momenteel geïnstalleerde versie metdevtunnel --versie.
• Met-- omslachtigDeze optie zendt foutopsporingsberichten uit die aanvullende diagnostische informatie kunnen geven.