linuxsuren/api-testing
linuxsuren
这是一款支持HTTP、gRPC和GraphQL等协议的API测试工具，提供多格式报告生成、Mock服务、JMeter文件转换、响应验证等功能，适用于API开发与测试场景。
2 次收藏下载次数: 0状态：社区镜像维护者：linuxsuren仓库类型：镜像最近更新：1 个月前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
镜像概述
这是一个功能丰富的API测试工具，支持多种协议和测试场景，可帮助开发者高效验证API的正确性、性能及稳定性，提供灵活的配置和多种集成方式。
核心功能
- 支持协议：HTTP、gRPC、tRPC
- 多格式测试报告：Markdown、HTML、PDF、标准输出
- 简易配置的Mock Server，支持Open API
- 可转换为JMeter文件
- 响应体字段验证（等式检查或eval表达式）
- JSON Schema响应体验证
- API请求前后处理
- 服务器模式运行，提供gRPC和HTTP端点
- VS Code扩展支持
- 多存储后端：本地、ORM数据库、S3、Git、Etcd等
- HTTP API记录功能
- 多场景安装：CLI、容器、原生服务、Operator、Helm等
- 监控集成：Prometheus、SkyWalking
使用场景
- API开发阶段的功能验证
- 接口性能测试（支持多线程、持续运行）
- 快速搭建Mock服务模拟第三方接口
- 生成标准化测试报告用于团队协作
- Kubernetes环境下的资源验证
配置说明
快速开始
通过hd工具安装：
shellhd install atest
或在Kubernetes部署（参考manifest文件）。
命令行使用示例：
shell# 生成示例测试用例 atest sample # 运行测试套件并生成Markdown报告 atest run -p sample/testsuite-gitlab.yaml --duration 1m --thread 3 --report md
Docker部署
Server模式（带UI）：
bashdocker run --pull always -p 8080:8080 ghcr.io/linuxsuren/api-testing:master
访问http://localhost:8080即可使用UI界面。
Collector模式（记录API请求）：
bashdocker run -p 1234:8080 -v /var/tmp:/var/tmp \ ***-ghcr.xuanyuan.run/linuxsuren/api-testing atest-collector \ --filter-path /api \ -o /var/tmp/sample.yaml # 查看生成的测试用例 cat /var/tmp/sample.yaml
Kubernetes验证配置
设置环境变量：
KUBERNETES_SERVER：Kubernetes API地址KUBERNETES_TOKEN：访问令牌 参考示例文件。
模板与函数
支持模板字段：API地址、请求体、请求头（使用http://masterminds.github.io/sprig/模板引擎）。
扩展函数：
| 名称 | 用法 |
|---|---|
randomKubernetesName | {{randomKubernetesName}} 生成8位随机Kubernetes资源名称 |
sleep | {{sleep(1)}} 在请求前后处理中添加延迟 |
社区交流
- 邮件列表：
api-testing-tech@googlegroups.com - GitHub讨论：https://github.com/LinuxSuRen/api-testing/discussions/new/choose
TODO
- 减少上下文大小
- 支持自定义上下文
限制
- 仅支持解析Map或数组类型的响应体
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 api-testing 镜像标签
docker pull docker.xuanyuan.run/linuxsuren/api-testing:<标签>
DockerHub 原生拉取命令
docker pull linuxsuren/api-testing:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"