outofcoffee/imposter

Imposter：可编写脚本的多用途模拟服务器## 概述Imposter 是一个可靠、可编写脚本且可扩展的模拟服务器，适用于通用 REST API、OpenAPI（又名 Swagger）规范、Salesforce 和 HBase API。支持 JavaScript 或 Groovy/Java 脚本编写，可通过静态文件提供模拟响应或自定义行为，高级用户还可使用 JVM 语言编写自定义插件。

核心功能和特性-** 多服务模拟 **：支持 REST API、OpenAPI（Swagger）、Salesforce 和 HBase 等多种服务类型。

-** 脚本扩展 ：通过 JavaScript 或 Groovy/Java 自定义模拟行为，满足复杂业务场景需求。 - 插件化架构 ：提供多种专用插件，同时支持用户使用 JVM 语言开发自定义插件。 - 灵活配置 ：基于配置文件定义模拟规则，支持静态响应文件或动态脚本逻辑。 - 轻量部署 **：可通过 Docker 快速启动，便于集成到开发、测试流程中。

使用场景和适用范围### 主要应用场景-** 独立模拟服务 **：替代真实系统运行模拟服务器，降低对外部依赖的依赖。

-** 测试与 QA 支持 ：将 OpenAPI 规范转换为可直接调用的模拟 API，加速测试验证。 - 临时 API 搭建 ：为前端团队提供临时 API 服务，支持并行开发。 - 集成测试解耦 **：隔离集成测试与云服务/后端系统，提升测试稳定性和可控性。

使用方法和配置说明### Docker 部署示例假设配置文件位于本地 config 目录，通过以下命令启动 Imposter 模拟服务器：

bash
docker run -ti -p 8443:8443 \
    -v $(pwd)/config:/opt/imposter/config \
    outofcoffee/imposter-rest

参数说明：

--p 8443:8443：端口映射，将容器 8443 端口映射到主机，用于访问模拟服务。 --v $(pwd)/config:/opt/imposter/config：挂载本地配置目录，模拟服务器将基于此目录下的配置文件生成响应。

启动后，访问 http://localhost:8443/example 即可查看模拟响应（具体路径取决于 config 目录中的配置）。

插件体系Imposter 通过插件提供专用模拟能力，核心插件包括：

-** REST 插件 ：模拟 RESTful 或普通 HTTP API。查看文档 - OpenAPI 插件 ：支持 OpenAPI（Swagger）规范解析与模拟。查看文档 - HBase 插件 ：基础 HBase 服务模拟实现。查看文档 - SFDC 插件 **：基础 Salesforce 服务模拟实现。查看文档

用户可使用任意 JVM 语言开发自定义插件，扩展模拟能力。

文档与贡献### 完整文档查看完整文档

贡献方式欢迎通过 GitHub 仓库提交 Pull Request：https://github.com/outofcoffee/imposter