MockHub

切换主题

🚀 快速开始 ​

本指南帮助您在几分钟内完成 MockHub 的下载、配置、启动与验证。

📋 前置要求 ​

  • 操作系统：Windows、Linux 或 macOS（64 位）
  • 建议内存 ≥ 1GB、磁盘 ≥ 1GB（录制 / 抓包数据增长所需）
  • 无需外部数据库，数据默认存储于本地 SQLite 文件

🔽 下载安装 ​

从以下地址下载与您的系统匹配的安装包（占位地址，正式发布后请以官网公布的实际地址为准）：

shell
# Windows 64位下载地址（占位）
https://software.wueasy.com/mock/latest/mock_win_64.zip
shell
# Linux系统（Intel/AMD处理器）
https://software.wueasy.com/mock/latest/mock_linux_amd64.tar.gz

# Linux系统（飞腾/鲲鹏等ARM处理器）
https://software.wueasy.com/mock/latest/mock_linux_arm64.tar.gz
shell
# Mac系统（M1/M2/M3芯片）
https://software.wueasy.com/mock/latest/mock_mac_arm64.tar.gz

# Mac系统（Intel处理器）
https://software.wueasy.com/mock/latest/mock_mac_amd64.tar.gz

如何选择正确的版本？

  1. AMD64（x86_64）：Intel / AMD 处理器 → 选择 *_amd64 版本（如 mock_linux_amd64）
  2. ARM64（aarch64）：飞腾 / 鲲鹏等 ARM 处理器、Apple M 系列芯片 → 选择 *_arm64 版本

Linux / Mac 下可用 uname -m 查看架构：输出 x86_64 选 amd64，输出 aarch64 / arm64 选 arm64。

解压后将主程序重命名或直接使用（如 mock_linux_amd64），完整安装步骤（命令说明 / 目录结构 / systemd 服务）见 安装部署。

⚙️ 配置 ​

程序启动时按以下顺序查找配置文件：

  1. 启动参数 -c 指定的路径（优先级最高）
  2. MOCK_HOME 指向目录下的 config/config.yaml（如 $MOCK_HOME/config/config.yaml）
  3. 未设置 MOCK_HOME 时，程序目录（当前工作目录）下的 config/config.yaml
bash
# 方式一：-c 参数指定配置
./mock_linux_amd64 -c /etc/mock/config.yaml

# 方式二：MOCK_HOME 环境变量
export MOCK_HOME=/etc/mock
./mock_linux_amd64

TIP

  • Windows 系统请将上述命令中的 mock_linux_amd64 替换为 mock_win_64.exe。
  • 若配置文件不存在，程序会自动生成一份默认配置并保存，随后正常启动。默认配置包含 HTTP / TCP / UDP 的示例监听器与示例规则。
  • 设置 MOCK_HOME 后，数据目录固定位于 $MOCK_HOME/data（见下文「数据与日志」）。

最小配置 ​

yaml
server:
    port: 9861          # 管理后台端口
    name: mock
    gzip: true
proxy:
    port: 9862          # HTTP 代理端口
    fallback: "404"     # 未命中规则时返回 404（passthrough 为透传）
tcp:
    enabled: true
udp:
    enabled: true
services: []
tcpRules: []

完整参数说明见 配置详解。

🚀 启动 ​

bash
# Linux / macOS（Windows 请用 mock_win_64.exe）
./mock_linux_amd64

# 或先安装为系统服务再管理（Linux）
# ./mock_linux_amd64 install && ./mock_linux_amd64 start

启动成功后终端会输出：

管理端启动: http://localhost:9861
代理端启动: http://localhost:9862

同时 TCP / UDP 监听器也会按配置启动（如 redis-demo:16379、coap-demo:5683）。

✅ 验证 ​

1. 打开管理后台 ​

浏览器访问 http://localhost:9861，可以看到管理后台，左侧菜单包含：

  • HTTP Mock：服务 / 规则 / 录制 / 抓包
  • TCP 代理：监听器 / 协议 Codec / 抓包 / 规则 / 录制
  • UDP 代理：监听器 / 抓包 / 规则 / 录制

2. 验证 HTTP Mock ​

bash
# 默认配置自带"获取用户"mock 规则（示例服务 upstreamUrl 指向 127.0.0.1:9001）
curl http://localhost:9862/api/user/1

命中 mock 规则时返回：

json
{"id":1,"name":"demo","message":"这是 mock 返回"}

3. 验证 TCP 代理 ​

bash
# 默认配置自带 redis-demo 监听器（16379 → 127.0.0.1:6379）
redis-cli -p 16379 ping

4. 验证 UDP / CoAP 代理 ​

bash
# 默认配置自带 coap-demo 监听器（5683 → 127.0.0.1:5684）
# 使用 coap 客户端发起 GET 请求
coap-client -m get coap://127.0.0.1:5683/sensors/temp

📂 数据与日志 ​

内容位置
配置文件config/config.yaml（见上文查找规则）
录制数据库data/records.db（SQLite）
抓包数据库data/captures.db（SQLite）
运行日志logs/ 目录（按大小与天数自动滚动）

TIP

配置修改后无需重启：在管理后台点击「重新加载配置」即可热生效。TCP / UDP 监听器的新增 / 修改 / 删除保存后立即生效。

Copyright © 2024-2026