从源码构建 OpenTRAP：build、test 到打包 AppImage 的完整指南

【免费下载链接】opentrapA free, open-source alternative to Burp Suite: an intercepting proxy and web app security testing suite with Repeater, Intruder, Collaborator and a built-in OWASP ZAP scanner. Linux, AGPL-3.0.项目地址https://gitcode.com/gh_mirrors/op/opentrap点击查看免费下载OpenTRAP 是一款免费开源的拦截式代理intercepting proxy与 Web 应用安全测试工具被视为 Burp Suite 的开源替代内置 Repeater、Intruder、Collaborator 以及基于 OWASP ZAP 的扫描引擎。本指南带你走一遍从源码构建 OpenTRAP的完整流程用build.sh编译、用test.sh测试直到用package-appimage.sh打包成一个用户双击即可运行的单文件 AppImage。全程只需几个命令行不需要任何额外依赖管理器。 环境准备构建 OpenTRAP 需要哪些依赖在动手前先确认开发机具备以下基础条件JDK 17 或更高项目实际以 Java 25 构建和测试用于编译 Java 源码Linux 系统打包产物只面向 Linux x86_64稳定的网络首次构建需要联网拉取扫描引擎、JDK 等组件常用工具git、curl、unzip、javac、jar。 提示项目只编译期内置了 BouncyCastle 和 Brotli 解码器两个 jar已放在lib/目录OWASP ZAP 扫描引擎与测试浏览器都是按需拉取的不会随仓库一起提交。完整清单见 DEPENDENCIES.md。 克隆仓库并拉取锁定版本的依赖工具克隆项目源码仓库为只读请勿直接修改git clone https://gitcode.com/gh_mirrors/op/opentrap cd opentrap接下来运行几个fetch-*.sh脚本把大型工具拉取到本地对应目录。这些脚本安装的版本由 tools/versions 统一锁定保证任何人构建出的产物都一致脚本拉取内容落地目录是否必需fetch-jdk.sh可移植 Temurin JDK基于旧版 glibc 2.17jdk/打包 AppImage 必需fetch-zap.shOWASP ZAP 扫描引擎headless 运行engine/编译发布 jar 必需fetch-browser.sh独立的 Chromium 测试浏览器browser/可选约 680 MB./fetch-jdk.sh # 便携 JDK让 AppImage 能在各发行版通用 ./fetch-zap.sh # 扫描引擎release 构建时会被打进 jar ./fetch-browser.sh # 可选测试浏览器⚠️ 关键点AppImage 的可移植性依赖 fetch-jdk.sh 拉取的便携 Temurin JDK。Temurin 基于 glibc 2.17 构建因此打包出来的 AppImage 能在 Ubuntu LTS、Debian stable 等主流发行版上启动若误用系统里的新版 JDK 打包产物会在老系统上闪退。详见 MAINTAINING.md。 第一步build.sh 编译开发版 jarbuild.sh 会把src/下的全部源码编译进build/并解包lib/中的 jar最终打成一个轻量的开发版 jar约 10 MB./build.sh # 产物dist/opentrap.jar它的核心动作是清空旧的build/→javac编译 → 拷贝图标资源 → 展开 vendored jar →jar cfm生成 dist/opentrap.jar。开发版 jar不内嵌扫描引擎所以体积小、构建快适合日常开发调试。如果jdk/目录存在脚本会自动优先使用它与发布构建保持一致的工具链否则回退到系统 JDK。 运行验证用 run.sh 启动 OpenTRAP编译完成后可以直接启动看看效果./run.sh # 启动开发版自动适配高分屏缩放 ./run.sh 2 # 也可以强制指定 200% 缩放run.sh 会按机器内存比例设置最大堆-XX:MaxRAMPercentage50并为 tiling 窗口管理器i3、Hyprland 等自动设置_JAVA_AWT_WM_NONREPARENTING提示避免窗口画成空白。看到主窗口正常弹出说明开发构建成功。✅ 第二步test.sh 运行完整测试套件OpenTRAP 用 test.sh 编译并运行测试./test.sh脚本做三件事先编译应用类到build/再编译tests/下的测试类到build-tests/最后用java -cp lib/*:build:build-tests RunTests执行整个套件。值得了解的设计点测试与源码分离测试放在tests/而非src/因此永远不会被打进发布 jar零依赖的极简测试框架项目没有引入 JUnit而是自带 tests/opentrap/testkit/Harness.java 这个极小的测试运行器只做「用例隔离 失败报告」两件事避免为几十个用例引入一整套框架顺序固定的入口tests/RunTests.java 显式列出所有测试套件遗漏某个套件会直接变成编译错误而不是被静默跳过。运行结束时若全部通过退出码为 0并打印类似N suites, M cases, ... passed, 0 failed的汇总。 第三步release.sh 构建自包含发布 jar要发布给用户需要把扫描引擎一起打包。release.sh 构建一个自包含、带时间戳的发布 jar./release.sh # 产物dist/opentrap_UTC时间戳.jar与build.sh的开发版不同它会把裁剪后的 OWASP ZAP 引擎作为资源文件opentrap/engine/engine.zip内嵌进 jar。用户首次运行时引擎会被解压到~/.opentrap/engine并以独立 Java 进程 headless 启动通过本地 HTTP API 驱动因此单个 jar 即可离线扫描。# 运行方式下载一个文件即可 java -jar dist/opentrap_20261104-033756.jar构建以 UTC 时间戳YYYYMMDD-HHMMSS作为文件名和 jar 的Implementation-Version应用会把它显示在标题栏。注意测试浏览器约 680 MB不会被打进 jar而是作为应用内可选下载保持发布包精简。若本地没有engine/脚本会提示先运行./fetch-zap.sh。 第四步package-appimage.sh 打包单文件 AppImage这是整个发布链路的终点产物是唯一对外发布的文件。package-appimage.sh 依次完成./package-appimage.sh # 产物dist/opentrap-x86_64.appimage确保存在便携 JDK没有会自动调用./fetch-jdk.sh并把它设为后续所有构建步骤的JAVA_HOME调用 release.sh 生成自包含发布 jar首次运行时联网下载appimagetool打包工具以便携 JDK 作为运行时镜像Temurin 不带jmods所以直接整份复制并剔除不需要的部分而不是用jlink重新打包用jpackage --type app-image生成自包含的应用镜像主类为 opentrap.ui.Main组装AppDir写入一个会先探测 HiDPI 缩放再启动 JVM 的AppRun启动器详见 package-appimage.sh最后由appimagetool打成单文件。 为什么必须保留完整的bin/java和模块集因为扫描引擎是第二个独立的 Java 进程它需要java.home/bin/java来启动。若像jpackage默认那样裁剪运行时引擎就会因缺少bin/java而失败。 验证与发布确认可移植性并推送 AppImage打包完成后建议先手动跑一遍 AppImage确认能正常弹出窗口并跑通一次爬取与扫描。若需要确认可移植性每个二进制最多依赖GLIBC_2.17可用readelf检查见 MAINTAINING.md 中的验证命令。确认无误后用 publish.sh 发布./publish.sh timestamp notes.md其中timestamp是内嵌在 AppImage 里的那个 jar的时间戳不是dist/里随便一个旧的notes.md是发布说明。脚本会校验 AppImage 与 jar 的一致性、上传为固定名opentrap-x86_64.appimage并标记为最新。发布前想看看哪些依赖有新版本可运行 tools/check-updates.sh。 构建命令速查表命令产物用途./fetch-jdk.sh/./fetch-zap.shjdk//engine/拉取锁定版本的 JDK 与扫描引擎./build.shdist/opentrap.jar轻量开发版 jar不含引擎./run.sh-启动开发版自动适配高分屏./test.sh-编译并运行完整测试套件./release.shdist/opentrap_时间戳.jar内嵌引擎的自包含发布 jar./package-appimage.shdist/opentrap-x86_64.appimage唯一的发布产物单文件 AppImage./publish.sh-校验并推送 AppImage 发布❓ 常见问题速查开发版和发布版 jar 有什么区别开发版build.sh不内嵌扫描引擎、体积小适合日常开发发布版release.sh把 ZAP 引擎打进 jar用户下载单文件即可离线扫描。为什么我的 AppImage 在旧系统上打不开多半是用了系统的新版 JDK 打包。请删除jdk/后重新运行 fetch-jdk.sh 拉取便携 Temurin JDK再打包。测试浏览器为什么不在发布包里它约 680 MB会拖慢下载。因此做成应用内可选下载缺省时回退到系统里已安装的 Chromium。我想给项目提交改动流程是什么先阅读 CONTRIBUTING.md从main拉分支 → 修改 →./build.sh ./run.sh验证 → 提交并发起 Pull Request。带有逻辑的改动应附上测试用例测试统一放在tests/目录。至此你已经完整走通了从源码构建 OpenTRAP的全流程拉取锁定依赖 →build.sh编译 →test.sh测试 →release.sh打自包含 jar →package-appimage.sh打包 AppImage →publish.sh发布。掌握这条链路后无论是本地调试还是参与贡献都能从容应对。赞分享【免费下载链接】opentrapA free, open-source alternative to Burp Suite: an intercepting proxy and web app security testing suite with Repeater, Intruder, Collaborator and a built-in OWASP ZAP scanner. Linux, AGPL-3.0.项目地址https://gitcode.com/gh_mirrors/op/opentrap点击查看免费下载相关推荐PowerInfer模型转换从Hugging Face到GGUF格式的完整指南PowerInfer模型转换从Hugging Face到GGUF格式的完整指南 你是否曾经遇到过这样的困境在Hugging Face上找到了心仪的大语言模型人工智能大模型推理引擎本地部署Helium-linux打包全流程拆解从构建产物到AppImage与deb的完整教程Helium linux打包全流程拆解从构建产物到AppImage与deb的完整教程 helium linux 是开源浏览器 Helium Browser h从源码到安装包DS4Windows完整构建指南从源码到安装包DS4Windows完整构建指南 你是否曾想将DS4Windows的最新功能分享给朋友却卡在复杂的编译步骤本文将带你从零开始完成从源码克隆游戏开发驱动开发上一篇llama-160m-accelerator 为什么能加速大模型推理多阶段 MLP 投机解码原理终极揭秘下一篇granite-4.0-h-tiny-w4a16-llmcompressor环境搭建教程如何快速配置ZenDNN、ZenTorch与OpenMP LD_PRELOAD完整指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考