bbyars/mountebank

镜像概述

mountebank是一款开源的服务虚拟化工具，用于创建和管理模拟服务（mocks），帮助开发和测试团队在不依赖真实服务的情况下进行工作。本Docker镜像提供了mountebank的容器化部署方案，简化了工具的安装和配置流程，确保跨环境的一致性和快速启动能力。通过该镜像，用户可快速部署支持多协议的模拟服务，降低对外部依赖的耦合，提升开发和测试效率。

核心功能与特性

• 多协议支持：原生支持HTTP、HTTPS、TCP、SMTP等多种协议，可模拟各类服务接口
• 灵活配置方式：支持通过JSON配置文件或REST API动态定义模拟规则（如请求匹配、响应延迟、状态码自定义等）
• 容器化优势：轻量级镜像设计，资源占用低，启动速度快；支持跨平台部署，确保开发、测试、生产环境一致性
• 丰富的模拟能力：支持 stub（静态响应）、proxy（代理转发）、recorder（请求录制）等模式，满足复杂场景需求
• 可扩展性：提供插件机制，支持自定义协议或复杂业务逻辑扩展

使用场景与适用范围

• 开发环境依赖模拟：在微服务架构中，模拟上下游依赖服务，实现独立开发（如前端开发模拟后端API、服务A开发模拟服务B接口）
• 测试环境隔离：构建隔离的测试环境，避免真实服务波动对测试结果的影响，确保测试稳定性
• API契约测试：模拟服务端响应，验证客户端与API契约的一致性（配合Pact等工具使用）
• 故障注入测试：模拟服务超时、错误响应、网络延迟等异常场景，验证系统容错能力
• 演示与培训环境：快速搭建包含模拟数据的演示系统，无需依赖真实业务数据

使用方法与配置说明

基础使用（docker run 示例）

默认启动（无自定义配置）

bash
docker run -d -p 2525:2525 --name mountebank jkris/mountebank

• 说明：启动mountebank容器，默认暴露2525端口（管理API端口），无自定义模拟规则。可通过访问 http://localhost:2525 验证服务是否启动（返回mountebank版本信息）。

指定配置文件启动

将本地自定义的mountebank配置文件（JSON格式）挂载到容器内，并通过命令行参数指定配置文件路径：

bash
# 假设本地配置文件路径为 ./mb-config/mocks.json
docker run -d \
  -p 2525:2525 \
  -p 8080:8080 \  # 暴露模拟HTTP服务端口（根据配置文件定义）
  -v $(pwd)/mb-config:/mb/config \
  --name mountebank \
  jkris/mountebank \
  --configfile /mb/config/mocks.json

• 配置文件示例（mocks.json）：

  json
  {
    "imposters": [
      {
        "port": 8080,
        "protocol": "http",
        "stubs": [
          {
            "responses": [
              {
                "is": {
                  "statusCode": 200,
                  "headers": { "Content-Type": "application/json" },
                  "body": { "message": "Mocked HTTP response" }
                }
              }
            ]
          }
        ]
      }
    ]
  }
  

• 访问 http://localhost:8080 可获取上述配置定义的模拟响应。

docker-compose 配置示例

yaml
version: '3.8'
services:
  mountebank:
    image: jkris/mountebank
    container_name: mountebank
    ports:
      - "2525:2525"  # 管理API端口
      - "8080:8080"  # 模拟HTTP服务端口
      - "443:443"    # 模拟HTTPS服务端口（如需）
    volumes:
      - ./mb-config:/mb/config  # 挂载配置文件目录
      - ./mb-logs:/var/log/mountebank  # 挂载日志目录（可选）
    command: --configfile /mb/config/mocks.json --loglevel debug  # 启动命令（指定配置文件和日志级别）
    restart: unless-stopped  # 容器退出时自动重启（除非手动停止）

核心配置参数说明

mountebank主要通过命令行参数进行配置，常用参数如下：

卷挂载说明

• 配置文件挂载：推荐将自定义配置文件（如mocks.json）通过卷挂载到容器内（如 /mb/config 目录），便于修改和版本控制
• 日志挂载（可选）：如需持久化日志，可挂载日志目录（如示例中 /var/log/mountebank），需确保容器内目录有写入权限
• 数据卷权限：挂载本地目录时，建议设置正确的文件权限（如 chmod 755 ./mb-config），避免容器内权限不足导致配置文件无法读取

注意事项

• 端口映射：容器内模拟服务的端口（如HTTP服务的8080）需通过 -p 参数映射到宿主机，否则宿主机无法访问
• 配置文件格式：JSON配置文件需符合mountebank规范，错误格式会导致服务启动失败（可通过容器日志 docker logs mountebank 排查）
• 版本兼容性：建议指定镜像标签（如 jkris/mountebank:2.8.1）以确保版本稳定性，避免自动升级导致配置不兼容