跳到内容
Localtonet Localtonet 控制台

日志与请求检查

获取本页帮助
本页内容 8 个章节
  1. 各项功能在哪里
  2. HTTP 隧道的请求检查器
  3. 打开检查器
  4. 请求列表
  5. 请求和响应详情
  6. 重放请求
  7. 关闭和开启请求日志
  8. 其他隧道的连接日志
  9. 将日志下载为 CSV
  10. 活动日志
  11. 隧道健康状态
  12. 隧道停止时
  13. 故障排除
  14. 相关页面

查看隧道上发生了什么:检查并重放它收到的 HTTP 请求,列出对它发起的连接,阅读启动、停止和设置更改的日志,并查看它全天的健康状况。本页还会告诉你隧道停止时该去哪里查看。

各项功能在哪里 #

这些都是隧道设置面板中的行:在我的隧道下打开对应隧道类型的页面,然后在该隧道所在行中选择设置。

行打开的内容隧道类型
请求日志请求检查器,包含已记录的请求和响应。HTTP、MCP 网关
请求日志连接日志:谁在何时连接到了哪里。TCP - UDP、TLS、文件服务器、代理服务器
活动日志隧道的启动、停止和设置更改。所有隧道类型
隧道健康状态定期健康检查的结果。除文件服务器外的所有隧道类型
带宽流量经过隧道的数据量。参见限制与到期。所有隧道类型

轮换代理按客户端保存其请求日志:请使用客户端的请求日志按钮。参见轮换代理。

HTTP 隧道的请求检查器 #

检查器会显示到达 HTTP 或 MCP 网关隧道的 HTTP 请求,包括请求头和请求体,以及你的服务返回的响应。用它调试 Webhook 和 API 调用,无需在自己的代码中添加日志。只有在你按下文所述开启日志后,才会记录请求。

该记录不是逐字节的副本。请求体最多保存 16 KB,并且只保存 JSON、XML、HTML、纯文本和 URL 编码表单数据等文本格式。Authorization、Cookie 和 X-Api-Key 等敏感请求头的值会保存为 [MASKED]。

打开检查器 #

  • 在隧道设置中,选择请求日志 › 显示,或者
  • 在隧道列表中,选择提示为查看请求和响应日志的按钮。如果隧道已停止,这个按钮会要求你先启动隧道。对于服务器列显示本地或 VPN 的隧道,该按钮被禁用,并提示“不适用于客户端中继”。

检查器页面会在新标签页中打开。

请求列表 #

HTTP 请求卡片按从新到旧列出请求,滚动时会加载更多。当徽章显示实时时,列表每 3 秒刷新一次。

列显示内容
方法HTTP 方法,例如 GET 或 POST。
端点被请求的路径。
国家/地区、IP请求来自哪里。
日期时间请求到达的时间,按你浏览器的时间显示。
状态你的服务返回的 HTTP 状态码。
耗时响应花费的时间,单位为秒。

不设筛选时,列表涵盖最近 24 小时。按日期筛选提供今天、昨天、最近 7 天和自定义范围,涵盖今天及之前的六天。设置日期筛选后实时列表会暂停;选择恢复实时即可返回。检查日志最多保留 7 天。

请求和响应详情 #

选择一个请求即可打开其详情。

部分标签页显示内容
请求概要请求 ID、请求 IP、方法、主机、路径、完整 URL、时间戳、URL 长度和请求头数量。
请求HTTP 头每个请求头及其值。
请求请求体请求体。JSON 会被格式化以便阅读。复制可将其复制。
请求IP 情报访问者 IP 地址所在的时区、大洲、国家、城市、邮政编码、地区和坐标。
响应概要响应 ID、状态、响应时间和响应头数量。
响应HTTP 头、正文你的服务返回的内容。

重放请求 #

重放可以省去让发送方再次触发同一个 Webhook 的麻烦。

  • 重放会根据记录再次发送所选请求。一旦请求了重放,页面就会显示“请求已成功重放。”;它不会等待结果。
  • 修改会打开修改请求,你可以在选择重放之前更改方法(GET、POST、PUT、DELETE 或 PATCH)、路径、请求头(添加头)和请求体。

重放的请求由隧道所在设备上的 Localtonet 应用发送,因此该应用必须已连接。

关闭和开启请求日志 #

只有在日志开启期间才会捕获请求,而隧道启动时日志是关闭的。日志关闭时,页面会显示“请求日志已禁用 - 不会捕获新请求。”以及启用日志按钮。禁用日志会再次停止捕获新请求。如果隧道承载的数据不希望被存储,例如请求体中的密码或个人数据,请为该隧道关闭日志。这一更改会以“已更改 HTTP Webhook 设置。”写入活动日志。

