日志与请求检查
本页内容 8 个章节
查看隧道上发生了什么:检查并重放它收到的 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 | 控制台。 |
| API | API。 |
| CLI | 命令行。 |
| 系统 | Localtonet 本身,例如达到某个限制时。 |
典型的记录:
- 隧道已启动。
- 隧道已停止。
- 本地端口已从“3000”更改为“8080”。
- 已添加 IP 限制:“203.0.113.10”
- 已更改带宽限制:“10.00 GB”
- 已关闭到期日期。
新设置或更改的密码不会写入日志,它会显示为“已设置密码。”或“已更改密码。”
隧道健康状态 #
隧道健康状态 › 显示会打开健康检查对话框。Localtonet 每 10 分钟检查一次隧道。每个方块代表当天某个时刻的一次检查。
| 值 | 含义 |
|---|---|
| 正常 | 进行该次检查时,隧道处于已连接状态。 |
| 异常 | 进行该次检查时,隧道未连接。 |
| 未知 | 该时间点及更早的任何时间点都没有结果。 |
| 无数据 | 今天还没到这个时间。 |
| 在线率 | 在正常和异常的检查中,正常检查所占的比例。 |
当对话框没有方块可显示时,它会提示“尚无检查记录。隧道运行一段时间后,结果会显示在这里。”
隧道停止时 #
请先打开隧道的活动日志。最新的“已停止”记录会给出原因。
| 活动日志记录 | 发生了什么 | 怎么做 |
|---|---|---|
| “隧道已停止。” | 有人停止了它。渠道会显示操作来自哪里,例如控制台对应Web,或者 API。 | 选择启动。 |
| “因达到隧道带宽限制,隧道已停止。” | 已达到该隧道自身的带宽限制。 | 提高限制或重置用量。参见限制与到期。 |
| “因已到达到期日期,隧道已停止。” | 该隧道的到期日期已过。 | 设置一个更晚的日期或将其关闭。参见限制与到期。 |
| “因已达到免费使用上限,隧道已停止。” | 已达到免费版的会话限制。 | 选择启动开始新的会话,或充值余额。参见套餐与余额。 |
| “因超出总带宽限制,隧道已停止。” | 账户的带宽已用完。 | 参见套餐与余额。 |
| “因处于非活动状态且无连接,隧道已停止。” | Localtonet 停止了一个已启动但未连接的隧道。 | 保持 Localtonet 应用连接,需要隧道时再选择启动。 |
如果日志中没有停止记录,但地址没有响应,请查看隧道列表的连接列。关表示隧道未连接:请在设备上启动 Localtonet 应用。在应用离线时选择启动,控制台会打开一个标题为“NAME 离线”、内容为“正在等待应用连接…”的对话框。应用一连接,隧道就会自动启动;仍然启动会立即开启隧道,并在应用连接后上线。
故障排除 #
“请先启动你的隧道。”
隧道列表中的检查器按钮只在隧道运行时才能打开。请启动隧道,或者在隧道设置中用请求日志 › 显示打开检查器。
检查器一直为空
请检查三件事:没有显示“请求日志已禁用”横幅;没有启用日期筛选(选择恢复实时);并且请求确实到达了隧道地址,而不是你服务的其他地址。
“尚无请求记录。”或“未找到数据!”
连接日志中没有该隧道的记录,或者在你为 CSV 选择的日期范围内没有记录。请选择其他范围。
“未找到此隧道的日志。”
活动日志还没有记录。它会随着隧道的启动、停止和更改而逐渐增多。