跳到内容
Localtonet Localtonet 控制台

让隧道通过指定网络传输

获取本页帮助
本页内容 10 个章节
  1. 开始之前
  2. 步骤
  3. 列出设备的网络
  4. 打开隧道的“参数”设置
  5. 输入网络
  6. 保存
  7. 文本形式的参数
  8. 所选网络的用途
  9. 当网络不可用时
  10. 为整个客户端选择网络
  11. 示例:两个调制解调器上的两个代理
  12. 通过 API 进行同样的设置
  13. 故障排查
  14. 相关页面

当设备有多个互联网连接(例如第二条线路或 USB 调制解调器)时,你可以让某一条隧道通过指定的网络传输,其他隧道继续使用默认连接。你用两个值来选择网络:网络的名称,以及设备在该网络上的 IP 地址。

开始之前 #

  • 一台至少有两个活动网络的设备,并已安装 Localtonet 客户端。参见安装。
  • 隧道类型需要具有参数设置:HTTP、TCP - UDP、TLS 或代理服务器。
  • 在 Linux 上,请以 root 身份运行客户端,或使用免密码的 sudo。客户端通过 ip 命令为所选网络添加路由规则;没有该权限时,流量可能会从默认路由发出。

步骤 #

  1. 列出设备的网络 #

    在设备上运行:

    终端
    localtonet --network

    该命令不需要 AuthToken。它会列出每个活动网络及其 IP 地址,检查每个 IPv4 地址能否访问互联网,然后退出:

    输出
    NetworkName: Ethernet 2
    --net Ethernet 2 --ip 192.168.8.100   --> Internet available (public IP 203.0.113.25)
    --------------------------------------------------
    NetworkName: Wi-Fi
    --net Wi-Fi --ip 192.168.1.20   --> Internet available (public IP 198.51.100.7)
    --net Wi-Fi --ip 2001:db8::20   --> IPv6, internet check not available
    --------------------------------------------------

    每个以 --net 开头的行都是现成的一对网络名称和 IP 地址。请记下你想用的网络对应的那一对。以 No internet access 结尾的行,属于互联网检查失败的地址。列表之后,该命令会打印一段关于 --net 和 --ip 的简短说明。

  2. 打开隧道的“参数”设置 #

    在控制台中,打开该隧道类型的页面,在隧道所在行选择设置,然后选择参数 › 管理。网络选择对话框会打开。

  3. 输入网络 #

    开启使用指定网络,并填写两个字段:

    字段填写内容示例
    网络名称与 localtonet --network 在 NetworkName: 后打印的名称完全一致。Ethernet 2
    设备在该网络中的 IP设备在该网络上的 IPv4 或 IPv6 地址,取自该网络对应的 --net 行。192.168.8.100

    发送给应用会显示最终得到的参数,例如 --net Ethernet 2 --ip 192.168.8.100。

  4. 保存 #

    选择保存。运行中的隧道会重启,此后使用所选网络。

文本形式的参数 #

以文本编辑会把对话框切换为一个参数字段,使用表单则切换回来。文本的格式如下:

--net <NETWORK_NAME> --ip <IP_ADDRESS>
  • --net 和 --ip 必须同时给出。只给其中一个时,隧道没有自己的网络:它使用默认网络,或为整个客户端选定的网络。
  • 含空格的网络名称可以直接写,也可以加引号:--net Wi-Fi 2 --ip 192.168.1.5 和 --net "Wi-Fi 2" --ip 192.168.1.5 的含义相同。
  • 名称先按完全一致来匹配。如果只有大小写不同的名称恰好对应一个网络,也会被接受。
  • IP 地址必须是设备当前在该网络上拥有的地址。

所选网络的用途 #

  • 隧道从设备到 Localtonet 服务器的连接。
  • 对于代理隧道,是直接从设备发往互联网的流量,以及对应的 DNS 查询。如果代理隧道设置了上游代理设置,则到上游代理的连接不会绑定到所选网络。
  • 到你的本地服务的连接,前提是该服务通过所选网络访问。设备本机上的服务(127.0.0.1)或另一个本地网络上的服务,则按常规方式访问。

当网络不可用时 #

