swaggermock/swagger-mock

Swagger Mock Server

注意：该项目已迁移至镜像 muonsoft/openapi-mock，建议使用最新版本。

镜像概述

Swagger Mock Server 是基于 Swagger/OpenAPI v3.0 规范的模拟服务器工具，能根据API定义自动生成模拟接口并返回符合规范的响应数据，帮助开发者在后端接口未完成时推进前端开发或API测试。

核心功能

• 支持 Swagger/OpenAPI v3.0 规范文件解析
• 自动生成模拟接口，返回预设或随机响应数据
• 支持自定义响应规则（具体配置需参考官方文档）

使用场景

• 前端开发：后端接口未实现时，通过模拟接口获取测试数据，加快开发进度
• API测试：验证请求参数格式、响应结构是否符合规范
• 团队协作：前后端基于统一API规范并行开发，减少沟通成本

配置说明

需将本地OpenAPI 3.0规范文件（如 openapi.yaml）挂载到容器指定目录，或通过启动参数指定规范文件路径。

部署示例

Docker Run命令

bash
docker run -d -p 8080:8080 -v /path/to/your/openapi.yaml:/app/openapi.yaml docker.xuanyuan.run/swaggermock/swagger-mock

说明：将本地 openapi.yaml 文件挂载到容器 /app/openapi.yaml 路径，暴露容器8080端口到主机8080端口，启动后可通过 http://localhost:8080 访问模拟接口。