跳到内容
Localtonet Localtonet 控制台

创建 HTTP 隧道

获取本页帮助
本页内容 10 个章节
  1. 开始之前
  2. 步骤
  3. 打开 HTTP 页面
  4. 选择 URL 类型
  5. 选择设备和区域
  6. 输入本地地址
  7. 启动隧道
  8. 你的公网地址
  9. HTTPS 与证书
  10. Host 头
  11. HTTP 隧道的设置
  12. 示例
  13. 分享一个 Web 应用
  14. 接收 webhook
  15. 免费版上的警告页面
  16. 故障排除
  17. 相关页面

HTTP 隧道会为你设备上的 Web 应用、API 或 webhook 接收端提供一个公网 HTTPS 地址。证书由 Localtonet 提供,所以你的本地服务可以继续使用普通 HTTP。

开始之前 #

  • 设备上已安装 Localtonet 客户端,并已使用 AuthToken 连接。如果还没有,请按照快速入门操作。
  • 你的 Web 服务正在运行,并且你知道它的端口,例如 3000。
  • 使用自定义子域名或自定义域名时:你的账户需要有余额。使用自定义域名时,还需要一个已在 DNS 管理器中添加的域名。参见自定义域名。

步骤 #

  1. 打开 HTTP 页面 #

    打开 我的隧道 › HTTP,选择创建 HTTP 隧道打开表单。

  2. 选择 URL 类型 #

    URL 类型你获得的地址要求
    随机子域名在所选域名下生成的名称,例如 https://<RANDOM_NAME>.localto.net。无额外要求
    自定义子域名你在子域名中输入的名称,例如 https://myapp.localto.net。允许使用字母、数字和连字符。余额
    自定义域名你自己的域名,在域名中选择。余额,以及 DNS 管理器中的一个域名
  3. 选择设备和区域 #

    在设备令牌中,选择你设备上的 Localtonet 应用所使用的令牌。在服务器区域中,选择离你的设备较近的区域,以降低延迟。

  4. 输入本地地址 #

    字段填写内容
    域名localto.net,或你自己的某个域名。对于自定义域名,列表中只有你自己的域名。
    子域名仅用于自定义子域名:域名前面的那部分名称。
    本地 IP 地址设备上服务的地址。对本机使用 127.0.0.1。表单接受 IPv4 或 IPv6 地址,也接受 localhost。
    本地端口你的本地服务监听的端口,范围为 1 到 65535。

    选择创建隧道。隧道会出现在你的隧道下,显示为 Tunnel # 加上它的 ID。

  5. 启动隧道 #

    选择操作列中的启动按钮。隧道运行后,URL 列中的地址会变成链接。在浏览器中打开它,发往该地址的请求就会到达你设备上的服务。

    如果该令牌对应的 Localtonet 应用处于离线状态,会弹出对话框告知你。请启动该应用,或选择仍然启动,隧道会在应用连接后上线。

你的公网地址 #

  • 地址是 https:// 加上 URL 列中的主机名。
  • HTTP 隧道会一直保留它的子域名,直到你删除该隧道。停止和启动都不会改变它。
  • 地址中没有端口号。访问者像打开任何其他网站一样打开它。
  • WebSocket 连接可以通过 HTTP 隧道。

HTTPS 与证书 #

访问者通过 HTTPS 访问 HTTP 隧道,证书由 Localtonet 提供并负责续期。TLS 在 Localtonet 服务器上终止。之后请求通过隧道到达你的设备,再由 Localtonet 应用转交给你的服务。

设置作用适用场景
仅限 HTTPS?公网 URL 仅通过 HTTPS 提供服务。对 http:// 的请求会被重定向到 https:// 上的同一地址。关闭时,该地址同时响应两种协议。凡是涉及登录或私密数据的服务,都应开启。
启用 HTTP/3?允许客户端通过 HTTP/3 访问公网 URL。新建隧道默认开启。只有当某个客户端在使用 HTTP/3 时出现问题,才需要关闭。
本地 HTTPS?让 Localtonet 应用使用 TLS 连接你的本地服务。应用会原样接受本地服务的证书,因此自签名证书也可以使用。当你的本地服务本身使用 HTTPS 时开启,例如运行在 https://localhost:5001 的开发服务器。
旧版连接?用旧版方式而不是常规方式连接隧道。如果隧道无法使用常规方式连接,可以试试这个选项。

