隧道设置参考
本页内容 15 个章节
每个隧道在控制台中都有一个设置面板。本页说明在哪里打开它,列出每项设置,告诉你哪些隧道类型有这项设置,并链接到详细讲解它的页面。
打开隧道的设置 #
-
打开隧道类型的页面 #
在控制台菜单中打开 我的隧道,然后选择类型:我的隧道 › HTTP、TCP - UDP、TLS、文件服务器、代理服务器、轮换代理 或 MCP 网关。
-
在隧道行中选择“设置” #
在 你的隧道 下找到该隧道,在 操作 列中选择 设置。隧道设置 面板会在页面一侧打开。
-
更改设置 #
面板包含以下部分:
- 隧道详情:隧道的地址、创建日期和 AuthToken 名称等详细信息,以及你可以通过点击来编辑的值:所有隧道类型都可以编辑标题,HTTP、TCP - UDP 和 TLS 隧道还可以编辑本地地址和本地端口。
- 隧道的负载均衡目标(仅限支持负载均衡的隧道类型)。参见 负载均衡。
- 显示 SSH 命令,适用于可以直接用 SSH 启动的隧道类型。参见 免安装 SSH。
- 设置:每项设置占一行。每一行要么是 是 / 否 开关,要么是会打开对话框的按钮(管理、更换、显示 或 清除)。标签旁边的信息图标会用一句话解释该设置。
大多数开关在更改前都会请你确认,例如 开启仅限 HTTPS?,带有 开启 和 取消 按钮。开启 基本认证? 或 重写路径? 会打开一个对话框;在运行中的隧道上开启 保留端口? 则会不经询问直接保留该端口。
更改如何生效 #
有些设置会在不中断的情况下应用到运行中的隧道;另一些设置会先停止隧道,再用新值重新启动,这需要片刻时间,并且会断开已打开的连接。
| 无需重启即可生效 | 会重启运行中的隧道 |
|---|---|
| 仅限 HTTPS?、重写路径?、启用 HTTP/3?、保留端口?、HTTP 头、HTTP 超时、隧道备注、IP 限制、到期日期、出站端口、带宽限制、带宽用量、WAF 开关 | 隧道详情 中的标题、本地地址和本地端口,基本认证?、本地 HTTPS?、PROXY 协议?、旧版连接?、服务器端口、参数、本地服务器 IP、速度限制、更换服务器、更换 AuthToken |
会重启隧道的设置,只有在隧道所在设备上的 Localtonet 应用已连接时,才能保存到运行中的隧道。否则控制台会提示“请检查设备连接。”,并保留旧值。对于已停止的隧道,该值会被保存,并在下次启动时使用。
哪种隧道类型有哪些设置 #
标签与 设置 部分显示的一致。“是”表示该隧道类型有这一行。
| 设置 | HTTP | TCP - UDP | TLS | 文件服务器 | 代理服务器 | 轮换代理 | 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 协议?。