使用 SSH 客户端启动隧道
免费版 HTTP 和 TCP 隧道
本页内容 11 个章节
无需安装 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 时没有客户端用它登录。如果有客户端正在使用该隧道的令牌连接,控制台会拒绝签发命令。
步骤 #
-
创建 HTTP 或 TCP 隧道 #
打开我的隧道 › HTTP或我的隧道 › TCP - UDP(协议选 TCP),按常规方式创建隧道。本地 IP 地址和本地端口就是 SSH 客户端转发流量的目标:如果你在运行服务的同一台机器上执行命令,就填
127.0.0.1和服务的端口。让隧道保持停止状态。 -
打开 SSH 命令 #
在隧道列表中,选择该隧道的设置,然后选择显示 SSH 命令。SSH 命令对话框会打开,其中是这条隧道的命令。提示会告诉你有多少秒的时间来运行它;未使用的命令会过期,过期后用同样的方式重新获取即可。
-
选择是否自动重连 #
关闭自动重连,得到的就是普通的
ssh命令。开启后,命令会被包进一个循环,在连接断开时重新启动它;然后在运行环境下选择这个循环所用的 shell:PowerShell、命令提示符或 macOS 或 Linux。 -
运行命令 #
复制命令下的文本。在运行你的服务的电脑上打开终端,粘贴命令并按 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>。 -
保持窗口打开 #
命令连接后隧道会自动启动,你不需要选择启动。命令运行多久,隧道就在线多久。关闭窗口会断开连接,公网地址也不再响应。如需自己结束命令,请输入
exit并按 Enter,或按 Ctrl + C。结束命令并不会停止控制台中的隧道。隧道仍处于已启动状态,只是连接显示为断开,这样同一条命令还能再次连接。用完隧道后,请在控制台中为它选择停止。控制台只会为已停止的隧道签发新的 SSH 命令。
通过隧道设置向导 #
控制台上的隧道设置向导也提供同样的命令。在最后一步选择平台时,选择 SSH,然后选择获取 SSH 命令。SSH 选项只会出现在 HTTP 和 TCP 隧道中。在你的命令连接之前,向导显示等待 SSH 连接,连接之后显示已通过 SSH 连接。自动重连会加上同样的重连循环,获取新命令则会替换已过期的命令。
命令详解 #
命令的结构始终如下,控制台会为你的隧道填入具体的值:
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 denied | Localtonet 未接受该命令。可能是没有及时运行、命令签发后隧道已被停止或已达到限制、同一条命令的另一个会话已在连接,或者复制时文本被改动。请从控制台获取新命令,并原样粘贴。 |
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 地址和本地端口是否正确。修改之后,请重新获取命令,因为旧命令里仍是旧的值。 |