这些开关位于隧道设置面板的设置下。在运行中的隧道上更改本地 HTTPS?或旧版连接?会重启该隧道,因此 Localtonet 应用必须处于连接状态。

需要一直加密到你自己的服务吗?使用 HTTP 隧道时,Localtonet 会在其服务器上解密流量。如果你的服务必须出示自己的证书,请使用 TLS 隧道。

Host 头 #

你的服务收到的是访问者使用的主机名,也就是隧道地址。有些本地 Web 服务器按主机名选择站点,可能会返回错误的站点或报错。这种情况下,请在隧道设置中打开 HTTP 头,添加一个名为 Host 的请求头,值为你的服务器所期望的主机名。这样你的服务收到的就是这个主机名,而不是隧道地址。参见 HTTP 头与重写和虚拟主机。

HTTP 隧道的设置 #

选择操作列中的设置按钮,打开隧道设置面板。在隧道详情下,你可以重命名隧道,并更改本地 IP 地址和本地端口。下表列出了 HTTP 隧道提供的其他功能,以及对应的说明页面。

设置作用了解更多
负载均衡在多台设备之间分配流量,或使用备用目标。负载均衡
显示 SSH 命令用普通 SSH 启动此隧道,无需安装 Localtonet 应用。免安装 SSH
仅限 HTTPS?、启用 HTTP/3?、本地 HTTPS?、旧版连接?访问者和你的服务如何连接。本页上文
重写路径?在请求到达你的本地服务之前更改请求路径。HTTP 头与重写
HTTP 头管理此隧道的自定义 HTTP 请求头和响应头。HTTP 头与重写
HTTP 超时设置服务器等待本地应用响应的时长,范围为 1 到 600 秒。HTTP 头与重写
基本认证?要求访问者输入用户名和密码。访问控制
IP 限制控制哪些客户端 IP 地址可以访问此隧道。访问控制
SSO 提供商访问者需要先使用你的某个身份提供商登录,才能打开该隧道。页面顶部的 SSO 按钮用于管理这些提供商。单点登录
操作列中的 WAF 按钮打开 WAF 设置。该按钮会显示 Web 应用防火墙是未配置、已启用还是已停用。Web 应用防火墙
到期日期、速度限制、带宽限制、带宽用量、带宽流量在指定日期停止隧道、限制速度、限制数据量、重置数据计数器,并查看随时间变化的流量。限制与到期
请求日志、活动日志、隧道健康状态检查请求,查看启动、停止和设置更改记录,并查看健康检查结果。日志与检查
参数让此隧道通过你设备上的指定网络传输。网络选择
出站端口为 Localtonet 应用连接服务器使用固定的出站端口,适用于严格的防火墙。端口
隧道备注保存一条私人备注,帮助你识别此隧道。设置参考

属于团队的隧道不会显示 SSO 提供商。

示例 #

分享一个 Web 应用 #

你的应用与 Localtonet 客户端运行在同一台计算机上,并监听 3000 端口。

字段值
URL 类型随机子域名
域名localto.net
本地 IP 地址127.0.0.1
本地端口3000

创建隧道并启动,然后把 URL 列中的地址发给需要查看该应用的人。如果想先要求他们输入密码,请开启基本认证?。

如果应用运行在你网络中的另一台机器上,请在本地 IP 地址中输入那台机器的地址,例如 192.168.1.20。运行 Localtonet 客户端的设备必须能够访问它。

接收 webhook #

webhook 提供方需要一个公网 HTTPS 地址来发送事件。为你的接收端口创建一个 HTTP 隧道并启动它,然后在提供方处填写隧道地址加上你的端点路径:

Webhook URL
https://<YOUR_SUBDOMAIN>.localto.net/<YOUR_WEBHOOK_PATH>

可以在任意一台计算机上测试:

