Repolode
unkn0wn-root

unkn0wn-root/resterm

终端 API 客户端,把 HTTP、GraphQL、gRPC、WebSocket 和 SSE 请求保存为可放入 git 管理的 .http 文件。

可替代:PostmanInsomnia

Star
1,990
Fork
59
未关闭 Issue
0
最近提交
前天

这是什么?

Resterm 是一个运行在终端里的代码优先 API 客户端,请求、工作流和本地 mock 定义都写成纯文本的 .http 或 .rest 文件,便于阅读、对比差异并放入版本控制。你可以在终端界面中发送请求,也可以用 resterm run 命令在 CI 中执行同一批文件,输出支持文本、JSON 和 JUnit 格式。

除了发送请求,它还支持用 @capture 和 @assert 提取变量与做断言,支持轮询与重试、串联多步骤的工作流,并提供用于逻辑与测试的 RestermScript。它可以把同一请求发送到多个环境进行对比,记录请求各阶段耗时,并统计延迟分位数。认证方面支持 Bearer Token、包括 PKCE 在内的 OAuth 2.0,以及从本地 CLI 获取的令牌。

对于位于 SSH 跳板机后或 Kubernetes 集群内的服务,Resterm 会在发送请求前自动建立隧道或端口转发。同一套文件也可用于启动本地 mock 服务,或通过录制代理把真实流量转换为请求或 mock。可通过 Homebrew、安装脚本、预编译二进制或 go install 安装。

核心功能

  • 01支持 HTTP、GraphQL、带反射的 gRPC、WebSocket 和 SSE 请求
  • 02通过 @capture 和 @assert 提取变量与断言,并支持 @poll 和 @retry
  • 03可串联请求的工作流,支持条件和循环步骤
  • 04支持 OAuth 2.0、TLS 客户端证书,以及按环境隔离的 Cookie 存储
  • 05可从 .http 文件启动本地 mock 服务,并提供录制代理
  • 06resterm run 可在 CI 中运行,输出 JSON 或 JUnit 格式

适用场景

  • 将 API 请求集合与代码放在同一个 git 仓库中管理
  • 在 CI 流水线中执行 API 冒烟测试与契约检查
  • 通过 SSH 跳板机或 Kubernetes 端口转发访问内部 API
  • 在前端或后端开发期间,在本地模拟上游服务

快速上手

  1. 1

    使用 Homebrew 安装(macOS 和 Linux)

    brew install resterm
  2. 2

    创建项目文件夹并初始化示例请求

    mkdir my-api && cd my-api resterm init
  3. 3

    启动终端界面

    resterm

使用前须知

  • Linux 二进制文件需要 glibc 2.32 或更新版本。
  • Resterm 没有内置 AI 功能,也没有 MCP 服务器。

标签

常见问题

resterm 是什么?
终端 API 客户端,把 HTTP、GraphQL、gRPC、WebSocket 和 SSE 请求保存为可放入 git 管理的 .http 文件。 Resterm 是一个运行在终端里的代码优先 API 客户端,请求、工作流和本地 mock 定义都写成纯文本的 .http 或 .rest 文件,便于阅读、对比差异并放入版本控制。你可以在终端界面中发送请求,也可以用 resterm run 命令在 CI 中执行同一批文件,输出支持文本、JSON 和 JUnit 格式。
resterm 可以免费使用吗?用的什么许可证?
resterm 以 Apache-2.0 许可证开源。用于商业产品前,请先确认许可证条款。
resterm 还在维护吗?
活跃维护中。resterm 最近一次提交是在 2026年10月18日。
resterm 适合用来做什么?
将 API 请求集合与代码放在同一个 git 仓库中管理 在 CI 流水线中执行 API 冒烟测试与契约检查 通过 SSH 跳板机或 Kubernetes 端口转发访问内部 API 在前端或后端开发期间,在本地模拟上游服务
resterm 怎么安装和运行?
使用 Homebrew 安装(macOS 和 Linux): brew install resterm 创建项目文件夹并初始化示例请求: mkdir my-api && cd my-api resterm init 启动终端界面: resterm
在哪里获取 resterm?
源代码和安装说明在 GitHub 上:https://github.com/unkn0wn-root/resterm

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目