mockoon/cli

Mockoon CLI Docker 镜像

镜像概述和主要用途

Mockoon 是在本地运行模拟 API 的最简单快捷方式，无需远程部署，无需账户，免费且开源。它提供桌面应用和 CLI 工具，通过模拟 API 帮助开发者更快地进行 API 相关工作，如加速第三方 API 集成、改进集成测试、提升开发速度等。

本 Docker 镜像基于 node:18-alpine 构建，包含最新版本的 Mockoon CLI，适用于在无界面环境、CI/CD 流水线等场景中部署和运行模拟 API 服务。

核心功能和特性

主要功能

• 无限制数量的本地模拟服务器和路由
• CLI 支持，可在无界面环境、CI 等场景中运行模拟服务
• 完整的路由定义控制：HTTP 方法和状态码、正则路径、文件服务、自定义头信息等
• OpenAPI 兼容性
• 所有传入和转发请求的记录/日志
• JSON 模板功能
• 代理转发模式
• HTTPS 支持

使用场景和适用范围

• 开发环境：本地开发时模拟后端 API，前后端并行开发
• CI/CD 流水线：在持续集成过程中提供稳定的模拟 API 依赖
• 测试环境：为集成测试提供一致的 API 响应
• 演示环境：在没有后端服务的情况下展示前端应用功能
• 第三方 API 集成：在无法访问真实第三方 API 时使用模拟服务进行开发

使用方法和配置说明

镜像获取

从 Docker Hub 获取最新版本镜像：

bash
docker pull docker.xuanyuan.run/mockoon/cli:latest

基本使用方法

1. 通过挂载本地数据文件运行

将本地 Mockoon 数据文件挂载到容器中并启动服务：

bash
docker run -d \
  --mount type=bind,source=/本地路径/你的数据文件.json,target=/data,readonly \
  -p 3000:3000 \
  docker.xuanyuan.run/mockoon/cli:latest \
  --data data \
  --port 3000

2. 通过 URL 加载数据文件运行

直接通过 URL 加载远程数据文件，无需挂载本地文件：

bash
docker run -d \
  -p 3000:3000 \
  docker.xuanyuan.run/mockoon/cli:latest \
  -d https://raw.githubusercontent.com/mockoon/mock-samples/main/samples/generate-mock-data.json \
  --port 3000

docker-compose 配置示例

yaml
version: '3'
services:
  mockoon:
    image: docker.xuanyuan.run/mockoon/cli:latest
    ports:
      - "3000:3000"
    volumes:
      - ./mock-data.json:/data:ro
    command: --data data --port 3000
    restart: unless-stopped

配置参数说明

Mockoon CLI 支持多种启动参数，常用参数如下：

完整参数列表

如需查看完整的参数列表，请运行：

bash
docker run --rm docker.xuanyuan.run/mockoon/cli:latest --help

参考链接

• 官方网站
• https://github.com/mockoon/mockoon/tree/main/packages/cli#docker
• https://www.npmjs.com/package/@mockoon/cli
• https://hub.docker.com/r/mockoon/cli