mastercontrol/mockserver

镜像概述

本镜像为mock-server/mockserver的分支版本，主要通过调整Dockerfile实现了对arm64架构的真实支持。它保留了原版mockserver的全部核心功能，可在arm64平台（如树莓派、ARM服务器、Apple Silicon设备等）上稳定运行，用于搭建模拟API服务器。

核心功能与特性

• arm64架构支持：通过优化Dockerfile，解决了原版镜像在arm64平台上的兼容性问题，实现真实的arm64架构支持
• 完整功能保留：继承mockserver的全部核心功能，包括API响应模拟、请求验证、代理转发、录制/回放等
• 轻量级部署：基于Docker容器化部署，配置简单，易于集成到开发、测试环境或CI/CD流程中
• 跨平台一致性：在arm64平台上提供与x86平台一致的使用体验和功能表现

使用场景与适用范围

• arm64开发环境：在树莓派、ARM服务器等arm64设备上搭建本地开发用模拟API服务
• 跨架构测试：在Apple Silicon Mac等arm64设备上验证依赖模拟服务的应用程序
• CI/CD流程：在arm64架构的CI/CD pipeline中集成模拟服务器，用于自动化测试
• 边缘计算场景：在arm64边缘设备上部署轻量级模拟服务，支持本地应用测试

使用方法与配置说明

基本使用（docker run）

通过以下命令在arm64平台启动模拟服务器：

bash
docker run -d -p 1080:1080 --name mockserver-arm64 [镜像名称]:[版本标签]

• -p 1080:1080：映射容器的1080端口到主机，作为模拟服务的默认端口
• --name mockserver-arm64：指定容器名称，便于管理

Docker Compose配置

在docker-compose.yml中集成：

yaml
version: '3'
services:
  mockserver:
    image: docker.xuanyuan.run/[镜像名称]:[版本标签]
    ports:
      - "1080:1080"
    environment:
      - MOCKSERVER_PORT=1080  # 服务端口，默认为1080
      - MOCKSERVER_INITIALIZATION_JSON_PATH=/config/initialization.json  # 初始化配置文件路径
    volumes:
      - ./config:/config  # 挂载本地配置目录
    restart: always

核心配置参数

环境变量

初始化配置示例

创建initialization.json文件定义初始模拟规则：

json
[
  {
    "httpRequest": {
      "method": "GET",
      "path": "/api/test"
    },
    "httpResponse": {
      "statusCode": 200,
      "body": "{\"result\": \"success\"}"
    }
  }
]

通过挂载配置目录使配置生效，如上述docker-compose示例中的./config:/config。

验证服务可用性

服务启动后，可通过以下命令验证：

bash
curl http://localhost:1080/api/test

若返回{"result": "success"}，表示模拟服务已正常运行。