EasyPostman

开源 API 调试 & 性能测试桌面工具
Postman 替代品 · Java 驱动 · 为开发者而生

📖 目录

💡 项目简介
✨ 功能特性
📦 下载
🚀 快速开始
🖼️ 截图预览
🤝 贡献指南
📚 文档
❓ 常见问题
💖 支持项目

💡 项目简介

EasyPostman 为开发者提供本地化、隐私优先的 API 调试体验，媲美 Postman，同时集成简易版 JMeter 的性能测试能力。采用 Java Swing 构建，支持跨平台运行，完全离线可用，内置 Git 工作区功能，支持团队协作和版本控制。

🎯 专注核心	🔒 隐私优先	🚀 性能至上
简洁而不简单，功能丰富而不臃肿	100% 本地存储，数据不上云，保护开发者隐私	原生 Java 应用，启动快速，运行流畅

✨ 功能特性

🏢 工作区 & 协作

本地工作区 - 个人项目，数据本地存储
Git 工作区 - 版本控制和团队协作
多设备同步 - 通过 Git 仓库共享接口数据
项目隔离 - 每个工作区独立管理集合和环境

🔌 接口测试

HTTP/HTTPS - 完整的 REST API 支持（GET、POST、PUT、DELETE 等）
WebSocket & SSE - 实时协议支持
多种请求体 - Form Data、JSON、XML、Binary
文件上传下载 - 支持拖拽
环境变量 - 多环境管理，支持动态变量

⚡ 性能测试

线程组模式 - 固定、递增、阶梯、尖刺
实时监控 - TPS、响应时间、错误率
可视化报告 - 性能趋势图和结果树
批量请求 - 简易版 JMeter 风格测试

📝 高级功能

请求前脚本 - 请求前执行 JavaScript，可直接访问 Redis / Kafka / Elasticsearch / InfluxDB
测试脚本 - 支持对 HTTP 响应和外部数据源查询/写入结果做断言
数据源脚本 API - 在脚本中直接读写并校验 Redis、Kafka、Elasticsearch、InfluxDB
请求链路 - 提取数据传递给下一个请求
网络事件日志 - 详细的请求/响应分析
导入导出 - Postman v2.1、cURL、HAR（进行中）

🎨 用户体验

亮色暗色模式 - 任何光线下舒适观看
多语言 - 中文、English
语法高亮 - JSON、XML、JavaScript
跨平台 - Windows、macOS、Linux

📖 查看所有功能 →

📦 下载

平台下载

平台	安装包	说明
🍎 macOS (Apple Silicon)	`EasyPostman-{版本号}-macos-arm64.dmg`	M1/M2/M3/M4
🍏 macOS (Intel)	`EasyPostman-{版本号}-macos-x86_64.dmg`	Intel Mac
🪟 Windows (安装版)	`EasyPostman-{版本号}-windows-x64.exe`	支持自动更新
🪟 Windows (便携版)	`EasyPostman-{版本号}-windows-x64-portable.zip`	解压即用
🐧 Linux AMD64（通用）	`EasyPostman-{版本号}-linux-amd64.deb`	适用于常见 `x86_64` / `amd64` Linux 系统
🐧 Linux ARM64（通用）	`EasyPostman-{版本号}-linux-arm64.deb`	适用于常见 `aarch64` / `arm64` Linux 系统
🐧 Linux ARM64（兼容版）	`EasyPostman-{版本号}-linux-arm64-compat.deb`	当通用 ARM64 包在旧版 `dpkg` 环境中无法安装时推荐使用
🐧 RHEL / Rocky / CentOS / Fedora（x64）	`EasyPostman-{版本号}-1.x86_64.rpm`	仅 GitHub Releases 提供
🐧 RHEL / Rocky / CentOS / Fedora（ARM64）	`EasyPostman-{版本号}-1.aarch64.rpm`	仅 GitHub Releases 提供
☕ 跨平台 JAR	`easy-postman-{版本号}.jar`	需要 Java 17+

⚠️ 首次运行提示

Windows：SmartScreen 警告 → "更多信息" → "仍要运行"

macOS：提示"无法打开" → 右键 → "打开" → "打开"

本应用完全开源，这些警告是因为未购买代码签名证书。

🌏 Gitee 镜像 仅提供 macOS（ARM）DMG 和 Windows 包。Linux 的 DEB / RPM 安装包仅发布在 GitHub Releases。

🚀 快速开始

方式一：下载预编译版本

从 Releases 下载适合您平台的安装包
安装并运行：

