MockHub

切换主题

📦 软件安装指南 ​

📥 下载安装包 ​

系统要求

  • 仅支持64位操作系统
  • 建议系统内存 ≥ 1GB
  • 建议磁盘空间 ≥ 1GB（录制 / 抓包数据增长所需）

下载地址 ​

占位说明

以下地址为发布占位模板，正式发布后请以官网公布的实际地址为准。

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. Windows系统：直接使用 Windows 64位版本

  2. AMD64架构（x86_64）：

    • Linux系统：使用 Linux AMD64版本
    • Mac系统：使用 Mac AMD64版本
    • 适用于：Intel或AMD处理器

  3. ARM64架构（aarch64）：

    • Linux系统：使用 Linux ARM64版本（飞腾/鲲鹏等）
    • Mac系统：使用 Mac ARM64版本（M1/M2/M3芯片）

可以通过以下命令查看系统架构：

bash
# Linux/Mac系统
uname -m

# 输出说明：
# x86_64: 选择AMD64版本
# aarch64/arm64: 选择ARM64版本

🛠️ 命令说明 ​

软件管理命令 ​

命令说明适用系统
./mock_linux_amd64 install安装软件到系统Linux
./mock_linux_amd64 uninstall从系统卸载软件Linux
./mock_linux_amd64 start启动服务Linux
./mock_linux_amd64 restart重启服务Linux
./mock_linux_amd64 stop停止服务Linux

提示

Windows系统请使用 mock_win_64.exe 替换上述命令中的 mock_linux_amd64

系统服务命令 ​

通过系统服务方式管理应用

命令说明
systemctl enable mock.service设置开机自启动
systemctl disable mock.service关闭开机自启动
systemctl start mock.service启动服务
systemctl stop mock.service停止服务
systemctl restart mock.service重启服务
systemctl status mock.service查看服务状态

注意

系统服务命令仅适用于 Linux 系统

📂 目录结构说明 ​

安装完成后的建议目录结构如下：

plaintext
/srv/mock/
├── mock_linux_amd64     # 主程序文件
├── config/              # 配置目录
│   └── config.yaml     # 主配置文件（服务名/端口/规则等全部配置）
├── data/                # 数据目录（自动创建）
│   ├── records.db      # 录制数据（SQLite）
│   ├── captures.db     # 抓包数据（SQLite）
│   └── nacos/          # Nacos 客户端日志与缓存
├── logs/                # 运行日志目录
│   └── app.log         # 应用日志
└── license.dat          # 授权文件

配置文件位置

程序按以下顺序定位配置文件：

  1. 启动参数 -c 指定的路径（优先级最高）
  2. 安装根目录下 config/config.yaml（默认位置，推荐）

若该文件不存在，首次启动会自动生成一份带注释的默认配置保存到 config/config.yaml。

可通过环境变量 MOCK_HOME 指定安装根目录（默认取程序所在目录 / 当前工作目录）， 此时配置读取位置为 $MOCK_HOME/config/config.yaml，数据目录固定为 $MOCK_HOME/data。

🔧 常见问题 (FAQ) ​

Q1: 如何修改配置？ ​

A: 修改 config/config.yaml 后重启服务即可生效（也可直接在管理后台修改，后台会同步写回该文件）：

bash
# Linux
./mock_linux_amd64 restart

# 或使用 systemctl
systemctl restart mock.service

# Windows
mock_win_64.exe restart

Q2: 数据存储在哪里？ ​

A: 录制数据、抓包数据与 Nacos 缓存存放在安装根目录（MOCK_HOME）的 data/ 目录，与配置文件位置无关，升级 / 重装不会影响已有数据。

Q3: 启动时提示 "Permission denied"？ ​

A: 权限不足。请确保：

  1. 程序文件有执行权限：chmod +x mock_linux_amd64
  2. 使用 sudo 或 root 用户执行命令。
  3. 确保 data/ 和 logs/ 目录有写入权限。

Q4: 执行 start 命令无反应或失败？ ​

A:

  1. 确保已经先执行了 install 命令。
  2. 检查日志文件（logs/ 目录下）查看错误信息。
  3. 检查端口是否被占用（管理端默认 9861，代理端默认 9862，可在配置中调整）。
  4. Linux 下检查 SELinux 设置：
    bash
    # 临时测试是否为 SELinux 问题
sudo setenforce 0

# 永久修复文件上下文
sudo chcon -R -t bin_t /srv/mock/mock_linux_amd64

Q5: 如何访问管理后台？ ​

A: 服务启动后，浏览器访问管理后台默认地址 http://IP:9861（端口可在配置中调整）。管理后台支持服务与规则、TCP / UDP 监听器、抓包断点、Nacos 注册等全量管理。

Q6: 提示授权失败 / 需要授权？ ​

A: 程序需要有效的授权文件 license.dat（放置于安装根目录）才能运行，请参考 授权配置指南 获取并部署授权文件。

Copyright © 2024-2026