简介中国蚁剑AntSword2.1.9 完整源码压缩包面向 Web 安全测试人员、渗透测试学习者与开源工具二次开发爱好者。该版本源码包含核心加载器、插件体系与跨平台客户端逻辑可以帮助读者深入理解远程连接管理、命令执行、文件操作、SQL 注入探测等常见功能的实现思路适合作为学习与定制开发的蓝本。压缩包共 2777 个文件约 15.51MB内部以 js、html、css、json 等运行时代码为主辅以 md 文档、license 授权说明、yml 配置及少量图片字体资源其中 js 文件构成业务逻辑与插件脚本json/yml 负责配置项md 文件提供说明与使用文档。已有 1619 人学习/下载。通过阅读源码可掌握 HTTP 协议交互、WebShell 连接原理、插件扩展机制的落地写法也能借鉴其目录结构与多平台适配细节无论用于渗透测试实战还是安全教学都有不错的参考价值。1. 一个源码包为什么值得花时间拆它拿到中国蚁剑源码 antSword-2.1.9.zip这个压缩包的人大多是同一个诉求想在本地把它跑起来搞清楚这东西到底怎么工作的然后按自己的需求改一版。蚁剑在安全测试领域里几乎是必装工具但多数人用的是别人打好的发行版双击就运行遇到问题只能干瞪眼。源码包的价值不在“能运行”而在“能改”。这篇文章不打算复述官方文档也不替作者写说明。我按自己拆源码的习惯把 antSword-2.1.9 从解压到跑通、从目录结构到二次开发的完整路径讲一遍。适合两类人一类是刚接触 Electron 应用开发、想找个真实项目练手的新手另一类是已经被 antSword 某些默认行为折磨过、想从源码层面动手改掉它的熟手。读完你能复现整个构建过程也知道改哪里、为什么改那里会翻车。2. 先把 antSword-2.1.9 跑起来环境、结构与 Loader 机制很多人栽在第一步解压后不知道从哪个文件开始看。antSword 是一个基于 Electron 的跨平台桌面应用源码结构和纯前端项目不一样入口不是index.html而是main.js加上一堆构建配置。我先讲清楚拿到源码包之后应该按什么顺序去读。2.1 解压后先看什么顶层目录清单与文件用途源码包解压后顶层会有antSword-master或类似的一层目录不同打包方式略有差异里面是完整的 Electron 工程。我建议按这个顺序去扫目录路径作用main.jsElectron 主进程入口负责创建浏览器窗口、配置菜单、加载渲染进程package.json项目依赖清单npm 安装、启动脚本都靠它app/渲染进程代码界面、交互、业务逻辑全部在这app/entry/前端入口对应浏览器加载的index.htmlapp/core/核心业务模块请求、会话、数据库等逻辑app/modules/功能模块编码器、解码器、配置、日志等app/ui/基于 Vue 的界面组件app/是重头戏。entry是第一站core是第二站modules是第三站。我见过有人一上来就钻node_modules结果被依赖里的报错带偏浪费大半天。正确路径是先跑起来再读源码。2.2 从零跑通的三个步骤装依赖、起服务、加载界面antSword 的启动方式和常见 Electron 应用不太一样它分成两步先启动一个本地 HTTP 服务再由 Electron 窗口加载这个服务地址。启动脚本在package.json里能看到核心是node_modules/.bin/electron .。具体操作# 第一步安装依赖 npm install # 第二步以开发模式启动 npm run devnpm install是翻车高发区下面单独讲。npm run dev内部执行的是electron .它会读取main.js创建窗口然后加载本地服务。如果之前没有安装过 Electron 运行时建议先确认 Node.js 版本在 14 以上否则electron安装阶段可能直接报错退出。跑起来之后你会看到一个窗口左侧是目标列表右侧是默认的文件管理面板。到这里只是“能用”但离“能改”还差一层你要知道窗口里加载的页面是从哪来的、改了代码怎么生效。antSword 的加载器Loader机制解决了这个问题——它的核心思路是让渲染进程从app/entry/加载真正的业务代码而不是打包进二进制文件里。2.3 Loader 机制怎么读主进程、渲染进程与数据目录的关系antSword 的 Loader 本质上是一个“引导程序”。它会检查数据目录是否存在不存在就初始化然后把app/下的业务代码注入到渲染进程。数据目录默认在用户目录下存放数据库、session、配置等运行时数据。这个目录结构是二次开发绕不开的# 数据目录的典型结构Windows / Linux / macOS 各有差异 ~/.antData/ ├── antSword.db # SQLite 数据库存 URL、session、密码 ├── dbshell/ # 数据库连接会话相关 ├── tmp/ # 临时文件上传下载的过渡目录 └── config.json # 全局配置我一般会先在数据目录里建一个备份副本再动代码。比如改app/modules/里的编码器时先确认改的是app/下的源码而不是数据目录里的缓存——很多人改了半天没生效就是这个原因。改动app/下的任意 JS 文件后在开发者工具里刷新渲染进程CtrlR 或 CmdR就能看到变化不需要重启 Electron。但main.js和package.json的改动必须重启。3. 核心源码拆解初始化、请求会话与核心模块从“会运行”到“看得懂”需要抓住 antSword 的骨架。它的代码量不算小但分层很干净找对入口就能顺着读完主要流程。这一章讲三条主线页面怎么加载出来的、请求怎么发出去的、模块怎么被调用的。3.1 从 entry 到 Vue 实例初始化流程的一句话版本打开app/entry/index.js不同版本可能叫app.js你会看到一个很典型的 Vue 挂载过程创建 Vue 实例、加载核心 API、注册全局方法。关键代码大概是// app/entry/index.js 简化示意 import Vue from vue; import App from ./app.vue; import core from ../core/index; import antSword from ../core/antSword; // 把核心 API 挂到 Vue 原型上所有组件里都能用 Vue.prototype.$antSword antSword; Vue.prototype.$core core; new Vue({ el: #app, render: h h(App) });这段代码说明了两件事一是 antSword 把业务能力全部封装进core和antSword两个对象界面组件只负责调用二是你后续扩展模块时只要往这两个对象上挂内容界面里就能用。这是整个架构设计最舒服的地方。3.2 请求会话怎么管URL、密码与 Session 的存续逻辑antSword 管理“目标”的方式是 session。每个目标对应一个 URL、一组密码和一组配置这些数据持久化在 SQLite 数据库里。发请求时请求模块会按 session 里记录的连接信息去拼 HTTP 包。核心逻辑集中在app/core/request/下入口是request.js。请求会话有几个关键参数在源码里频繁出现url、pass、type连接类型、encoder编码器和decoder解码器。其中type决定了 shell 是用传统动态脚本还是用其他协议encoder决定客户端发出的 payload 会先经过什么变换decoder决定服务端返回的内容怎么还原。这三个参数是二次开发里最常动的。我当初踩过一个坑改了一个自定义编码器的返回值格式结果 shell 全部连不上。后面才想明白编码器的输出必须能被服务端对应的解密逻辑逆向还原前后端是一套配对协议。你在源码里看到的编码器为什么都带着那个“固定密钥”的加解密逻辑就是这个原因。3.3 核心 API 对象$antSword与$core的职责边界$antSword是高层封装给界面和模块用的比如$antSword.request、$antSword.help$core是底层实现比如 HTTP 组包、动态解析、日志写入。二者分工很明确对象层级典型方法用途$antSword业务层request.send()、shell.open()供 Vue 组件调用不碰协议细节$core工具层http.send()、log.info()处理协议细节、写日志、管数据库动手改逻辑前先想清楚你要在哪一层动手。改交互、加功能走$antSword改协议、改底层组包走$core。跨层乱 import 是源码调试里最常见的“找不到原因”事故源。4. 二次开发实战注册一个自定义编码器并跑通全流程后台管理系统是这样改一个功能前你得先找到它的注册表。antSword 里最典型的扩展点就是编码器。编码器负责把客户端发送的数据改造成服务端能识别的格式。默认自带几个常用编码器但很多场景下你得自己写一个。这一章直接把“注册一个新的编码器”这件事从头到尾做一遍。4.1 编码器的工作方式与注册入口在 antSword 里编码器都是Node.js 模块导出一个函数或对象放在app/modules/encoders/下。代码加载器会扫描该目录把每个模块的元信息名字、类型、描述汇总进一个管理器。你的自定义编码器要做的就是三步在app/modules/encoders/下新建一个目录目录里放一个index.js实现encode和decode如果需要的话在管理器的配置里声明“默认使用”或“可选”。目录扫描的机制意味着只要你按约定写好文件界面选择编码器的下拉框里就会自动出现它的名字。默认管理器代码在app/modules/encoders/index.js它会require每个子目录的index.js。4.2 手写一个简单编码器代码结构与参数说明下面这个例子实现了一个“反序混淆 追加时间戳”的编码器。虽然不如内置的 RSA 变种复杂但麻雀虽小五脏俱全——你能看到encode的输入输出约定才是核心。// app/modules/encoders/my_encoder/index.js use strict; /** * 自定义编码器把明文反序并追加一个 4 位随机数 * 输出格式{data: xxx, type: my_encoder} */ class MyEncoder { // 编码客户端 - 服务端 encode(params) { const timestamp Date.now().toString(36).slice(-4); const reversed params.data.split().reverse().join(); return { data: reversed timestamp, type: my_encoder }; } // 解码服务端返回 - 客户端还原 decode(params) { const raw params.data; const pure raw.slice(0, -4); // 去掉时间戳 return pure.split().reverse().join(); } } module.exports MyEncoder;encode接收params.data客户端要发送的内容返回一个{ data, type }对象。data是真正会出现在 HTTP 请求体里的内容type是编码器标识服务端还原时用得到。decode是反向过程如果服务端返回的数据是编码后的客户端必须能解开。参数名称是约定好的data表示负载type是编码器类型。写编码器时别改名否则框架数据处理不了。4.3 让自定义编码器生效改完要重启还是热加载编码器文件改动后在 antSword 界面里直接切换编码器可能看到名字但没有内容。原因在于编码器列表在应用启动时就已经扫描并缓存了。所以开发调试流程是改代码 → 执行渲染进程刷新CtrlR→ 重新打开目标会话。如果是在 Electron 主进程里改东西比如main.js、菜单声明那必须整个退出重启。这一步最容易翻车的地方是自定义编码器encode返回值里的字段没对齐。框架要求返回对象里必须有data和type少了type时数据处理环节会报“类型错误”。调试时打开开发者工具菜单里有入口看 Console 面板报错信息定位代码行号直接在源码里断点。5. 源码调试与排错6 个高频坑与排查手法任何 Electron 应用跑起来容易改起来全是坑。这一章把我实际编译和调试 antSword-2.1.9 时遇到的、以及同事那边反馈过的典型问题记录下来。每一条都是“现象 → 原因 → 解决”的格式照着排查能省大半天。5.1 坑一npm install 永远卡在 node-gyp 编译现象执行npm install时进度条长时间停留在某些原生模块比如better-sqlite3、node-pty最后报错退出。原因这些模块是 C 插件需要本地编译环境。Windows 上缺 Visual Studio Build ToolsmacOS 上缺 Xcode Command Line ToolsLinux 上缺python3和make等基础工具链。解决先安装对应平台的基础编译工具再执行安装。Windows 推荐运行npm install --global windows-build-tools以管理员身份或者手动装 VS Build Tools。装完后删掉node_modules重新npm install。如果网络环境差换npm config set registry https://registry.npmmirror.com提速但这不是编译失败的根本解法。5.2 坑二窗口打开了但页面一片白屏现象Electron 窗口正常弹出里面空白Console 有报错。原因渲染进程加载的是entry/index.html而它引用的 JS/CSS 路径是相对的。如果本地静态服务没启动或app/被放到只读目录加载就会失败。解决确认启动命令里加载的本地址是正确的通常是http://127.0.0.1:port。手动在地址栏打开这个端口看能不能返回index.html。如果不通查端口占用改package.json里的端口配置一般在scripts或config字段里。5.3 坑三改了源码刷新后不生效现象在开发者工具里刷新界面还是老样子改动没出现。原因改的路径不对。很多人本能去改node_modules或数据目录缓存里的同名文件但 antSword 真正运行的代码在app/下的源码目录。解决先用断点或console.log确认你的代码确实被加载执行了。在entry/index.js开头加一行日志刷新看 Console如果没打印说明你改的文件根本不是入口在用的那部分。5.4 坑四请求目标 URL 总被自动加后缀现象添加目标时输入一个干净的http://ip:port保存后再次打开却变成http://ip:port/index.php或其他路径。原因session 配置里带默认入口文件字段。这个字段在app/core的默认配置中写死为index.php很多场景是历史遗留设置。解决编辑目标时把“入口文件”或“默认脚本”字段给清空或改成你自己的实际路径。改源码的话直接在默认配置的初始化位置把默认值改成空字符串。5.5 坑五编码器列表看不到自定义模块现象自定义编码器写好了也放在了规定目录但界面下拉框里就是没有。原因编码器目录扫描在启动时执行一次。如果目录结构不对比如子目录没有index.js或者模块导出的不是函数/对象扫描会被静默跳过。还有一个容易被忽略的app/modules/encoders下的模块路径大小写不一致。解决检查目录名和文件名大小写确认模块有module.exports在扫描逻辑里临时console.log打印文件名对比扫描结果。5.6 坑六Electron 在新系统上弹出安全警告、本地服务拒绝访问现象启动后弹出警告框或页面调接口时请求直接被 block。原因新版 Electron/Chromium 对跨域和本地文件访问策略收紧。源码里如果用的是老式的webSecurity: trueallowRunningInsecureContent组合新环境会卡住。解决在main.js里找BrowserWindow的webPreferences配置按需设置webSecurity: false仅在本地调试时开发布版建议关掉。如果依然被跨域挡还要确认加载的http://127.0.0.1和页面内的请求是否同一个端口不同端口也属于跨域。6. 最后一块把二次开发做扎实——校验你的修改改动不是“能跑”就结束了。antSword 这类工具牵一发动全身尤其是编码器和请求逻辑一个符号改错连目标都连不上。我的习惯是每次改动后做一次三层校验从上到下确认没有破坏既有流程。第一层单元层校验。如果你写了一个纯函数比如编码器的encode/decode直接在 Node 环境里跑断言不用打开界面。这一层能拦截 80% 的逻辑错误。// 单独跑编码器逻辑的冒烟测试 const MyEncoder require(./my_encoder/index.js); const instance new MyEncoder(); const input { data: id }; const encoded instance.encode(input); console.log(encoded.data); // 期望输出反序加时间戳后的内容 // 解码还原 const decoded instance.decode(encoded); console.log(decoded); // 期望输出 id第二层局部集成校验。在 antSword 界面里新建一个 shell 会话选择你刚注册的编码器执行一条最简单命令比如id看返回是否符合预期。这一步能发现“字段类型没对齐”“协议格式与默认解码器不匹配”这类单元层测不出来的问题。推荐用自己有控制权的模拟环境做测试不要拿没授权的系统试。我一般在本机起一个干净的模拟环境把 antSword 对这个环境发请求的原始报文抓出来用脚本比对新旧编码器的报文差异确认改动只影响你打算影响的部分。第三层回归校验。把工程里默认自带的其他编码器全部跑一遍确认它们没被你的改动影响。特别是你如果动了app/modules/encoders/index.js这个扫描文件很容易因为 import 顺序或异常捕获吞掉其他模块。回归校验没有捷径就是老老实实逐个点一遍。最后说一个我自己的习惯改代码之前先看一遍package.json里的版本和作者声明的依赖清单确认你现在的 Node 和 Electron 版本在它声明过的支持范围内。很多源码层面的怪问题是版本错位导致的比如旧版代码里用了新版 API或者反过来。保持环境匹配再谈功能改动。希望这篇笔记能帮你在 antSword 源码里少走一段弯路。本文还有配套的精品资源点击获取