创建并托管开发隧道

开发隧道是一个强大的工具,可以安全地将本地主机打开到 Internet 并控制谁有访问权限,因此你几乎可以从任何地方轻松测试和调试 Web 应用和 Webhook。 在几秒钟内创建、托管并连接到你的第一个开发隧道。

在本快速入门中,你将学习如何在几秒钟内创建、托管和连接到你的第一个开发隧道。

安装

在创建开发隧道之前,你首先需要下载并安装与你的操作系统对应的 devtunnel CLI(命令行界面)工具。

Windows 包管理器 (winget)

你可以使用 Microsoft 的 Windows 包管理器 winget 来安装和更新 devtunnel CLI。

winget install Microsoft.devtunnel

此命令默认安装最新版本,并且会删除同一位置(即 %LOCALAPPDATA%\Microsoft\WinGet\Packages)中的旧版本。 若要指定版本,请将带有所需版本的 --version <version_number> 添加到命令中。

winget upgrade Microsoft.devtunnel

PowerShell 脚本

你还可以使用 PowerShell 并运行以下命令来安装 devtunnel CLI:

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

直接下载链接:

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

使用 devtunnel 而不是 ./devtunnel 来运行命令:

  1. 按 Windows 键并输入“环境变量”。
  2. 选择选项“编辑系统环境变量”。
  3. 选择“环境变量...”按钮。
  4. 你可以看到两个表,在“系统变量”表中,找到并选择“PATH”变量。
  5. 选择“编辑...”按钮。
  6. 此时应该会弹出一个窗口。 选择“新建”按钮。
  7. 键入 devtunnel.exe 文件的目录路径(目录意味着从路径中排除文件名。
  8. 要查找目录字符串,你可以导航到 PowerShell 或终端中的目录并输入“pwd”)
  9. 在所有打开的窗口中选择“确定”并重新启动命令提示符。

登录

要启动开发隧道,首先需要使用 Microsoft Entra ID、Microsoft 或 GitHub 帐户登录。 开发隧道不支持匿名托管隧道,有关更多信息,请查看 CLI 命令参考文档。

devtunnel user login

主机

登录后,可以使用 host 命令开始托管开发隧道。 在下面的示例中,开发隧道将:

  • 在端口 8080 上运行本地服务器以回显发送给它的请求。
  • 为可通过 Internet 访问的本地端口 8080 托管开发隧道。
# Start a http server on port 8080
devtunnel echo http -p 8080
# Tunnel port 8080
devtunnel host -p 8080

成功执行的 host 命令会在控制台上打印类似以下示例的内容。

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>

打印的文本包含:

  • tunnel_id - 开发隧道的 ID。
  • 公共 URL - 可用于访问开发隧道的 URL,在此示例中为 https://<tunnel_id>.usw2.devtunnels.ms:8080/
  • 检查 URL - 你可以使用此 URL 检查通过开发隧道发送的流量,本示例中为 https:/<tunnel_id>-8080-inspect.usw2.devtunnels.ms/

连接

要连接到开发隧道,你需要:

  1. 在 Web 浏览器中访问此 URL。
  2. 使用与用于托管开发隧道相同的帐户登录。 默认情况下,只有你才可以访问开发隧道。

祝贺! 你现在可以通过 Internet 访问本地服务。

后续步骤