五一爆肝,我写了一个离线版 Apifox 平替------ApiMocktle
前言:从投毒事件说起
前段事件,大家应该刷到过某著名api工具的供应链投毒事件,那个api工具确实做的非常好,功能丰富完整,但是却不支持离线使用,所有数据都在云端,接口文档里有什么?服务地址、认证 Token、请求参数、响应数据结构......这些东西一旦泄露,是个很麻烦的问题。更离谱的是,还被投毒了,家都被偷了!!!因此,我一直想找一个离线的类似的工具去使用,诸如Hoppscotch(Postwoman)、Bruno等工具,也尝试过使用,但是总是有点不得劲,或多或少没有我想要的功能。
而在我日常使用中,我所希望的Api工具应该具有如下特点:
- 完全离线:不需要联网使用,因为有时候,我们需要在内网使用Api工具。
- 支持多环境: 开发过程有时候要调试开发环境,有时候有需要调试测试环境,需要支持路由请求前缀一键切换
- 支持IDEA导入: 虽然从开发规范上来说,我们应该先设计API,再进行开发。但是有时候,也不一定那么规范,因此,能够将已有spring项目的URL一键导入是最好的。
正好赶上五一假期,有5天假期,我决定自己动手(当然大部分是AI动手),做一个完全离线、数据本地化、免费开源的 API 管理工具。五天时间,借助伟大vibe coding的加持,这个项目从想法变成了现实。
它就是 ApiMocktle。
大家可以在Github的Release上面进行下载,上面的Realse是github流水线进行编译生成的。

关于Api工具的编译结果,流水线编译生成了 Linux、windows和MacOS三个版本,但是由于我只有windows电脑,所以只测试了windows能够正常安装使用,MacOS和Linux需要大家下载进行测试,看是否能够正常使用。

ApiMocktle 是什么?
ApiMocktle 是一个基于 Tauri v2 的桌面应用,核心定位就四个字:本地优先(本地唯一) 。
- 离线可用------不需要网络,数据存在你本机的 SQLite 里。
- 完全免费------代码已经开源,可以自己编译安装。也可以
- 数据自主------没有服务端,不存在数据上传,谁也偷不走你的接口文档
- 名字有故事------刚好我养了鹦鹉和乌龟,DeepSeek 给我起了这个名字,Mock(鹦鹉学舌,模拟 API)+ Turtle(龟,象征数据结构稳定)= Mocktle。

功能一览
页面首先会要求你注册登录,别担心,这个登录注册都是本地,完全不连外网(因为我是在Apifox-Local基础上面修改的,我觉得这个功能还行,就没有去除这个功能了😀)
项目管理

支持多人协作的项目管理,注册登录后可创建、重命名、删除项目。成员管理支持 owner / editor / viewer 三种角色,可以搜索用户直接拉进项目。当然实际上,这是一个单机应用(数据库存在本地),这个功能没啥特别大的作用,不过后续如果将这个项目改造成B/S架构团队应用,这个功能还是有用的,可以让团队共同使用。这里就简要介绍一下吧。

接口管理
这是核心功能。树形目录结构,支持重命名、复制、移动、删除。资源类型覆盖了日常所有场景:
- API 接口------完整定义路径、请求方法、Query / Path / Header / Cookie 参数
- 数据模型 ------支持
$ref引用,一套 Schema 多处复用。 - 快捷请求------临时调试用的快速入口
Body 编辑支持 JSON / XML / form-data / url-encoded / raw / binary,其中 JSON 参数还提供了树形 Schema 编辑器,可以像设计数据库表一样定义字段名、类型、示例值和说明。
返回响应支持多个 HTTP 状态码,每个响应独立定义 JSON Schema,覆盖正常返回和各种异常情况。

环境管理
告别硬编码 URL。支持设置前置 URL 和环境变量 ,使用 {{varName}} 模板语法,运行时自动替换。


请求调试
内置 Run Tab(接口定义处可以调用,也可以在快捷请求处调用),不用安装 Postman 之类的额外工具。填好参数,点一下发送,响应内容、响应头、cURL 命令一起展示。

导入导出
- 导入:OpenAPI 3.x / Swagger 2.0 的 JSON 和 YAML 都能直接导入,静默合并到当前项目,不会覆盖已有数据。还支持从 cURL 命令导入单条请求。
- 导出:生成完整的 OpenAPI 3.0 / Swagger 2.0 规范文档,也可以把接口导出为 Markdown 分享给同事
IDEA 插件:从源码一键同步
这是我个人觉得最实用的功能。在基于Easy-Yapi IntelliJ IDEA 插件的基础上,进行改造,对接ApiMocktle,可以一键将Spring项目(Easy-Yapi理论上还支持其他类型的项目,不过这个我没有试过)URL同步到桌面客户端。
插件支持:
- 右键控制器方法 → 导出到 YAPI,自动提取接口路径、参数、请求体
- 从 IDE 内置的 API 仪表盘直接浏览、搜索、调用接口
- 支持 Spring MVC、Spring Cloud OpenFeign、JAX-RS、gRPC 等主流框架
- 支持 Swagger 2 / OpenAPI 3 注解自动识别
不需要手写接口文档,源码写完,插件一键导出,文档直接就有了。
插件项目地址:https://github.com/xiaohuiduan/ApiMocktle-java-plugin

Reference
- 本项目的界面与交互参考了 Codennnn / Apifox-UI。感谢原作者提供高质量的 UI 设计还原与开源分享,这个项目在此基础上继续做了适配、重构和演进。
- qq201128 / Apifox-Local在Apifox-UI的基础上增加了很多功能,能够让我在其上面的基础上添加更多的功能。
- IDEA插件是在大佬tangcent/easy-yapi的项目基础上进行改造,去除了一些与ApiMocktle不相关的功能,并进行了翻译为中文,同时对令牌相关的逻辑进行了修改,简化了同步的过程逻辑。
- 感谢mimo 100T计划,给我提供的免费2亿credits套餐(虽然我一天就蹬完了)。
- 感谢伟大的DeepSeek V4 pro,在五一期间降价,让我疯狂蹬,花费却不到100,完成了项目所有内容。
结语
ApiMocktle 不是什么惊天动地的大项目,它只是一个普通开发者在五一假期,因为对数据安全的焦虑而写出来的小工具。但它是完全属于用户自己的------不需要注册第三方账号,不需要担心服务关停,不需要害怕数据泄露。
如果你也在找一个离线的、免费的、开源的 API 管理工具,不妨试试 ApiMocktle。如果觉得哪里不好用,直接提 Issue 或者 Fork 改代码------这就是开源的意义。
Star 一下就是对开源作者最大的鼓励。
桌面端:https://github.com/xiaohuiduan/ApiMocktle
IDEA 插件:https://github.com/xiaohuiduan/ApiMocktle-java-plugin
参考的开源项目(同样也可以star他们的作品):
Apifox-UI:https://github.com/Codennnn/Apifox-UI
Apifox-Local:https://github.com/qq201128/Apifox-Local
easy-yapi:https://github.com/tangcent/easy-yapi