{"id":13577439,"url":"https://github.com/yj94/BinarySpy","last_synced_at":"2025-04-05T11:32:56.543Z","repository":{"id":250461506,"uuid":"829948477","full_name":"yj94/BinarySpy","owner":"yj94","description":"一个手动或自动patch shellcode到二进制文件的免杀工具/A tool for manual or automatic patch shellcode into binary file oder to bypass AV.","archived":false,"fork":false,"pushed_at":"2024-09-10T19:41:56.000Z","size":2982,"stargazers_count":405,"open_issues_count":0,"forks_count":56,"subscribers_count":7,"default_branch":"main","last_synced_at":"2024-10-29T18:07:23.170Z","etag":null,"topics":["binary","bypass-antivirus","patcher","shellcode"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/yj94.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-07-17T10:02:51.000Z","updated_at":"2024-10-29T02:50:46.000Z","dependencies_parsed_at":"2024-07-27T16:39:53.000Z","dependency_job_id":"4e94ea29-5066-4235-bf2d-9509826a5d9f","html_url":"https://github.com/yj94/BinarySpy","commit_stats":null,"previous_names":["yj94/binaryspy"],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yj94%2FBinarySpy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yj94%2FBinarySpy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yj94%2FBinarySpy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yj94%2FBinarySpy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yj94","download_url":"https://codeload.github.com/yj94/BinarySpy/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223150795,"owners_count":17095959,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["binary","bypass-antivirus","patcher","shellcode"],"created_at":"2024-08-01T15:01:21.475Z","updated_at":"2024-11-05T14:31:13.204Z","avatar_url":"https://github.com/yj94.png","language":"Python","funding_links":[],"categories":["Python","逆向破解"],"sub_categories":[],"readme":"# BinarySpy\n\n\u003e A tool for manual or automatic patch shellcode into binary file Oder to bypass AV.\n\u003e\n\u003e 一个手动或自动patch shellcode到二进制文件的工具\n\n## 1.GUI\n\n![1721527665615](image/README/1721527665615.png)\n\n## 2.使用方法\n\n+ 待patch的pe文件路径就是要被patch shellcode的pe文件\n+ VA\n  + 手动: **[待PE文件的VA]** 就是该pe文件的要被patch虚拟地址\n  + 自动:无需填写VA，但需填写 **[patch的函数大小]**\n  + Fuzz:只需填写 **[待patch的PE文件路径]** 和 **[待patch的.text或pe文件路径]**\n+ **[待patch的.text或pe文件路径]** 就是shellcode的text段\n  + 内容可自动提取或者选择非.exe结尾的文件作为.text文件\n+ 可选Fuzz模式，会生成多个patch后的文件\n+ 最后,点击执行或者Fuzz即可\n+ 注意:仅限于x64的程序patch且语言为C,其他语言适配请等更新,shellcode请自己实现,calc的shellcode特征已被标记\n+ ![1722243483254](image/README/1722243483254.gif)\n\n## 3.一些问题\n\n+ shellcode\n  + 开发模板 [https://github.com/clownfive/CppDevShellcode](https://github.com/clownfive/CppDevShellcode)\n  + 建议远程加载cs的shellcode以减少体积\n+ 白文件(待patch文件)\n  + 尽量选体积较大的文件\n  + 尽量选择子系统不为控制台的文件(黑框)\n    + 解决方法：https://github.com/yj94/BinarySpy/issues/1\n\n## 4.效果\n\n\u003e 截止2024年7月27日 shellcode为自行编写\n\n+ ![1722059003365](image/README/1722059003365.png)\n+ ![1722058826723](image/README/1722058826723.png)\n+ ![1722059388241](image/README/1722059388241.png)\n\n## Star History\n\n\u003ca href=\"https://star-history.com/#yj94/BinarySpy\u0026Date\"\u003e\n \u003cpicture\u003e\n   \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://api.star-history.com/svg?repos=yj94/BinarySpy\u0026type=Date\u0026theme=dark\" /\u003e\n   \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"https://api.star-history.com/svg?repos=yj94/BinarySpy\u0026type=Date\" /\u003e\n   \u003cimg alt=\"Star History Chart\" src=\"https://api.star-history.com/svg?repos=yj94/BinarySpy\u0026type=Date\" /\u003e\n \u003c/picture\u003e\n\u003c/a\u003e\n\n# 一种基于patch免杀技术的自动化实现\n\n## 起因\n\n先从一个样本分析开始 https://www.52pojie.cn/thread-1900852-1-1.html\n\n从标题“三年了，还是VT全绿，它到底凭什么？”\n\n可以分析得到这个样本的静态特征非常不明显\n\n具体原因简单来说就是：白文件执行流程中的某函数被修改为恶意shellcode代码\n\n## 理论\n\n+ 你需要掌握的\n\n  + PE文件结构\n  + shellcode编写\n  + IDA基础分析\n+ 我来讲讲 例子:7za.exe\n\n  + ![1721532970812](image/README/1721532970812.png)\n  + 先来一个概念 地址\n    + 虚拟地址 但PE bear给的虚拟地址是RVA\n    + 用CFF Explorer转换一下\n    + ![1721533427318](image/README/1721533427318.png)\n    + VA就是0000000140001000\n    + FO文件偏移就是00000400\n  + IDA分析\n    + 将例子程序拖入IDA\n    + ![1721534254590](image/README/1721534254590.png)\n    + IDA贴心的直接定位到了main函数\n    + 这个程序的main函数调用的函数只有两个\n\n      + sub_14004E4A0\n      + sub_1400550B0\n    + **既然要patch就得满足几个条件**\n\n      + **目标函数大**\n      + **目标函数必定在主函数执行流程中**\n      + **目标函数尽量在text段首**\n      + **要patch的shellcode体积尽量小**\n    + ![1721534478946](image/README/1721534478946.png)\n\n      + sub_14004E4A0 太小了 不行\n    + ![1721534539785](image/README/1721534539785.png)\n\n      + sub_1400550B0 很大 可以\n    + 用CFF转换得到FO\n\n      + ![1721534851571](image/README/1721534851571.png)\n    + 000544B0\n    + 用010手动开始patch\n\n      + ![1721535158247](image/README/1721535158247.png)\n      + ![1721535139625](image/README/1721535139625.png)\n      + ![1721535182013](image/README/1721535182013.png)\n    + patch完后打开就弹计算器了 这里作为测试 实战中可以换为自己编写的shellcode\n\n      \u003e https://github.com/clownfive/CppDevShellcode\n      \u003e\n\n## 自动化\n\n\u003e 以下例子只争对提供的程序\n\n+ 思考一个问题：怎么实现该流程的自动化patch？\n+ 回答\n\n  + 手动的patch方法无非就是：1.找到要patch的函数VA 2.VA转OF 3.直接替换为shellcode\n+ 缺漏\n\n  + 怎么找到符合条件的函数？\n+ 大部分人遇到这些问题都觉得 我只要反汇编PE文件 然后转伪代码就知道哪个函数符合条件了，可是这个说起来容易，实践起来可要自实现一个disassembler啊！而且要讲究不同编译器，不同架构，甚至不同语言的差异！\n+ 思路\n\n  + 找函数的push ebp rbp，sub esp rsp，作为函数开头特征\n+ 根据思路找到了函数\n\n  + 但是出现问题，函数是有执行调用流程的\n  + 比如main函数，被crt运行时函数调用![1721536154092](image/README/1721536154092.png)\n  + 而crt被start函数(entrypoint))调用![1721536179217](image/README/1721536179217.png)\n+ 那咋办？\n\n  + 寻找特征\n  + 通常，在初始化时，CRT 会调用  **`__security_init_cookie`** 。 如果绕开 CRT 初始化（例如，使用 [`/ENTRY`](https://learn.microsoft.com/zh-cn/cpp/build/reference/entry-entry-point-symbol?view=msvc-170) 指定一个入口点），则必须自己调用  **`__security_init_cookie`** 。 如果不调用  **`__security_init_cookie`** ，全局安全 Cookie 将设定为默认值，缓冲区溢出保护将受到威胁。 由于攻击者可利用此默认 Cookie 值使缓冲区溢出检查无效，我们建议，在定义自己的入口点时，始终调用  **`__security_init_cookie`** 。\n  + 而crt函数通常作为第二个call调用![1721536445823](image/README/1721536445823.png)\n+ 那就找索引为1的函数就可以了！我真聪明！\n\n  + **没错，你已经解决了一个问题**\n+ crt的魔鬼关\n\n  + 进入crt函数的你，懵了，给我干哪来了，这还是国内吗？\n  + 古怪的函数调用 不同编译器的程序的crt都是不一样的![1721536579855](image/README/1721536579855.png)\n  + 而且全是call![1721536642671](image/README/1721536642671.png)\n  + 这下还能用索引吗？不能！\n+ 闯出crt\n\n  + 经过大量c程序(x64)分析\n  + 每个crt调用主函数的时候都会有同一个特征\n  + **mov r8,xxx**\n  + 我们找到这段操作码的地址为索引找往下最近的call不就找到main函数了嘛？\n  + **真聪明，又解决了一个问题**\n+ 险恶的主\n\n  + 过了crt到主函数了，哥们特征哪去了？怎么全是call啊也！![1721536887069](image/README/1721536887069.png)\n  + 虽然我们知道要patch的是sub_1400550B0\n  + 但是在这之前有很多call，每个程序的call数量都不一样所以不能用索引定位，也没有同一个特征\n+ 主，看看你的ret\n\n  + 先进到sub_14004E4A0看看函数结构![1721537052543](image/README/1721537052543.png)\n  + sub_14004E4A0你好短！一会儿就C3(ret)了\n  + 学过pwn的大佬已经发现了规律\n  + pusb rbx到ret的地址理论上也代表了函数的相对大小\n  + 我们用后者减去前者不久得到了这个大小嘛？\n  + **你好聪明！太棒了**\n\n## 实现\n\n### BinarySpy 程序流程文档\n\n#### 简介\n\nBinarySpy 是一个用于修改 PE 文件的工具，主要功能包括提取 .text 节区和覆盖 .text 节区。程序使用 `tkinter` 进行图形界面展示，依赖于 `pefile` 和 `capstone` 库进行 PE 文件操作和反汇编。\n\n#### 程序依赖\n\n- Python 3.x\n- tkinter\n- pefile\n- capstone\n- os\n\n#### 主要功能\n\n1. 提取 PE 文件中的 .text 节区。\n2. 使用新的 .text 节区数据覆盖已有的 PE 文件。\n3. 自动检测和 patch 代码段。\n\n## 详细流程\n\n### 1. VA 转换为 RVA\n\n函数：`va_to_rva(pe, va)`\n\n- 输入：PE 文件对象 `pe`，虚拟地址 `va`\n- 输出：相对虚拟地址 `rva`\n\n### 2. RVA 转换为文件偏移\n\n函数：`rva_to_offset(pe, rva)`\n\n- 输入：PE 文件对象 `pe`，相对虚拟地址 `rva`\n- 输出：文件偏移 `offset`\n\n### 3. 替换 .text 节区\n\n函数：`replace_text_section(pe_file_path, text_bin_path, va)`\n\n- 输入：PE 文件路径 `pe_file_path`，新的 .text 文件路径 `text_bin_path`，虚拟地址 `va`\n- 流程：\n  1. 将 VA 转换为 RVA。\n  2. 将 RVA 转换为文件偏移。\n  3. 用新的 .text 数据覆盖原 PE 文件中对应的部分。\n\n### 4. 提取 .text 节区\n\n函数：`extract_text_section(pe_path, output_path)`\n\n- 输入：PE 文件路径 `pe_path`，输出文件路径 `output_path`\n- 流程：\n  1. 读取 PE 文件。\n  2. 查找 .text 节区。\n  3. 提取 .text 节区数据并保存到指定文件。\n\n### 5. 浏览文件\n\n函数：`browse_file(entry, title, filetypes)`\n\n- 输入：文本框 `entry`，对话框标题 `title`，文件类型 `filetypes`\n- 流程：\n  1. 打开文件浏览对话框。\n  2. 获取选择的文件路径。\n  3. 将文件路径显示在文本框中。\n\n### 6. 校验十六进制字符串\n\n函数：`is_hex(s)`\n\n- 输入：字符串 `s`\n- 输出：布尔值，表示是否为有效的十六进制数\n\n### 7. 检查文件可读性\n\n函数：`check_file_readable(file_path)`\n\n- 输入：文件路径 `file_path`\n- 输出：布尔值，表示文件是否存在且可读\n\n### 8. 执行功能\n\n函数：`execute()`\n\n- 流程：\n  1. 获取用户输入的 PE 文件路径、VA 和 .text 或 PE 文件路径。\n  2. 校验输入的有效性。\n  3. 根据用户输入决定提取 .text 节区或直接覆盖 .text 节区。\n  4. 提示操作成功或失败。\n\n### 9. 自动 Patch 代码段\n\n函数：`find_crt_function(pe_path)` 等系列函数\n\n- 流程：\n  1. 查找CRT函数入口点。\n  2. 查找CRT函数中mov r8操作指令。\n  3. 查找mov r8向下附近的call，找到main函数。\n  4. 查找main函数中call的函数，同时分析函数开头到ret的地址大小，若符合即为可patch函数。\n\n### GUI 界面\n\n- 使用 `tkinter` 创建图形用户界面。\n- 包含文本框、标签、按钮等元素，用户通过界面进行文件选择和操作。\n- 主界面启动后，用户可以选择待修改的 PE 文件、输入 VA 和 .text 或 PE 文件路径，点击“执行”按钮开始操作。\n\n## 注意事项\n\n+ 目标pe为x64 c程序\n+ 确保crt为程序入口第二个jmp\n  + 不同编译器 编译器选项可能导致不同\n+ shellcode请尽量小\n+ patch函数必须为执行流程中被调用的\n+ patch函数尽量找大的\n+ patch后数字签名会失效\n\n## 参考\n\nhttps://mp.weixin.qq.com/s/b0mphQG-nny0X087JsjsKQ\n\nhttps://www.52pojie.cn/thread-1900852-1-1.html\n\nhttps://learn.microsoft.com/zh-cn/cpp/c-runtime-library/reference/security-init-cookie?view=msvc-170\n\n## 免责声明\n\n(1) 本项目仅用于网络安全技术的学习研究。旨在提高安全开发能力，研发新的攻防技术。\n\n(2) 若执意要将本项目用于渗透测试等安全业务，需先确保已获得足够的法律授权，在符合网络安全法的条件下进行。\n\n(3) 本项目由个人独立开发，暂未做全面的软件测试，请使用者在虚拟环境中测试本项目功能。\n\n(4) 本项目完全开源，请勿将本项目用于任何商业用途。\n\n(5) 若使用者在使用本项目的过程中存在任何违法行为或造成任何不良影响，需使用者自行承担责任，与项目作者无关。\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyj94%2FBinarySpy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyj94%2FBinarySpy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyj94%2FBinarySpy/lists"}