终端
curl -X POST https://<YOUR_SUBDOMAIN>.localto.net/<YOUR_WEBHOOK_PATH> \
  -H "Content-Type: application/json" \
  -d '{"event":"test"}'

要查看收到了什么,请选择隧道 Webhook 列中的图标(查看请求和响应日志)。必须先启动隧道。参见日志与检查。

使用免费版时,请先添加余额,再依赖 webhook。免费账户的 HTTP 隧道收到请求时,会先显示一个警告页面,而 webhook 提供方无法点击跳过。参见下一节。

免费版上的警告页面 #

当账户没有余额时,首次访问其 HTTP 隧道的访问者会看到一个 Localtonet 页面,标题为 “You are about to navigate to:”,并带有取消和 Visit Site 两个按钮。该页面用于防止滥用。点击 Visit Site 会在访问者的浏览器中存储一个 Cookie,并打开你的网站。只要浏览器保留该 Cookie,就不会再次询问。

页面本身列出了两种去掉它的方法:

  • 发送一个名为 localtonet-skip-warning 的请求头,值任意。这适合你自己的脚本和 API 客户端。
  • 为你的账户添加余额。参见套餐与余额。
终端
curl -H "localtonet-skip-warning: 1" https://<YOUR_SUBDOMAIN>.localto.net/

故障排除 #

对话框提示令牌离线,或者我看到“AuthToken“…”对应的 Localtonet 应用未连接。”

使用此隧道令牌的 Localtonet 客户端没有运行,或无法连接到 Localtonet。请在设备上用相同的令牌启动客户端。应用一旦连接,对话框会自动启动隧道。选择仍然启动时,隧道会被置为开启,并在之后上线。

“请启动或更新 Localtonet 应用。”

隧道无法在设备上启动。请确认客户端正在运行;如果版本较旧,请从下载页面安装最新版本。

浏览器显示 “Tunnel Recently Started or Stopped”

请求已到达 Localtonet,但隧道没有接受连接。隧道刚刚启动,或已停止。请确认它已启动,并且连接列显示开,然后刷新页面。

浏览器显示一个 Localtonet 错误页面,其中写着我的本地地址

页面说明流量已被隧道传到 Localtonet 代理程序,但代理程序无法连接到你本地 IP 和端口上的上游服务。标题就是错误类型,例如 ConnectionRefused。该地址上没有任何程序在监听。请启动你的服务,然后在隧道详情下检查本地 IP 地址和本地端口。你可以在设备本机的浏览器中打开本地地址,测试该服务。

“你需要购买余额才能使用此功能。”

自定义子域名和自定义域名需要余额。请使用随机子域名,或在 余额页面添加余额。

“要再创建一个此类型的隧道,你的余额总计需要 …。”

你的余额不足以再创建一个隧道。使用免费版时,无论类型如何,你总共只能创建一个隧道。请先删除现有隧道再创建新的,或者添加余额。

“… 已存在。”或“不允许使用 …。”

该子域名已被另一个隧道使用,或者该名称被 Localtonet 保留。请换一个子域名。

“警告!你还没有任何域名!”

你选择了自定义域名,但还没有添加域名。请先在 DNS 管理器中添加。如果你看到“… 已被其他隧道使用。”,说明该域名已属于你的某个隧道。一个自定义域名只能用于一个隧道。

“请更新带宽限制或清除带宽用量。”或“请更新到期日期。”

隧道已达到自身的带宽限制或到期日期,无法启动。请在隧道设置中更改限制或日期,或用带宽用量重置计数器。参见限制与到期。

“请检查设备连接。”

你在 Localtonet 应用离线时更改了一项会重启运行中隧道的设置。请连接应用后再次保存该设置,或先停止隧道。

我的应用返回了错误的站点,或者生成了 http:// 链接和重定向

你的应用根据收到的主机名或协议方案来做判断。如果应用需要固定的主机名,请在 HTTP 头下添加一个 Host 请求头。再添加一个值为 https 的 X-Forwarded-Proto 请求头,告诉应用访问者使用的是 HTTPS,这样它就会生成 https:// 链接和重定向。

支持