realfengjia/fakeit

Fakeit

镜像概述和主要用途

本镜像为JustinFeng/fakeit项目的Docker封装，用于快速部署基于规范文件的模拟服务器。通过Docker容器化部署，可简化环境配置，支持本地或远程规范文件，适用于开发、测试场景中需要模拟API接口的场景。

核心功能和特性

• 多规范源支持：兼容本地规范文件挂载和远程规范文件URL配置
• 容器化部署：无需手动配置依赖，通过Docker命令快速启动模拟服务
• 日志优化：支持日志颜色高亮（需启用tty模式）
• 端口灵活映射：通过Docker端口映射配置，灵活调整服务访问端口

使用场景和适用范围

• 前端开发：在后端服务未就绪时，模拟API接口进行前端联调
• 自动化测试：为测试用例提供稳定可控的模拟数据源
• 演示环境：快速搭建临时演示服务，展示前端功能逻辑

使用方法和配置说明

使用本地规范文件

将本地规范文件挂载到容器中，启动模拟服务器：

bash
docker run -t -v <本地规范文件路径>:/home/<规范文件名> -p 8081:8080 realfengjia/fakeit:latest --spec /home/<规范文件名>

参数说明：

• -t：启用tty模式，保留日志颜色高亮
• -v <本地规范文件路径>:/home/<规范文件名>：挂载本地规范文件到容器内/home/目录
• -p 8081:8080：将容器内8080端口映射到主机8081端口（主机端口可自定义）
• --spec /home/<规范文件名>：指定容器内规范文件路径

使用远程规范文件

直接通过URL指定远程规范文件启动服务：

bash
docker run -t -p 8081:8080 realfengjia/fakeit:latest --spec <远程规范文件URL>

参数说明：

• -t：启用tty模式，保留日志颜色高亮
• -p 8081:8080：端口映射配置（格式：主机端口:容器端口）
• --spec <远程规范文件URL>：远程规范文件的完整URL路径

注意事项

• 端口配置限制：模拟服务器默认使用容器内8080端口，不支持通过fakeit原生命令的--port参数修改，需通过Docker的-p选项进行端口映射
• tty模式要求：如需保留日志中的颜色高亮显示，必须添加-t参数启用tty模式
• 文件权限：挂载本地文件时，建议使用绝对路径，并确保容器对挂载目录有读取权限