其他隧道的连接日志 #

在 TCP - UDP、TLS、文件服务器和代理服务器隧道上,请求日志 › 显示会打开请求日志对话框。它按从新到旧列出对该隧道发起的连接,每页 30 条。

列显示内容
访问者 IP连接到隧道的地址。
客户端 IP为该连接记录的客户端地址。
目标地址连接去往的位置。对于代理隧道,这是所访问的主机和端口。
日期发生的时间,按你账户的时区显示。

此日志只包含连接元数据,不包含通过连接发送的内容。

将日志下载为 CSV #

在下载 CSV下,选择最长 30 天的日期范围,然后选择下载。文件名以 RequestLogs- 开头,后面是隧道的内部标识符,以 .csv 结尾。它包含日期和时间、请求 IP、客户端 IP、目标地址、令牌和协议这几列。如需更长的时间段,请依次下载多个范围。下载限制为每分钟一次,因此两次下载之间请等待一分钟。

活动日志 #

活动日志 › 显示会按从新到旧列出隧道本身发生的事情。每条记录包含按你账户时区显示的日期和时间、操作来自哪个渠道,以及一句说明更改内容的话。

渠道操作来自
Web控制台。
APIAPI。
CLI命令行。
系统Localtonet 本身,例如达到某个限制时。

典型的记录:

  • 隧道已启动。
  • 隧道已停止。
  • 本地端口已从“3000”更改为“8080”。
  • 已添加 IP 限制:“203.0.113.10”
  • 已更改带宽限制:“10.00 GB”
  • 已关闭到期日期。

新设置或更改的密码不会写入日志,它会显示为“已设置密码。”或“已更改密码。”

隧道健康状态 #

隧道健康状态 › 显示会打开健康检查对话框。Localtonet 每 10 分钟检查一次隧道。每个方块代表当天某个时刻的一次检查。

值含义
正常进行该次检查时,隧道处于已连接状态。
异常进行该次检查时,隧道未连接。
未知该时间点及更早的任何时间点都没有结果。
无数据今天还没到这个时间。
在线率在正常和异常的检查中,正常检查所占的比例。

当对话框没有方块可显示时,它会提示“尚无检查记录。隧道运行一段时间后,结果会显示在这里。”

隧道停止时 #

请先打开隧道的活动日志。最新的“已停止”记录会给出原因。

活动日志记录发生了什么怎么做
“隧道已停止。”有人停止了它。渠道会显示操作来自哪里,例如控制台对应Web,或者 API。选择启动。
“因达到隧道带宽限制,隧道已停止。”已达到该隧道自身的带宽限制。提高限制或重置用量。参见限制与到期。
“因已到达到期日期,隧道已停止。”该隧道的到期日期已过。设置一个更晚的日期或将其关闭。参见限制与到期。
“因已达到免费使用上限,隧道已停止。”已达到免费版的会话限制。选择启动开始新的会话,或充值余额。参见套餐与余额。
“因超出总带宽限制,隧道已停止。”账户的带宽已用完。参见套餐与余额。
“因处于非活动状态且无连接,隧道已停止。”Localtonet 停止了一个已启动但未连接的隧道。保持 Localtonet 应用连接,需要隧道时再选择启动。

如果日志中没有停止记录,但地址没有响应,请查看隧道列表的连接列。关表示隧道未连接:请在设备上启动 Localtonet 应用。在应用离线时选择启动,控制台会打开一个标题为“NAME 离线”、内容为“正在等待应用连接…”的对话框。应用一连接,隧道就会自动启动;仍然启动会立即开启隧道,并在应用连接后上线。

隧道掉线时收到通知。控制台的 Webhook 页面可以在隧道连接或断开时,向你的 URL 发送 JSON POST 请求。参见 Webhook。

故障排除 #

“请先启动你的隧道。”

隧道列表中的检查器按钮只在隧道运行时才能打开。请启动隧道,或者在隧道设置中用请求日志 › 显示打开检查器。

检查器一直为空

请检查三件事:没有显示“请求日志已禁用”横幅;没有启用日期筛选(选择恢复实时);并且请求确实到达了隧道地址,而不是你服务的其他地址。

“尚无请求记录。”或“未找到数据!”

连接日志中没有该隧道的记录,或者在你为 CSV 选择的日期范围内没有记录。请选择其他范围。

“未找到此隧道的日志。”

活动日志还没有记录。它会随着隧道的启动、停止和更改而逐渐增多。

支持