五一爆肝，我写了一个离线版 Apifox 平替——ApiMocktle

前言：从投毒事件说起

　　 前段事件，大家应该刷到过某著名api工具的供应链投毒事件，那个api工具确实做的非常好，功能丰富完整，但是却不支持离线使用，所有数据都在云端，接口文档里有什么？服务地址、认证 Token、请求参数、响应数据结构……这些东西一旦泄露，是个很麻烦的问题。更离谱的是，还被投毒了，家都被偷了！！！因此，我一直想找一个离线的类似的工具去使用，诸如Hoppscotch（Postwoman）​、Bruno等工具，也尝试过使用，但是总是有点不得劲，或多或少没有我想要的功能。

　　 而在我日常使用中，我所希望的Api工具应该具有如下特点：

• 完全离线：不需要联网使用，因为有时候，我们需要在内网使用Api工具。
• 支持多环境： 开发过程有时候要调试开发环境，有时候有需要调试测试环境，需要支持路由请求前缀一键切换
• 支持IDEA导入： 虽然从开发规范上来说，我们应该先设计API，再进行开发。但是有时候，也不一定那么规范，因此，能够将已有spring项目的URL一键导入是最好的。

　　 正好赶上五一假期，有5天假期，我决定自己动手（当然大部分是AI动手），做一个完全离线、数据本地化、免费开源的 API 管理工具。五天时间，借助伟大vibe coding的加持，这个项目从想法变成了现实。

　　它就是 ApiMocktle。

项目地址：https://github.com/xiaohuiduan/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

1. 本项目的界面与交互参考了 Codennnn / Apifox-UI。感谢原作者提供高质量的 UI 设计还原与开源分享，这个项目在此基础上继续做了适配、重构和演进。
2. qq201128 / Apifox-Local在Apifox-UI的基础上增加了很多功能，能够让我在其上面的基础上添加更多的功能。
3. IDEA插件是在大佬tangcent/easy-yapi的项目基础上进行改造，去除了一些与ApiMocktle不相关的功能，并进行了翻译为中文，同时对令牌相关的逻辑进行了修改，简化了同步的过程逻辑。
4. 感谢mimo 100T计划，给我提供的免费2亿credits套餐（虽然我一天就蹬完了）。
5. 感谢伟大的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

　　‍