创建 TLS 隧道
桌面版 v7.6+ 移动版 v9.9+
本页内容 10 个章节
TLS 隧道会把发往某个公共主机名、端口 443 的加密流量转发到本地的 TLS 服务。默认情况下,加密连接会直接穿透到你的服务,由你的服务出示它自己的证书。
选 TLS、HTTP 还是 TCP? #
这三种都可以发布使用加密的服务。它们的区别在于谁持有证书,以及公共地址的样子。
| 问题 | HTTP 隧道 | TLS 隧道 | TCP 隧道 |
|---|---|---|---|
| 公共端点 | 不带端口的 https:// 地址 | 端口 443 上的主机名 | 主机名加分配的服务器端口 |
| 谁出示证书 | Localtonet | 默认是你的服务。如果你在 SSL 模式 中这样选择,则由 Localtonet 出示。 | Localtonet 不添加证书。你的服务照常处理。 |
| TLS 在哪里终止 | 在 Localtonet 服务器 | 在透传模式下,在你的服务 | 在你的协议终止它的地方 |
| 协议 | HTTP 和 WebSocket | 任何基于 TLS 的协议 | 任何 TCP 协议 |
| HTTP 选项,例如请求头、路径重写、基本认证、SSO、WAF 和请求检查器 | 是 | 否 | 否 |
| URL 类型 | 随机子域名、自定义子域名、自定义域名 | 随机子域名、自定义子域名 | 随机子域名、自定义子域名 |
| 免费版会话限制 | 无 | 每次会话 30 分钟 | 每次会话 30 分钟 |
- 对于普通网站、API 或 Webhook 接收端,请选择 HTTP。它最省事。
- 当你的服务必须出示自己的证书、流量必须一直加密到你的设备,或者需要通过端口 443 访问某个基于 TLS 的非 HTTP 协议时,请选择 TLS。
- 当协议从第一个字节起就不是 TLS,或者客户端无法发送主机名时,请选择 TCP。TCP 隧道通过端口寻址,TLS 隧道通过主机名寻址。
开始之前 #
- 一个最新的 Localtonet 客户端,并已用 AuthToken 连接。TLS 页面会标明最低版本:桌面版 v7.6 和移动版 v9.9。
- 一个使用 TLS 的本地服务,并且有适用于客户端所用主机名的证书。如果你的服务没有证书,请参见 HTTP,或者按下面的说明切换 SSL 模式。
- 使用 自定义子域名:你的账户需要有余额。
步骤 #
-
打开 TLS 页面 #
打开 我的隧道 › TLS,选择 创建 TLS 隧道 打开表单。
-
选择 URL 类型、设备和区域 #
在 URL 类型 中选择 随机子域名 或 自定义子域名。在 设备令牌 中选择你设备上的 Localtonet 应用所用的令牌。在 服务器区域 中选择离你的设备较近的区域。
-
输入端点 #
字段 填写内容 域名 localto.net,或者你在 DNS 管理器 中添加的域名。子域名 仅用于 自定义子域名:域名前面的名称。允许使用字母、数字和连字符。 本地 IP 地址 你设备上服务的地址。本设备请使用 127.0.0.1。本地端口 你的 TLS 服务监听的端口,例如 443或8443。选择 创建隧道。
-
启动隧道 #
选择 操作 列中的启动按钮。URL 列会显示主机名,服务器端口 列会显示
443。客户端通过端口 443 连接该主机名。
端点 #
- 所有 TLS 隧道都通过端口 443 访问。本地端口可以是任意端口。
- Localtonet 根据客户端打开 TLS 连接时发送的主机名(SNI)来找到你的隧道。因此,客户端必须使用 URL 列中的主机名连接。如果连接服务器的 IP 地址而不带这个主机名,就无法到达你的隧道。
- 停止再启动隧道后,主机名保持不变。
SSL 模式:谁来处理证书 #
打开隧道设置,选择 SSL 模式 旁边的 管理。SSL 模式 对话框会询问由谁来处理这个隧道的 HTTPS。
| 选项 | 会发生什么 | 适用情况 |
|---|---|---|
| 由我的服务处理 HTTPS | 透传。加密流量直接穿透到你的服务,你的服务必须出示适用于该域名的自己的证书。Localtonet 不会解密它。 | 你需要自己的证书或端到端加密。新的 TLS 隧道默认使用这个模式。 |
| 由 Localtonet 处理 HTTPS | 由 Localtonet 提供并续期证书,你这边无需任何设置。Localtonet 终止 TLS 连接,并把解密后的流量转发给你的服务。 | 你的服务没有证书,但客户端必须通过端口 443 上的 TLS 访问它。 |
选择 保存。如果隧道正在运行,它会以新模式重启,因此 Localtonet 应用必须处于连接状态。
本地 HTTPS? 这项设置属于第二种模式。当 Localtonet 处理 HTTPS,而你的本地服务仍然期望 TLS 连接时,请开启它。在透传模式下请保持关闭,因为访问者的 TLS 连接本来就原样到达你的服务。
TLS 隧道的设置 #
| 设置 | 作用 | 了解更多 |
|---|---|---|
| SSL 模式 | 选择由 Localtonet 管理 SSL,或者把 TLS 流量透传给你自己的服务。 | 本页上文 |
| 本地 HTTPS? | 当你的本地服务使用 TLS 时启用它。 | 本页上文 |
| 旧版连接? | 如果隧道无法用常规方式连接,请试试这个。 | 设置参考 |
| 隧道 IP | 查看服务器的 IPv4 和 IPv6 地址。 | 设置参考 |
| IP 限制 | 控制哪些客户端 IP 地址可以访问此隧道。 | 访问控制 |
| 到期日期、速度限制、带宽限制、带宽用量、带宽流量 | 在某个日期停止隧道、限制其速度、限制其数据量、重置数据计数器,并查看随时间变化的流量。 | 限制与到期 |
| 请求日志、活动日志、隧道健康状态 | 查看连接到隧道的连接、它的启动、停止和设置更改,以及健康检查。 | 日志与检查 |
| 参数 | 让此隧道通过你设备上的指定网络。 | 网络选择 |
| 出站端口 | 为 Localtonet 应用连接服务器使用固定的出站端口,适用于严格的防火墙。 | 端口 |
| 隧道备注 | 保存一条私人备注,帮助你识别此隧道。 | 设置参考 |
| 负载均衡 | 在多台设备之间分配流量,或使用备用目标。 | 负载均衡 |
TLS 隧道没有服务器端口设置,也没有保留端口。端口始终是 443。
示例 #
使用自带证书的 Web 服务器 #
你的 Web 服务器监听 127.0.0.1:443,并有适用于 secure.example.com 的证书。你已在 DNS 管理器中添加了 example.com,并且你的账户有余额。
| 字段 | 值 |
|---|---|
| URL 类型 | 自定义子域名 |
| 子域名 | secure |
| 域名 | example.com |
| 本地 IP 地址 | 127.0.0.1 |
| 本地端口 | 443 |
启动隧道并打开 https://secure.example.com。浏览器会显示你自己服务器的证书。你可以用 OpenSSL 检查出示的是哪个证书:
openssl s_client -connect <TUNNEL_HOST>:443 -servername <TUNNEL_HOST>基于 TLS 的非 HTTP 服务 #
你设备上的消息代理在本地端口 8883 上接受 TLS 连接。创建一个 本地端口 为 8883 的 TLS 隧道。客户端随后在开启 TLS 的情况下,通过端口 443 连接隧道的主机名。客户端必须发送主机名(SNI),按名称连接时 TLS 库会自动发送。
为没有证书的服务在端口 443 上提供 TLS #
针对你服务的明文端口创建隧道,打开 SSL 模式,选择 由 Localtonet 处理 HTTPS。客户端通过 TLS 连接,并收到 Localtonet 提供的证书。你的服务仍然接收未加密的流量。
在免费版下 #
在免费版下,TLS 隧道会在 30 分钟后停止。如果你还有剩余的每月带宽,请选择 启动 开始新的会话。主机名不会变化。参见 套餐与余额。
故障排除 #
客户端显示证书警告
在透传模式下,客户端看到的是你自己服务的证书。它必须对隧道的主机名有效,并且被客户端信任。请在你的服务上安装匹配的证书,或者把 SSL 模式 切换为 由 Localtonet 处理 HTTPS。
连接刚打开就关闭了
在透传模式下,你的本地服务必须自己应答 TLS 握手。如果本地端口上的服务使用的是纯 HTTP 或纯 TCP,请把 SSL 模式 切换为 由 Localtonet 处理 HTTPS,或者改用 HTTP 或 TCP 隧道。同时请检查透传模式下 本地 HTTPS? 是否已关闭。
“请启动或更新 Localtonet 应用。”
隧道无法在设备上启动。TLS 隧道需要 Localtonet 桌面版 v7.6 或移动版 v9.9 或更高版本。请从 下载 页面更新客户端,然后再次启动隧道。
“请检查设备连接。”
你在 Localtonet 应用离线时保存了 SSL 模式 或另一个会重启运行中隧道的设置。请连接应用后再次保存,或者先停止隧道。
“你需要购买余额才能使用此功能。”
自定义子域名 需要余额。请使用 随机子域名,或者在 余额 中充值。
隧道在半小时后停止了
这是免费版的会话限制。已停止的隧道在列表中会显示 会话已结束。请再次启动它,或者充值余额以取消该限制。