httplab:在终端里玩转 HTTP 的交互式服务器
一、这是什么?
日常开发里,我们经常需要这么一个东西:临时起一个 HTTP 服务器,把收到的请求原样展示出来,最好还能随手改一改响应、调一调状态码、模拟一下慢请求。用 Postman 做 mock 太重,自己写个 net/http 又太麻烦,nc -l 又太原始。
httplab 正好填补了这个空隙——它是一个交互式的 Web 服务器,完全跑在终端里,用 TUI(Terminal UI)的形式实时展示每一个进来的请求,并且允许你在请求之间来回切换、编辑响应、控制行为。
一句话总结:它像是一个”可交互的 HTTP 抓包 + Mock 服务器”,Redis 风格的终端界面,用 Go 写成,单个二进制即可运行。
二、为什么值得一试
和常见的 mock 工具有几个明显的差异点:
- 零配置文件:不需要写 JSON/YAML 来描述响应,运行时直接在终端里改。
- 真·实时:请求一进来,界面立即刷新,能看到请求头、请求体、方法、路径。
- 响应可编辑:每个请求的响应体、状态码、Headers 都可以在 UI 里当场改,甚至可以为不同的请求设置不同响应。
- 单文件部署:
go install或下载 release 二进制即可,无依赖。 - 终端原生:适合 SSH 到服务器上调试,或者在没有图形界面的环境里工作。
三、安装
最简单的方式是用 go install:
go install github.com/qustavo/httplab@latest
也可以直接去 Release 页面下载对应平台的二进制,丢进 PATH 就能用。
四、快速上手
启动一个监听 10000 端口的 httplab:
httplab -port 10000
然后随便发个请求:
curl -i -X POST http://localhost:10000/hello -d '{"name":"gopher"}'
你会看到终端界面下方实时滚动出请求详情,包括:
- HTTP 方法、路径、协议版本
- 所有请求头
- 请求体内容(对 JSON、form 等有友好展示)
- 客户端 IP、时间戳
关键交互
熟悉 Vim 的同学会很快上手,核心操作大致是:
| 按键 | 作用 |
|---|---|
↑ / ↓ 或 j / k |
在请求列表与响应区域之间切换焦点 |
Tab |
切换面板 |
e |
编辑当前选中请求的响应体 |
s |
修改响应状态码 |
h |
修改响应 Headers |
q / Ctrl+C |
退出 |
实际用起来就是:收请求 → 选中它 → 按 e 改响应 → 下一个请求就能看到改动生效。整个过程不用离开终端。
五、代码视角:它内部怎么做的
httplab 的架构其实非常清晰,值得拿来读一读源码学习。
1. 一个 net/http 服务器 + 内存队列
核心是一个标准的 http.Handler,它把每个进来的请求封装成一个结构体,塞进一个带锁的队列(也用到 channel 通知 UI 刷新):
type Request struct {
Method string
URL string
Proto string
Header http.Header
Body string
...
}
UI 层从队列里读取并展示。请求与响应数据在内存里共享,所以你在 UI 里改响应,handler 直接返回改后的结果——这就是”可交互”的本质。
2. TUI 使用 gocui
界面部分依赖 github.com/jroimartin/gocui,这是一个轻量级的终端 UI 库,基于 termbox-go。用它可以像切积木一样布局多个 view(请求列表、请求详情、响应编辑器、状态栏等),绑上按键回调。
代码里通常能看到这样的模式:
g.SetKeybinding("requests", 'e', gocui.ModNone, editResponse)
g.SetKeybinding("", gocui.KeyCtrlC, gocui.ModNone, quit)
3. 编辑响应
响应体编辑用一个单独的 view,绑定 Enter 保存、Esc 取消。状态码和 headers 也各自有对应的编辑 view。因为没有落盘,全部状态在进程内存里,改完即生效。
整体代码量不大(核心逻辑千行左右),非常适合作为学习 Go + TUI 编程的入门仓库。
六、典型使用场景
- 调试客户端:后端还没写好时,前端或 App 直接对着 httplab 发请求,模拟各种响应。
- 验证回调:对接第三方 webhook(支付、GitHub、Stripe),用 httplab 起个公网可达的服务先把请求收下来看结构,再决定怎么写处理逻辑。
- 教学演示:给学生讲 HTTP 协议时,实时看到请求长什么样,比看抓包工具更直观。
- 接线临时服务:内网环境里快速起一个能返回固定内容的 endpoint。
- 排查乱发的请求:线上有人一直往一个不存在路径打请求?本机起一个 httplab,把流量导过来看看究竟发了什么。
七、限制与注意事项
- 不是生产级工具:没有 TLS、没有认证、没有限流,别拿它当正式服务。
- 不支持持久化配置:所有状态都在内存里,重启丢失。如果要做长期 mock,用
wiremock、moco之类的更合适。 - 并发下的响应语义:如果同一时刻有多个请求,编辑响应会有”最后编辑者生效”的效果,需要留意。
- 社区活跃度一般:项目代码稳定但更新不频繁,功能相对基础。追求更丰富的 mock 能力,可以看
httpbin、hurl、mitmproxy等。
八、总结
httplab 的定位非常克制——它不是要做一个全功能的 mock 平台,而是把”在终端里看一眼、改一下“这件小事做到极致。对于经常在命令行里工作的 Gopher 来说,它是一个顺手的小工具;对于学 Go 的人,它又是一个不错的 TUI + HTTP 源码范本。
如果你以前是写个 20 行的 http.HandleFunc 然后 fmt.Println 来调试请求,不妨试试把它换成 httplab——你会发现体验顺畅不少。
仓库地址:https://github.com/qustavo/httplab
建议搭配curl、httpie、websocat一起使用,效果更佳。



还没有评论,来说两句吧...