HTTP 端点调试台 · 使用说明
本站当你的 HTTP 服务端:开一个端点 URL,把你的客户端 / 设备指过来,实时看它发了什么、并配置端点怎么回。专为调 HTTP 文件传输(尤其 OTA 收发)。
三步上手
- 创建端点 → 得到专属 URL,如
http://120.79.19.193/in/<id>(可带任意子路径)。 - 把你的客户端 / 设备指向这个 URL(GET / POST / PUT / DELETE… 所有方法都接)。
- 右边实时请求看它发的方法 / 路径 / 头 / body / 大小;左边配置端点怎么回。
端点 URL 即凭证(随机不可猜)。端点 7 天空闲自动回收(连同上传的数据)。
调「上传」——客户端往你这传文件
客户端把文件 PUT / POST 到端点,端点会存档 + 算 SHA-256;你在日志里点「下载收到的文件」拿回来核对完整性。
curl -T firmware.bin http://120.79.19.193/in/<id>/upload日志显示 ↑ 上传 9.5 MB · SHA256 … + 下载链接。单文件存档 ≤ 32MB(够固件用),每端点上传总量 ≤ 64MB,超额删最旧。
调「下载」——客户端从你这下载文件
左边「响应模式」选其一,客户端 GET 端点即下载,自动支持 Range 断点续传。
① 提供文件↓
网页上传一个文件(如固件),端点就把它发给客户端。
# 全量下载
curl http://120.79.19.193/in/<id> -o fw.bin
# 分块 / 续传(设备 OTA 常这么干)
curl -r 0-1023 http://120.79.19.193/in/<id> # 期望 206 + Content-Range② 合成文件
不用真传文件,填个字节数直接生成指定大小的文件——测下载 / 续传不用先准备固件。
③ 文本
手配状态码 / 响应头 / body,比如回 206 + Content-Range: bytes 0-9/100,看设备对各种响应怎么反应。
设备侧示例(ESP32 从端点下载,带 Range)
HTTPClient http;
http.begin("http://120.79.19.193/in/<id>/firmware.bin");
http.addHeader("Range", "bytes=0-4095"); // 分块拉取
int code = http.GET(); // 期望 206 Partial Content
// 用 http.getSize() / http.getStream() 把这块写进 flash,循环下一块关于 Range(断点续传)
- 带
Range: bytes=start-end→ 端点回206+Content-Range+ 那一段字节。 - 支持后缀
bytes=-N(最后 N 字节)、开区间bytes=N-;越界回416。 - 不带 Range →
200全量;所有响应都带Accept-Ranges: bytes。
常见问题
- 端点收到请求,但没回我要的内容?
- 看左边「响应模式」——默认「文本」只回
ok;要下载文件得选「提供文件」或「合成文件」并保存。 - 上传的大文件被截断?
- 只是存档上限 32MB;端点仍完整接收并记录总大小,日志会标「仅存前 32MB」。
- 换了端点旧 URL 还能用吗?
- 「换一个端点」生成新 URL,旧的立即失效。
- 数据留多久?
- 请求日志在服务重启时清空;端点与上传 / serve 文件 7 天空闲后自动回收。