跳到内容
Localtonet Localtonet 控制台

使用 SSH 客户端启动隧道

免费版 HTTP 和 TCP 隧道

获取本页帮助
本页内容 11 个章节
  1. 适用场景
  2. 开始之前
  3. 步骤
  4. 创建 HTTP 或 TCP 隧道
  5. 打开 SSH 命令
  6. 选择是否自动重连
  7. 运行命令
  8. 保持窗口打开
  9. 通过隧道设置向导
  10. 命令详解
  11. 自动重连
  12. 命令的有效期
  13. 限制
  14. 你在控制台中看到的内容
  15. 故障排查
  16. 控制台中的消息
  17. 终端中的消息
  18. 相关页面

无需安装 Localtonet,就能把本地服务发布到线上。控制台会给你一条现成的 ssh 命令;这条命令运行期间,你的 HTTP 或 TCP 隧道保持在线。

适用场景 #

当你无法或不想在某台机器上安装 Localtonet 客户端时,可以使用免安装 SSH,例如只临时访问一下的服务器、受限的办公电脑,或一次快速演示。你只需要 Windows、macOS 和 Linux 自带的 ssh 客户端。

对一条隧道来说,SSH 命令可以代替 Localtonet 客户端。其他一切仍在控制台中管理:隧道地址、设置、日志和带宽。

隧道类型SSH 命令
HTTP / HTTPS可用
TCP可用
UDP、UDP / TCP 混合、TLS、文件服务器、代理服务器及其他类型不可用。这些类型需要 Localtonet 客户端。

本页讲的不是如何连接 SSH 服务器。如需通过隧道发布你自己的 SSH 服务器,请参阅在 Localtonet 中使用 SSH。如需从控制台在你的某台设备上打开 shell,请参阅设备终端。

开始之前 #

  • 一个 Localtonet 账户,以及一个已在运行的服务,例如运行在 3000 端口的 Web 应用。
  • 能访问该服务的机器上需要有 ssh 客户端。可用 ssh -V 检查。
  • 该机器所在的网络必须允许向 223 端口发起出站 TCP 连接。
  • 一个没有被任何运行中的 Localtonet 客户端使用的 AuthToken。隧道总是属于某个令牌,但使用 SSH 时没有客户端用它登录。如果有客户端正在使用该隧道的令牌连接,控制台会拒绝签发命令。

步骤 #

  1. 创建 HTTP 或 TCP 隧道 #

    打开我的隧道 › HTTP或我的隧道 › TCP - UDP(协议选 TCP),按常规方式创建隧道。本地 IP 地址和本地端口就是 SSH 客户端转发流量的目标:如果你在运行服务的同一台机器上执行命令,就填 127.0.0.1 和服务的端口。让隧道保持停止状态。

  2. 打开 SSH 命令 #

    在隧道列表中,选择该隧道的设置,然后选择显示 SSH 命令。SSH 命令对话框会打开,其中是这条隧道的命令。提示会告诉你有多少秒的时间来运行它;未使用的命令会过期,过期后用同样的方式重新获取即可。

  3. 选择是否自动重连 #

    关闭自动重连,得到的就是普通的 ssh 命令。开启后,命令会被包进一个循环,在连接断开时重新启动它;然后在运行环境下选择这个循环所用的 shell:PowerShell、命令提示符或 macOS 或 Linux。

  4. 运行命令 #

    复制命令下的文本。在运行你的服务的电脑上打开终端,粘贴命令并按 Enter。不会要求输入密码。连接建立后,终端会显示隧道的端点:

    终端
    +--------------------------------------------------------------+
    | Welcome to Localtonet!                                       |
    +--------------------------------------------------------------+
    | Localtonet Tunnel Endpoints                                  |
    +--------------------------------------------------------------+
    | HTTP => http://<YOUR_ADDRESS> => 127.0.0.1:3000               |
    | HTTPS => https://<YOUR_ADDRESS> => 127.0.0.1:3000             |
    +--------------------------------------------------------------+
    | Server Time: ...                                             |
    +--------------------------------------------------------------+
    
    You can view your requests and configure your tunnel settings from the Localtonet Dashboard.

    TCP 隧道则只显示一行:TCP => <YOUR_ADDRESS>:<PORT> => 127.0.0.1:<LOCAL_PORT>。

  5. 保持窗口打开 #

    命令连接后隧道会自动启动,你不需要选择启动。命令运行多久,隧道就在线多久。关闭窗口会断开连接,公网地址也不再响应。如需自己结束命令,请输入 exit 并按 Enter,或按 Ctrl + C。

    结束命令并不会停止控制台中的隧道。隧道仍处于已启动状态,只是连接显示为断开,这样同一条命令还能再次连接。用完隧道后,请在控制台中为它选择停止。控制台只会为已停止的隧道签发新的 SSH 命令。

