mockserver-monorepo

一键模拟任意API,拦截流量注入故障,让测试更稳更准

MockServer 是一个用于测试的 HTTP(S) 模拟服务器和代理,旨在解决开发与测试过程中对 API 依赖、网络不稳定及故障注入的需求。它允许你模拟任意 API 的响应,拦截并检查实时流量,还能主动注入故障以验证系统的健壮性。核心能力包括:基于可配置的期望(Expectation)匹配请求并返回预设响应,支持路径、请求头、查询参数、Cookie 等多种匹配方式;提供代理模式,可记录和回放真实流量,便于调试和回归测试;支持 HTTP/1.1、HTTP/2、gRPC、WebSockets、TCP 等多种协议,并在单一端口上运行,降低配置复杂度;同时扩展到 HTTP/3、消息代理(如 Kafka)以及 AI/LLM API 的模拟,适应现代微服务和 AI 应用测试需求。项目采用 Java 编写,提供丰富的客户端库(如 Java、JavaScript、Python)和 CLI,可轻松集成到 CI/CD 流程。

开源 free 开源模型
访问官网 ↗ GitHub ↗ 文档 ↗
GitHub 星标 ★ 4974
维护状态 活跃
是否开源
定价模式 free

项目数据

分类开源模型
开发团队mock-server
所属国家
定价模式free
价格说明开源项目,Apache-2.0许可证,可免费使用和自行部署。
访问状态
是否开源
开源协议Apache-2.0
主要语言Java
技术栈/模型ai,chaos-engineering,grunt-plugin,homebrew,java-client,javascript-client,llm,mcp,mock-server,node-client,node-module,proxy,python,ruby-client,testing
GitHub 星标★ 4974
30天Star增速
HF 下载量
上线时间2013-02-26 00:00:00
最近更新2026-09-22 00:00:00
维护状态活跃
中文支持
访问方式
移动端支持
综合评分
收录时间2026-08-09
浏览次数5

使用教程

难度:入门 约 10 分钟 部署方式:Docker 5 步

⚠ 该项目 README 未提供完整安装说明,以下步骤为通用流程,请以官方文档为准。

环境要求

  • Docker(README 明确说明「Run MockServer with Docker」)
  • Git(用于克隆仓库,获取 examples 下的示例集合)
  • Postman 或 Bruno(可选,用于调用 REST 控制面)
  • Java 环境(项目为 Java 实现,如需自行构建请准备 JDK)

安装与启动步骤

  1. 1克隆仓库

    把仓库拉到本地,examples 目录里包含 Postman 与 Bruno 示例集合,供后续导入使用。

    git clone https://github.com/mock-server/mockserver-monorepo
  2. 2查阅官方文档

    README 未给出完整启动命令,请到官网 Getting started 页面确认最新镜像名、端口与参数。

  3. 3Docker 启动服务

    README 只说明用 Docker 运行 MockServer,具体 docker run 命令以官网为准,不要自行臆测参数。

  4. 4导入 Postman 集合

    在 Postman 中导入 examples/postman,即可创建期望、验证请求并查看已记录的流量。

  5. 5打开 Bruno 集合

    在 Bruno 中通过 Open Collection 打开 examples/bruno,跨平台使用同样的控制面操作。

如何确认成功

在 Postman 或 Bruno 集合中创建一条期望并发送对应请求,能返回预设响应即表示服务已就绪。

常见问题

Q:README 里没有 docker run 命令,怎么启动?

A:节选中 Getting started 的代码块为空,请到官网 https://www.mock-server.com 按最新说明获取镜像名、端口与启动参数。

Q:一定要用 Docker 吗?

A:README 只演示了 Docker 方式,Java 客户端、Node 模块等其他接入方式请查阅官网与仓库文档。

Q:如何模拟大模型接口?

A:README 提到可模拟 OpenAI、Anthropic、Gemini、Bedrock、Azure OpenAI、Ollama 的聊天补全接口,配置见官网。

Q:支持哪些协议?

A:HTTP/1.1 与 HTTPS、HTTP/2、gRPC 与 gRPC-Web、WebSockets、原始 TCP,由同一端口自动识别,无需逐协议配置。

注意事项

  • README 节选在 Getting started 处被截断,代码块为空,因此无法给出可直接执行的启动命令。
  • 示例集合路径为 examples/postman 与 examples/bruno。
  • 完整部署方式与配置项请以官网 https://www.mock-server.com 为准。

核心亮点

  • 支持多协议(HTTP/2、gRPC、WebSocket)单端口监听,简化测试环境配置
  • 强大的期望匹配机制,可按路径、头、参数等灵活定义响应,支持动态模板
  • 内置代理和流量记录功能,可回放真实请求,便于复现和调试问题

不足之处

  • Java 运行时较重,对轻量级测试环境可能增加资源开销
  • 高级功能(如 AI/LLM 模拟)配置复杂,学习曲线较陡

适用场景

  • 微服务架构下的集成测试,模拟依赖服务返回各种响应
  • 前端开发中模拟后端 API,实现前后端并行开发
  • 性能测试和混沌工程中注入网络故障,验证系统韧性

替代项目

WireMock、Mountebank、Hoverfly

项目介绍

mockserver-monorepo 是开源模型领域的开源项目,由 mock-server 开发,2013 年首次发布。

在全站 13,014 个收录项目中,它的 GitHub 星标数(4,974)位列前 9%,在开源模型分类的 422 个项目里位列前 13%。

近 41 天,它的 GitHub 星标从 4,937 增加到 4,974,净增 37。

项目目前处于活跃维护状态,最近一次代码更新于 2026-09-22。Apache-2.0许可证,可免费使用和自行部署。

它主要面向的使用场景是:微服务架构下的集成测试,模拟依赖服务返回各种响应。同类可对比的替代方案包括 WireMock、Mountebank、Hoverfly。

上一篇:Huatuo-Llama-Med-Chinese

下一篇:ultravox

同类项目推荐

Machine-Learning 开源

跟着博客笔记,边看边跑机器学习代码

All content related to machine learning from my blog

★ 115 2026-08-09
CoreML-Models 开源

下载即用的苹果端 AI 模型库,免去转换烦恼

Core ML model zoo for iOS/macOS — PyTorch models converted to ready-to-use .mlpacka···

★ 1873 2026-08-10