Localtonet 的工作原理
本页内容 10 个章节
你设备上的 Localtonet 客户端会向 Localtonet 服务器建立一条出站的加密隧道。服务器为你的服务提供一个公开地址,并通过这条隧道把流量转发到你选定的本地 IP 地址和端口。
请求的路径 #
- 访问者连接到你隧道的公开地址。该地址属于你所选区域中的一台 Localtonet 服务器。
- Localtonet 服务器把流量送入你设备上的客户端已经建立好的隧道。
- Localtonet 客户端接收流量,并连接到隧道上设置的本地 IP 地址和端口,例如
127.0.0.1:3000。 - 你的服务作出应答,响应沿原路返回。
无需端口转发,无需公网 IP #
连接由你的设备发起,因此不需要开放任何入站端口。你不需要公网 IP 地址,也不必改动路由器。在无法做端口转发的家庭网络和移动网络中,即使处于 NAT 和 CGNAT 之后,它也能工作。
你的网络仍然必须允许出站连接。防火墙或终端安全产品可能会阻止它。
对于 HTTP 和 TCP 隧道,你也可以不使用客户端:隧道设置中会显示一条 SSH 命令,任何带有 SSH 客户端的机器都能用它打开隧道。参见免安装 SSH。
设备与 AuthToken #
AuthToken 把一台设备连接到你的账户。你用它启动客户端,此后在创建隧道时就可以选择这台设备。
- 每台设备一个令牌。请在我的令牌中为每台设备创建一个令牌,并起一个你能认出的名字,例如
Office-PC。名称只是标签,令牌本身由 Localtonet 生成。 - 每个令牌一个连接。使用同一个令牌的新连接会替换之前的连接,所以不要用同一个令牌启动两台设备。
- 在线和离线。Localtonet 应用已连接时,“我的令牌”将设备显示为在线;断开连接时显示为离线,即使它的隧道仍然配置着。
- 请妥善保密。任何拿到令牌的人都可以用它以该设备的身份登录应用。
AuthToken 不能保护隧道。它标识的是你的设备,而不是你的访问者。新建的隧道对任何知道其地址的人都可访问。如需限制访问者,请参见访问控制。
关于令牌的更多内容:AuthToken。
隧道 #
隧道是一组已保存的设置,它把一个公开地址与某台设备上的一项服务关联起来。每条隧道保存:
| 设置 | 决定什么 |
|---|---|
| 隧道类型 | 协议:HTTP、TCP、UDP、TLS、文件服务器、代理服务器等。参见隧道类型。 |
| 设备令牌 | 接收流量的设备。它就是该设备上的客户端启动时所用的令牌。 |
| 服务器区域 | 托管公开地址的 Localtonet 服务器所在位置。 |
| URL 类型 | 公开地址的选择方式。 |
| 本地 IP 地址和本地端口 | 客户端把流量发往何处。如果服务与客户端在同一台设备上,请使用 127.0.0.1。 |
一台设备可以承载多条隧道。“我的令牌”会显示与每个令牌关联的活动隧道数和隧道总数。要把隧道移到另一台设备,请在隧道列表中选择它的令牌名称,然后在更换 AuthToken下选择另一个令牌。运行中的隧道会停止,并用所选令牌重新启动。轮换代理隧道是例外:它们使用令牌组,而不是单个令牌。
从创建到上线 #
- 创建。创建隧道只是保存设置,此时还没有任何内容上线。
- 启动。选择启动。如果该隧道令牌对应的客户端已连接,隧道就会上线。
- 设备离线时启动。控制台会告诉你该令牌处于离线状态,并等待应用连接。仍然启动会立即开启隧道。它被视为活动状态,并在应用连接后上线。
- 停止。公开地址不再应答。隧道及其设置会保留,供以后使用。
- 删除。隧道的接入点和设置都会被移除。
删除令牌会删除它的隧道。使用该令牌的隧道会被停止并删除。
服务器区域 #
服务器区域字段决定隧道的公开地址托管在哪里。控制台的提示是:选择离你的设备较近的区域,以降低延迟。
这个列表是为你的账户生成的。它包含:
- Localtonet 区域,每个国家一项。首页上的网络地图显示了这些位置。
- 你自己的服务器,如果你用服务器管理器添加过的话。只有你的账户能看到它们,列表默认选中你的服务器。
- 本地作为服务器,适用于支持它的隧道类型。参见下文。
你可以移动现有隧道:在隧道列表中选择隧道的服务器,打开更换服务器。这需要余额,并且发生服务器更换时,DNS 更新最长可能需要 3 小时。
公开地址与 URL 类型 #
创建隧道时,URL 类型决定它的公开地址如何选择。
| URL 类型 | 你得到什么 | 套餐 |
|---|---|---|
| 随机子域名 | Localtonet 为你生成一个子域名。你马上就能得到一个地址。 | 免费版 |
| 自定义子域名 | 你自己输入子域名,并选择它所属的域名。 | 需要余额 |
| 自定义域名 | 你使用自己在 DNS 管理器中添加的域名。参见自定义域名。 | 需要余额 |
并非每种隧道类型都提供所有 URL 类型:
| 隧道类型 | 随机子域名 | 自定义子域名 | 自定义域名 |
|---|---|---|---|
| HTTP | 是 | 是 | 是 |
| 文件服务器 | 是 | 是 | 是 |
| MCP 网关 | 是 | 是 | 是 |
| TLS | 是 | 是 | 否 |
| TCP、UDP、UDP / TCP 混合 | 是 | 是 | 否 |
| 代理服务器 | 是 | 是 | 否 |
| 轮换代理 | 是 | 是 | 否 |
TCP、UDP 和代理隧道通过主机名加服务器端口访问。
地址会保持不变吗? #
- HTTP 隧道会保留它的子域名,直到你删除该隧道。
- 对于 TCP、UDP 和代理隧道,在有余额的账户上创建的隧道默认开启保留端口?,这样重启后端口保持不变。你可以按隧道单独切换;参见端口。
- 在免费版中,隧道停止时端口会被释放,因此地址可能会变化。
端到端加密 #
你的设备与 Localtonet 服务器之间的隧道是加密的。但这与访问者和你的服务之间的端到端加密不同:
- 访问者通过 HTTPS 访问 HTTP 隧道,证书由 Localtonet 为你管理。该 HTTPS 在 Localtonet 服务器处终止,而不是在你的服务处。从那里起,流量通过加密隧道传到你的设备。
- 如需端到端加密,请使用直通模式的 TLS 隧道(由你的服务出示它自己的证书),或使用本身已加密的协议,例如 SSH。
客户端断开连接时 #
只有三样东西都在运行时,隧道才能工作:你的设备、Localtonet 客户端和你的本地服务。如果客户端断开连接或被你关闭:
- 访问者无法再通过公开地址访问该服务。
- 设备在“我的令牌”中显示为离线。隧道本身仍保持启动状态。
- 客户端会自行不断尝试重新连接。应用一连接,已启动的隧道就会重新上线。
- 已启动的隧道在启动期间会计费,即使它的设备处于离线状态。停止隧道即可结束计费。参见套餐与余额。
若要让客户端在注销或重启后继续运行,请把它安装为服务:作为服务运行。若要在隧道或令牌断开时收到通知,请设置 Webhook。
本地作为服务器 #
本地作为服务器是服务器区域列表中的一项。选择它时,没有 Localtonet 服务器来托管公开地址。你设备上的 Localtonet 客户端自己打开监听端口,访问者直接连接到你的设备。控制台也把这些隧道称为客户端中继。
- 创建 HTTP、TCP、UDP、TLS、代理服务器和 MCP 网关隧道时可以使用它。文件服务器和轮换代理不提供此选项。
- 选择它后,表单会要求填写中继服务器 IP:即访问者所连接的、你设备的 IP 地址。
- 托管监听端口的设备必须保持连接。
- 客户端中继隧道有自己的、更低的价格。参见套餐与余额。
| 消息 | 怎么做 |
|---|---|
| 请输入本地服务器 IP。 | 填写中继服务器 IP。 |
| 本地服务器 IP 必须可从外部访问。 | 你输入了环回地址或其他仅限本地的地址,例如 127.0.0.1。请输入访问者能够访问到的地址。 |