通过隧道设置向导 #

控制台上的隧道设置向导也提供同样的命令。在最后一步选择平台时,选择 SSH,然后选择获取 SSH 命令。SSH 选项只会出现在 HTTP 和 TCP 隧道中。在你的命令连接之前,向导显示等待 SSH 连接,连接之后显示已通过 SSH 连接。自动重连会加上同样的重连循环,获取新命令则会替换已过期的命令。

命令详解 #

命令的结构始终如下,控制台会为你的隧道填入具体的值:

Bash
ssh -o ExitOnForwardFailure=yes -o ServerAliveInterval=15 -o ServerAliveCountMax=3 -o ConnectTimeout=15 -o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null -o LogLevel=ERROR -p 223 -l <COMMAND_KEY> <TUNNEL_ADDRESS> -R<SERVER_PORT>:<LOCAL_IP>:<LOCAL_PORT>
部分作用
-p 223连接到 223 端口,Localtonet 在该端口接受这类 SSH 连接。
-l <COMMAND_KEY>登录名。它是控制台为这条隧道生成的密钥,不是你的 AuthToken,也不是账户密码。它告诉 Localtonet 要启动哪条隧道,因此不需要输入密码。
<TUNNEL_ADDRESS>你的隧道的地址。SSH 连接会指向承载它的服务器。
-R<SERVER_PORT>:<LOCAL_IP>:<LOCAL_PORT>远程转发:服务器上到达该隧道的连接,会通过 SSH 连接发送到 <LOCAL_IP>:<LOCAL_PORT>。最后两个值就是隧道的本地 IP 地址和本地端口。服务器端口由 Localtonet 分配,不得修改。
-o ExitOnForwardFailure=yes如果无法建立转发,就让 ssh 退出,而不是保持连接却没有可用的隧道。
-o ServerAliveInterval=15 -o ServerAliveCountMax=3每 15 秒发送一次保活包,连续三次无响应后断开连接,因此约 45 秒内就能发现连接已失效。
-o ConnectTimeout=15如果无法连上服务器,15 秒后放弃。
-o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null跳过主机密钥确认,也不会把服务器写入你的 known_hosts 文件。
-o LogLevel=ERROR隐藏 ssh 的提示信息,错误仍会显示。

由于 <LOCAL_IP> 是在你运行 ssh 的那台机器上解析的,服务不一定要在这台机器上。如果使用 192.168.1.20 这样的本地地址,命令会转发到同一网络中的另一台设备。

不要分享这条命令。只要命令仍然有效,谁运行它,谁就会响应你的隧道的流量。

自动重连 #

开启自动重连后,控制台会把同一条 ssh 命令包进一个针对你所选 shell 的小脚本中。对于命令提示符,脚本以单行 powershell -NoProfile -EncodedCommand … 的形式提供。脚本在每种 shell 中的行为都相同:

  • 当 ssh 结束时,它会等待一段时间后重新启动。等待时间从约 10 秒开始,每次失败后翻倍,最长约 2 分钟。
  • 持续至少 60 秒的连接算作成功,并会重置等待时间。
  • 连续 8 次尝试都在 60 秒内结束后,它会停止并输出 SSH reconnect stopped. If a session or bandwidth limit was reached, get a new SSH command from the panel.

重连使用的是同一条命令。网络中断后这样可行,但如果隧道已在控制台中停止或已达到限制就不行;这时脚本会放弃,你需要获取新命令。

命令的有效期 #

  • 首次使用前:必须在控制台签发命令时显示的时间内运行它。超过这个时间,端口分配就会失效。
  • 使用期间:每条隧道只允许一个 SSH 会话。第一份命令仍在连接时,命令的第二份副本会被拒绝。
  • 连接结束后:只要隧道没有在控制台中停止、也没有达到限制,同一条命令可以再次连接。
  • 停止后:当隧道在控制台中被停止,或因达到限制而停止时,这条命令就失效了。请再次打开显示 SSH 命令获取新命令。

