跳到内容
Localtonet Localtonet 控制台

隧道设置参考

获取本页帮助
本页内容 15 个章节
  1. 打开隧道的设置
  2. 打开隧道类型的页面
  3. 在隧道行中选择“设置”
  4. 更改设置
  5. 更改如何生效
  6. 哪种隧道类型有哪些设置
  7. 每项设置的作用
  8. 隧道详情
  9. 隧道备注
  10. 本地 HTTPS?
  11. PROXY 协议?
  12. 旧版连接?
  13. 本地服务器 IP
  14. 隧道 IP
  15. 隧道列表中的设置
  16. 更换服务器
  17. 更换 AuthToken
  18. Web 应用防火墙
  19. 通过 API 使用相同的设置
  20. 故障排除
  21. 相关页面

每个隧道在控制台中都有一个设置面板。本页说明在哪里打开它,列出每项设置,告诉你哪些隧道类型有这项设置,并链接到详细讲解它的页面。

打开隧道的设置 #

  1. 打开隧道类型的页面 #

    在控制台菜单中打开 我的隧道,然后选择类型:我的隧道 › HTTP、TCP - UDP、TLS、文件服务器、代理服务器、轮换代理 或 MCP 网关。

  2. 在隧道行中选择“设置” #

    在 你的隧道 下找到该隧道,在 操作 列中选择 设置。隧道设置 面板会在页面一侧打开。

  3. 更改设置 #

    面板包含以下部分:

    • 隧道详情:隧道的地址、创建日期和 AuthToken 名称等详细信息,以及你可以通过点击来编辑的值:所有隧道类型都可以编辑标题,HTTP、TCP - UDP 和 TLS 隧道还可以编辑本地地址和本地端口。
    • 隧道的负载均衡目标(仅限支持负载均衡的隧道类型)。参见 负载均衡。
    • 显示 SSH 命令,适用于可以直接用 SSH 启动的隧道类型。参见 免安装 SSH。
    • 设置:每项设置占一行。每一行要么是 是 / 否 开关,要么是会打开对话框的按钮(管理、更换、显示 或 清除)。标签旁边的信息图标会用一句话解释该设置。

    大多数开关在更改前都会请你确认,例如 开启仅限 HTTPS?,带有 开启 和 取消 按钮。开启 基本认证? 或 重写路径? 会打开一个对话框;在运行中的隧道上开启 保留端口? 则会不经询问直接保留该端口。

更改如何生效 #

有些设置会在不中断的情况下应用到运行中的隧道;另一些设置会先停止隧道,再用新值重新启动,这需要片刻时间,并且会断开已打开的连接。

无需重启即可生效会重启运行中的隧道
仅限 HTTPS?、重写路径?、启用 HTTP/3?、保留端口?、HTTP 头、HTTP 超时、隧道备注、IP 限制、到期日期、出站端口、带宽限制、带宽用量、WAF 开关 隧道详情 中的标题、本地地址和本地端口,基本认证?、本地 HTTPS?、PROXY 协议?、旧版连接?、服务器端口、参数、本地服务器 IP、速度限制、更换服务器、更换 AuthToken

会重启隧道的设置,只有在隧道所在设备上的 Localtonet 应用已连接时,才能保存到运行中的隧道。否则控制台会提示“请检查设备连接。”,并保留旧值。对于已停止的隧道,该值会被保存,并在下次启动时使用。

哪种隧道类型有哪些设置 #

标签与 设置 部分显示的一致。“是”表示该隧道类型有这一行。

设置HTTPTCP - UDPTLS文件服务器代理服务器轮换代理MCP 网关
仅限 HTTPS?是–––––是
重写路径?是––––––
基本认证?是––是,类型为 Default––是
本地 HTTPS?是是,UDP 除外是––––
启用 HTTP/3?是–––––是
保留端口?–是––是是–
PROXY 协议?–是,UDP 除外–––––
旧版连接?是是是是是–是
SSL 模式––是––––
SSO 提供商是,团队隧道除外––––––
网关令牌––––––是
HTTP 头是––––––
HTTP 超时是–––––是
服务器端口–是––是,VLESS 除外是–
隧道备注是是是是是是是
本地服务器 IP仅限本地服务器仅限本地服务器仅限本地服务器–仅限本地服务器–仅限本地服务器
参数是是是–是––
IP 限制是是是是是是是
到期日期是是是是是–是
速度限制是是是是是–是
出站端口是是是是是是是
带宽限制是是是是是–是
带宽流量是是是是是是是
带宽用量是是是是是–是
隧道 IP–是是–是是–
请求日志是是是是是–是
活动日志是是是是是是是
隧道健康状态是是是–是是是