平台	操作
macOS	打开 DMG → 拖拽到应用程序
Windows 安装版	运行 `.exe`，按向导操作
Windows 便携版	解压 ZIP → 运行 `EasyPostman.exe`
Linux DEB（AMD64 通用）	`sudo dpkg -i EasyPostman-{版本号}-linux-amd64.deb`
Linux DEB（ARM64 通用）	`sudo dpkg -i EasyPostman-{版本号}-linux-arm64.deb`
Linux DEB（ARM64 兼容版）	`sudo dpkg -i EasyPostman-{版本号}-linux-arm64-compat.deb`
Linux RPM（x64）	`sudo rpm -ivh EasyPostman-{版本号}-1.x86_64.rpm`
Linux RPM（ARM64）	`sudo rpm -ivh EasyPostman-{版本号}-1.aarch64.rpm`
JAR	`java -jar easy-postman-{版本号}.jar`

如果不确定该下载哪个 Linux 安装包，先执行 uname -m：

x86_64 -> 选择 EasyPostman-{版本号}-linux-amd64.deb 或 x86_64.rpm
aarch64 -> 选择 EasyPostman-{版本号}-linux-arm64.deb
如果通用 ARM64 包在旧版 dpkg 环境中安装失败 -> 改用 EasyPostman-{版本号}-linux-arm64-compat.deb

方式二：从源码构建

git clone https://github.com/lakernote/easy-postman.git
cd easy-postman
mvn clean package
java -jar target/easy-postman-*.jar

📖 构建指南 →
🔌 插件架构与安装 →

第一步

创建工作区 — 本地（个人）或 Git（团队协作）
创建集合 — 组织您的 API 请求
发送第一个请求 — 输入 URL，配置参数，点击发送
设置环境 — 轻松切换开发 / 测试 / 生产环境

🖼️ 截图预览

主界面	工作区管理

接口集合 & API 测试	性能测试

📸 查看所有截图 →

🤝 贡献指南

我们欢迎任何形式的贡献 — Bug 报告、功能建议、代码或文档！

类型	方式
🐛 报告 Bug	提交 Issue
✨ 功能建议	功能请求
💻 提交代码	Fork → 分支 → PR
📝 改进文档	修正错别字、添加示例、翻译

每个 PR 都会自动触发：构建检查、测试执行、代码质量验证和格式校验。

📖 贡献指南 →

📚 文档

文档	说明
📖 功能详细说明	全面的功能文档
🏗️ 系统架构	技术栈和架构设计
🚀 构建指南	从源码构建和生成安装包
🔌 插件架构与安装	插件模块、开发流程、在线/离线安装
🖼️ 截图展示	所有应用截图
📝 脚本 API 参考	请求前和测试脚本 API，含 Redis/Kafka/ES/InfluxDB
📝 脚本代码片段速查	内置代码片段，含数据源读写和断言示例
🔐 客户端证书	mTLS 配置
🐧 Linux 构建指南	在 Linux 上构建
❓ 常见问题	常见问题解答

❓ 常见问题

Q: 为什么选择本地存储而不是云同步？

我们重视开发者的隐私安全。本地存储确保您的接口数据不会泄露给第三方。您可以选择使用 Git 工作区进行团队协作，同时保持对数据的完全控制。

Q: 如何导入 Postman 数据？

在 Collections 界面点击导入按钮，选择 Postman v2.1 格式的 JSON 文件即可。工具会自动转换集合、请求和环境变量。

Q: 为什么 Windows/macOS 提示安全警告？

Windows SmartScreen：未购买代码签名证书（约 $100–400/年）。→ 点击"更多信息" → "仍要运行"，随下载量增加警告会逐渐减少。
macOS Gatekeeper：未购买 Apple 开发者证书（$99/年）。→ 右键"打开"，或终端执行：sudo xattr -rd com.apple.quarantine /Applications/EasyPostman.app

本项目完全开源，代码可在 GitHub 审查。

Q: 支持团队协作吗？

✅ 支持！使用 Git 工作区可以：共享接口集合和环境变量、版本控制跟踪变更（commit/push/pull）、跨多设备协作，无需任何云服务。

Q: 工作区之间的数据会相互影响吗？

不会。每个工作区完全独立，拥有自己的集合、环境变量和历史记录，切换时数据完全隔离。

Q: Git 工作区支持哪些平台？

支持所有标准 Git 平台：GitHub、Gitee、GitLab、Bitbucket 及自建 Git 服务器（HTTPS 或 SSH）。

💖 支持项目

如果 EasyPostman 对您有帮助：

⭐ 给项目点个 Star — 这对我们很重要！
🍴 Fork 并贡献 — 帮助改进项目
📢 向朋友推荐 — 传播好工具
💬 加入微信群 — 添加 lakernote 直接交流
💬 GitHub 讨论区 — 提问和分享想法

⭐ Star History

🙏 致谢

感谢以下优秀的开源项目：

项目	用途
FlatLaf	现代化 Swing 主题
RSyntaxTextArea	语法高亮编辑器
OkHttp	HTTP 客户端
Termora	终端模拟器灵感来源

让 API 调试更简单，让性能测试更直观

Made with ❤️ by laker

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

EasyPostman

📖 目录

💡 项目简介