创建 HTTP 隧道
本页内容 10 个章节
HTTP 隧道会为你设备上的 Web 应用、API 或 webhook 接收端提供一个公网 HTTPS 地址。证书由 Localtonet 提供,所以你的本地服务可以继续使用普通 HTTP。
开始之前 #
- 设备上已安装 Localtonet 客户端,并已使用 AuthToken 连接。如果还没有,请按照快速入门操作。
- 你的 Web 服务正在运行,并且你知道它的端口,例如
3000。 - 使用自定义子域名或自定义域名时:你的账户需要有余额。使用自定义域名时,还需要一个已在 DNS 管理器中添加的域名。参见自定义域名。
步骤 #
-
打开 HTTP 页面 #
打开 我的隧道 › HTTP,选择创建 HTTP 隧道打开表单。
-
选择 URL 类型 #
URL 类型 你获得的地址 要求 随机子域名 在所选域名下生成的名称,例如 https://<RANDOM_NAME>.localto.net。无额外要求 自定义子域名 你在子域名中输入的名称,例如 https://myapp.localto.net。允许使用字母、数字和连字符。余额 自定义域名 你自己的域名,在域名中选择。 余额,以及 DNS 管理器中的一个域名 -
选择设备和区域 #
在设备令牌中,选择你设备上的 Localtonet 应用所使用的令牌。在服务器区域中,选择离你的设备较近的区域,以降低延迟。
-
输入本地地址 #
字段 填写内容 域名 localto.net,或你自己的某个域名。对于自定义域名,列表中只有你自己的域名。子域名 仅用于自定义子域名:域名前面的那部分名称。 本地 IP 地址 设备上服务的地址。对本机使用 127.0.0.1。表单接受 IPv4 或 IPv6 地址,也接受localhost。本地端口 你的本地服务监听的端口,范围为 1 到 65535。 选择创建隧道。隧道会出现在你的隧道下,显示为
Tunnel #加上它的 ID。 -
启动隧道 #
选择操作列中的启动按钮。隧道运行后,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 隧道并启动它,然后在提供方处填写隧道地址加上你的端点路径:
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:// 链接和重定向。