当所选网络缺失时,隧道不会回退到默认连接:它的连接会保持关闭。这对代理很重要:流量不能从你所选线路之外的其他线路发出。

  • 如果隧道启动时网络缺失,隧道会等待该网络。
  • 如果网络之后消失,隧道的连接会保持关闭,直到这一对网络名称和 IP 地址重新可用。客户端每隔几秒以及在设备网络变化时都会重新检查,隧道会自动恢复。
  • 如果设备在该网络上获得了不同的 IP 地址,这一对就不再匹配,隧道会保持关闭。请为设备在该网络上设置固定地址,或更新该设置。

使用你的令牌和 --debug 启动客户端(localtonet --authtoken <YOUR_TOKEN> --debug),即可在其错误输出中看到原因。该行以时间戳和 [debug][proxy] 开头,然后依次是隧道的内部标识符、问题,以及它所等待的那一对:

客户端输出
[2026-11-14 10:15:30.123 UTC][debug][proxy] Tunnel <TUNNEL_IDENTIFIER>: Network interface 'Ethernet 2' was not found. Run 'localtonet --network' to list the interfaces. Its connections stay closed until --net Ethernet 2 --ip 192.168.8.100 is available.

它还可能给出的其他问题包括 "'192.168.8.100' is not an address of network interface 'Ethernet 2'."、"Network interface 'Ethernet 2' is Down." 和 "The --ip value is not an IP address."。

为整个客户端选择网络 #

如果要为客户端自身的连接以及所有没有自己网络的隧道选择同一个网络,请在启动客户端时传入相同的两个选项:

终端
localtonet --authtoken <YOUR_TOKEN> --net <NETWORK_NAME> --ip <IP_ADDRESS>
  • 两个选项都是必需的。只给其中一个时,客户端会打印 "--net and --ip must be given together; the default network is used.",并继续使用默认网络。
  • 如果启动时网络不可用,客户端最多等待它 30 秒,然后带着原因停止,而不是在其他网络上运行。
  • 在参数中设置了自己网络的隧道使用它自己的网络。客户端的选项适用于没有自己网络的隧道。

所有命令行选项都列在 CLI 参考中。

示例:两个调制解调器上的两个代理 #

一台电脑有两个 USB 调制解调器。localtonet --network 打印出 --net Modem A --ip 192.168.8.100 和 --net Modem B --ip 192.168.9.100。在该设备的 AuthToken 下创建两条代理服务器隧道。在第一条中,打开参数 › 管理,输入 Modem A 和 192.168.8.100;在第二条中,输入 Modem B 和 192.168.9.100。现在每个代理都从各自的调制解调器出口,拔掉某个调制解调器后,对应的代理就不再传输流量。

通过 API 进行同样的设置 #

隧道的参数可以在 /api/v2/tunnels/<TUNNEL_ID>/arguments 下读取(GET)和设置(PATCH)。发送空值即可删除它们。通过 API 设置的值会在隧道下次启动时生效。参见 API。

请求正文
{ "arguments": "--net Ethernet 2 --ip 192.168.8.100" }

故障排查 #

“请输入网络名称。”或“请输入设备在该网络中的 IP 地址。”

开启使用指定网络时,两个字段都是必填的。若要不再使用指定网络,请关闭该开关并保存。

“请输入 IP 地址,例如 192.168.8.100。”

第二个字段填写设备在该网络上的 IP 地址,而不是网络名称,也不是公网 IP 地址。

“请检查设备连接。”

保存会重启正在运行的隧道,而其设备上的 Localtonet 应用没有连接。请启动应用,或先停止隧道再重新保存。

隧道已启动,但没有任何流量

所选网络很可能不可用。请在设备上运行 localtonet --network,把名称和 IP 地址与设置对比。更正设置,或让该网络重新连通。

在 Linux 上,流量仍然从默认路由发出

客户端很可能无法添加路由规则。请以 root 身份运行它,或允许对 ip 命令使用免密码的 sudo,然后重启客户端。对于没有报告网关的网络,客户端不会添加规则。

localtonet --network 打印 "No active network interface with an IP address was found."

设备上没有已启动且带有地址的网络。请连接一个网络,然后再次运行该命令。

支持