控制台只会在隧道处于停止状态时签发命令。新命令可能带有不同的服务器端口;在免费版中,每条新命令都会得到新的端口。对于 TCP 隧道,该端口是公网地址的一部分,因此请求新命令后,请检查终端输出或隧道列表中的地址。隧道的活动日志会把这一变化记录为 Server port changed to "…" for SSH.

限制 #

  • 免费版的会话限制。通过 SSH 启动的隧道与通过客户端启动的隧道遵循相同的规则:在免费版中,TCP 隧道会在 30 分钟后停止,之后可以再次启动,HTTP 隧道没有时间限制。这 30 分钟从命令第一次连接时开始计算;用同一条命令重连不会重新计时。当 TCP 会话达到限制时,服务器会关闭 SSH 连接,并给出消息 Session time limit reached. Get a new SSH command from the panel. 请参阅套餐与余额。
  • 带宽。流量与其他隧道流量一样计入你的带宽。如果没有剩余带宽,就不会签发命令,服务器也会关闭正在运行的会话,并给出消息 Bandwidth limit reached. Get a new command after bandwidth is available.
  • 仅支持反向转发。SSH 端点只接受命令中的那一个转发。它不会给你 Localtonet 服务器上的 shell,也不支持其他任何类型的转发。
  • 每条命令对应一条隧道。如需运行多条隧道,请为每条隧道获取一条命令,并在各自的终端中运行。

你在控制台中看到的内容 #

命令连接期间,隧道显示为已启动,请求也会像往常一样出现在它的日志中。命令连接时,隧道的活动日志会记录 Tunnel started over SSH. 请参阅日志与检查。

故障排查 #

控制台中的消息 #

消息怎么做
请求 SSH 命令前,请先停止隧道。该隧道正通过 Localtonet 客户端运行。请先停止它,然后再次选择显示 SSH 命令。
请求新命令前,请先停止当前的 SSH 隧道。该隧道仍处于通过 SSH 启动的状态,或者它的某个 SSH 会话刚刚还处于活动状态。请结束正在运行的 ssh 命令,为该隧道选择停止,然后重试。
已有客户端使用你创建的 AuthToken 连接到此隧道。请创建新的 AuthToken。有 Localtonet 客户端正在使用该隧道的令牌登录。请停止该客户端,或在我的令牌中创建另一个令牌并用于这条隧道。
你的剩余带宽不足,无法启动隧道。你的带宽已用完。请参阅套餐与余额。
此功能不适用于该协议类型。该隧道不是 HTTP 或 TCP 隧道。
此服务器不支持此功能。请将你的隧道迁移到其他服务器。该隧道所在的服务器不提供 SSH 命令。请在其他服务器上创建隧道。
有隧道操作正在进行中,请稍等片刻后重试。请等待几秒钟后重试。
无法分配新的服务器端口。请重试。如果仍然失败,请在其他服务器上创建隧道。
无法保存 SSH 端口,请重试。请重试。

终端中的消息 #

当服务器关闭会话时,会把下列消息之一作为原因发送。原因如何显示取决于你的 ssh 客户端。

消息或现象原因与解决办法
ssh 立即结束并报认证错误,通常是 Permission deniedLocaltonet 未接受该命令。可能是没有及时运行、命令签发后隧道已被停止或已达到限制、同一条命令的另一个会话已在连接,或者复制时文本被改动。请从控制台获取新命令,并原样粘贴。
Port mismatch. Get a new SSH command from the panel.-R 后面的服务器端口不是 Localtonet 分配的那个。请严格按签发的原样使用命令。
Session time limit reached. Get a new SSH command from the panel.免费版中 TCP 隧道的 30 分钟会话已结束。请获取新命令以重新启动。
Bandwidth limit reached. Get a new command after bandwidth is available.你的带宽已用完。
Session stopped. Get a new SSH command from the panel.隧道已被停止,例如在控制台中停止。
连接超时,或 Connection refused该机器无法通过 223 端口连接到服务器。请在防火墙中允许向 223 端口发起出站 TCP 连接,或换一个网络再试。
隧道在线,但访问者看到错误ssh 已连接,但无法访问你的服务。请检查服务是否在运行,以及隧道的本地 IP 地址和本地端口是否正确。修改之后,请重新获取命令,因为旧命令里仍是旧的值。
支持