apiumhub/dyson-quick-mockserver

DYSON快速模拟服务器

本镜像基于开源库https://github.com/webpro/dyson%E6%9E%84%E5%BB%BA%EF%BC%8C%E6%97%A8%E5%9C%A8%E5%B8%AE%E5%8A%A9%E5%BC%80%E5%8F%91%E8%80%85%E5%BF%AB%E9%80%9F%E9%83%A8%E7%BD%B2API%E6%A8%A1%E6%8B%9F%E6%9C%8D%E5%8A%A1%E5%99%A8%EF%BC%8C%E7%94%A8%E4%BA%8E%E6%A8%A1%E6%8B%9F%E6%8E%A5%E5%8F%A3%E5%93%8D%E5%BA%94%EF%BC%8C%E6%94%AF%E6%8C%81%E5%BC%80%E5%8F%91%E5%92%8C%E6%B5%8B%E8%AF%95%E5%9C%BA%E6%99%AF%E3%80%82

核心功能

• 支持自定义API端点路径和响应模板
• 可通过JS文件配置动态响应逻辑（如根据请求参数返回不同结果）
• 轻量级部署，快速启动

使用场景

• 前端开发时后端接口尚未完成，模拟接口响应进行联调
• 测试不同接口响应情况（如成功、失败、异常状态）
• 隔离开发环境与真实服务，避免依赖外部资源

配置说明

1. 创建API模拟配置目录

bash
mkdir api-fakes

2. 编写接口配置文件（以健康检查接口为例）
   在api-fakes目录下创建health.js：

javascript
module.exports = {
    path: '/api/v1/health',
    template: {
        status: (params, query) => query.status || 'ok',
    }
};

3. 部署镜像

bash
docker run -d -v $(pwd)/api-fakes:/api-fakes -p 8080:8080 apiumhub/dyson-quick-mockserver

4. 验证响应

bash
curl localhost:8080/api/v1/health?status=success

开发使用

1. 构建镜像

bash
docker build . -t dyson

2. 运行镜像（随机端口）

bash
docker run -d -v $(pwd)/api-fakes:/api-fakes -P dyson:latest