代理服务器和轮换代理页面还有各自的行,例如 代理认证、访问控制、上游代理设置、VPN 访问、网速测试、隧道令牌 和 仅限 IPv4?。它们在 代理服务器 和 轮换代理 中有说明。使用 本地 服务器的隧道没有 出站端口 行。“仅限本地服务器”也包括 服务器 列显示 VPN 的隧道。

每项设置的作用 #

设置作用详情
仅限 HTTPS?只通过 HTTPS 提供公网 URL。HTTP 头与重写
重写路径?在每个请求到达你的本地服务之前,在其前面添加一段路径。HTTP 头与重写
基本认证?要求访问者输入用户名和密码。访问控制
本地 HTTPS?告诉隧道:你的本地服务本身使用 HTTPS 或 TLS。本页
启用 HTTP/3?允许客户端通过 HTTP/3 访问公网 URL。HTTP 头与重写
保留端口?隧道重启时保持相同的服务器端口。端口
PROXY 协议?在 PROXY 协议头中,把原始客户端地址传递给你的服务。本页
旧版连接?一种备用连接方式,当隧道无法用常规方式连接时可以尝试。本页
SSL 模式选择由 Localtonet 为 TLS 隧道处理 HTTPS,还是把加密流量直接透传给你的服务。TLS
SSO 提供商要求访问者先用你的某个身份提供商登录,才能打开隧道。单点登录
网关令牌显示你的 MCP 客户端连接网关时发送的令牌。MCP 网关
HTTP 头添加固定的请求头和响应头。HTTP 头与重写
HTTP 超时设置隧道等待你的服务响应请求的时长。HTTP 头与重写
服务器端口更改人们在 Localtonet 服务器上连接的端口。端口
隧道备注一条私人提醒,记录这个隧道的用途。本页
本地服务器 IP可以访问你的本地服务器的地址。本页
参数让隧道通过设备上的指定网络。网络选择
IP 限制选择哪些 IP 地址可以连接到隧道。访问控制
到期日期在设定的日期停止隧道。限制与到期
速度限制限制上传和下载速度。限制与到期
出站端口固定 Localtonet 应用对外连接所用的端口,适用于严格的防火墙。端口
带宽限制在隧道传输了设定的数据量之后停止隧道。限制与到期
带宽流量以图表显示经过隧道的数据。限制与到期
带宽用量把隧道的数据计数器重置为零。限制与到期
隧道 IP显示隧道所在服务器的 IP 地址。本页
请求日志显示为隧道记录的请求或连接。日志与检查
活动日志列出启动、停止和设置更改。日志与检查
隧道健康状态显示定期健康检查的结果。日志与检查

隧道详情 #

点击 隧道详情 中的某个值即可编辑。保存这三项中的任何一项都会重启运行中的隧道。HTTP、TCP - UDP 和 TLS 隧道可以在这里编辑本地地址和本地端口;其他隧道类型只显示标题。

对话框填写内容规则
重命名隧道一个你在隧道列表中容易辨认的名称,例如“Office NAS”。必填。最多 30 个字符:对话框最多计到 100,但超过 30 个字符的标题会被拒绝,并提示“标题不能超过 30 个字符。”
本地地址Localtonet 应用查找你的服务的位置。如果服务与应用运行在同一台设备上,请使用 127.0.0.1。要访问网络中的另一台设备,请输入它的地址,例如 192.168.1.20。IPv4 地址、IPv6 地址或主机名。不要带 http://、路径或端口。
本地端口你的服务在其所在设备上监听的端口。1 到 65535 之间的数字。

隧道备注 #

隧道备注 › 管理 会打开 备注 对话框。备注是对隧道用途的提醒,只有你的账户能看到。

  • 备注最多可以有 499 个字符。对话框会在你输入时计数。
  • 标签 下的选项会在备注前加上一个标签:生产、预发布、测试、演示 或 临时。备注随后会以类似 Staging - 的内容开头。选择另一个标签会替换原有的标签。

本地 HTTPS? #

当你的本地服务本身使用 HTTPS 或 TLS 时,请开启 本地 HTTPS?,例如只监听 https://localhost 的开发服务器。如果服务使用的是纯 HTTP 或纯 TCP,请保持关闭。HTTP、TCP 和 TLS 隧道有这个开关;UDP 隧道没有。

PROXY 协议? #

开启 PROXY 协议? 后,隧道会在 PROXY 协议头中把原始客户端地址传递给你的服务。只有在你的服务已配置为读取该协议头时才开启它,因为不期望该协议头的服务会在每个连接开头看到未知字节。TCP 隧道有这个开关;UDP 隧道没有。

旧版连接? #

旧版连接? 会把隧道切换到另一种连接方式。如果隧道无法用常规方式连接,可以试试它;如果没有帮助,请再把它关掉。

本地服务器 IP #

只有 服务器 列显示 本地 或 VPN 的隧道才有这一行。本地服务器 IP 对话框保存可以访问你的本地服务器的地址:一个 IPv4 地址,以及可选的 IPv6 地址。如果不使用 IPv6,请留空。至少需要一个地址。只能在设备本机上使用的地址,例如 127.0.0.1、0.0.0.0 或 ::1,会被拒绝,并提示“本地服务器 IP 必须可从外部访问。”

隧道 IP #

隧道 IP › 显示 会打开 服务器 IP 对话框,其中有隧道所在服务器的 IPv4 地址,以及(如果服务器有)IPv6 地址。客户端可以使用这个地址而不是域名来连接隧道。

服务器 IP 地址可能会变化。 在应用和脚本中请尽量使用域名。

隧道列表中的设置 #

有两项设置是在隧道列表中更改的,而不是在面板中。

更换服务器 #

在 服务器 列中选择服务器代码,在 更换服务器 对话框中选择另一台服务器,然后选择 提交。运行中的隧道会在新服务器上重启。

  • 更换服务器需要有余额。没有余额时,控制台会提示“你需要购买余额才能使用此功能。”
  • 如果隧道的服务器端口在新服务器上已被占用,你会看到“你的隧道端口(PORT)在所选服务器上不可用。请先更改端口。”请按 端口 中的说明更改端口,然后重试。
  • 服务器 列显示 本地 或 VPN 的隧道无法移动。

更换服务器后,DNS 更新最多可能需要 3 小时。

更换 AuthToken #

在 AuthToken 列中选择令牌名称即可打开 更换 AuthToken,选择另一个 AuthToken,然后选择 提交。这会把隧道移到运行使用该令牌的 Localtonet 应用的设备上。

  • 运行中的隧道会先停止,等待 2 秒,然后使用所选的 AuthToken 重新启动。已停止的隧道保持停止。
  • 如果使用新令牌的应用没有连接,令牌仍会被更换,同时你会看到“AuthToken 已更新,但隧道无法重启。请使用所选令牌连接 Localtonet 应用并启动隧道。”
  • 轮换代理隧道使用 AuthToken 组。请改为更改这些组。

AuthToken 在 AuthToken 中有说明。

Web 应用防火墙 #

HTTP 和 MCP 网关隧道在 操作 列中还有一个盾牌按钮,用于打开该隧道的防火墙。参见 Web 应用防火墙。

通过 API 使用相同的设置 #

大多数设置也可以通过 API 在隧道的路径下读取和更改。身份验证和完整参考见 API。

设置/api/v2/tunnels/<TUNNEL_ID>/ 之后的路径
IP 限制ip-restrictions
HTTP 头headers, host-header
基本认证authentication
到期日期expiration
服务器端口server-port
HTTP 超时http-timeout
速度限制rate-limit
带宽限制和用量bandwidth-limit, bandwidth-usage, bandwidth-usage/reset
参数arguments
仅限 HTTPS?、启用 HTTP/3?、重写路径?https-only, http3, path-rewrite
本地 HTTPS?、PROXY 协议?、SSL 模式ssl-stream, proxy-protocol, pass-through
隧道备注note
服务器server

故障排除 #

“请检查设备连接。”

该设置会重启隧道,而隧道所在设备上的 Localtonet 应用没有连接。请在设备上启动应用,等到 连接 列显示 开,然后再次保存。你也可以先停止隧道:对于已停止的隧道,值会被保存,不需要重启。

“你需要购买余额才能使用此功能。”

该设置需要账户有余额。这适用于保留端口、自定义服务器端口、固定出站端口、IP 限制和更换服务器。参见 套餐与余额。

“你没有更新此隧道的权限。”

你在团队中工作,而你的角色不包括更改隧道。请让团队所有者授予你这项权限。参见 团队管理。

我的面板中缺少表格里的某一行

面板只显示该隧道类型对应的行,少数行还取决于隧道本身:本地服务器 IP 需要 本地 或 VPN 服务器,团队隧道不显示 SSO 提供商,UDP 隧道没有 本地 HTTPS? 和 PROXY 协议?。

支持