当前位置：首页 > news >正文

PyArmor-Unpacker深度解析：从Python字节码到解密实战

news 2026/7/18 9:05:40

PyArmor-Unpacker深度解析：从Python字节码到解密实战

【免费下载链接】PyArmor-UnpackerA deobfuscator for PyArmor.项目地址: https://gitcode.com/gh_mirrors/py/PyArmor-Unpacker

PyArmor-Unpacker是Python代码保护工具PyArmor的终极反混淆器，专门用于解密和还原被PyArmor保护的Python代码。无论你是安全研究人员、逆向工程师，还是需要分析被保护的Python脚本的开发者，这个工具都能帮助你轻松获取原始代码。本文将详细介绍PyArmor-Unpacker的工作原理、三种解密方法以及实战应用指南，让你全面掌握Python代码反混淆技术。

为什么需要Python代码反混淆工具？

Python作为解释型语言，源代码容易被查看和修改，这使得代码保护变得尤为重要。PyArmor作为流行的Python代码保护工具，通过加密字节码、添加运行时保护等方式来防止代码被轻易逆向。然而，在某些合法场景下，如代码审计、安全分析、代码恢复等，我们需要能够解密这些被保护的代码。

PyArmor-Unpacker应运而生，它提供了三种不同的解密方法，覆盖了从动态注入到静态分析的各种需求场景。无论面对哪种PyArmor保护模式，你都能找到合适的解决方案。

PyArmor保护机制深度剖析

要理解PyArmor-Unpacker的工作原理，首先需要了解PyArmor的保护机制。PyArmor通过以下方式保护Python代码：

字节码加密与包装

PyArmor会遍历所有代码对象并加密它们，同时添加固定的头部和尾部包装。当"包装模式"启用时（默认启用），代码结构如下：

# 包装头部 LOAD_GLOBALS N (__armor_enter__) # N = co_consts的长度 CALL_FUNCTION 0 POP_TOP SETUP_FINALLY X (跳转到包装尾部) # X = 原始字节码大小 # 修改后的原始字节码 # 增加每个绝对跳转指令的操作数 # 混淆原始字节码 ... # 包装尾部 LOAD_GLOBALS N + 1 (__armor_exit__) CALL_FUNCTION 0 POP_TOP END_FINALLY

头部调用__armor_enter__函数在内存中解密代码对象，尾部调用__armor_exit__函数重新加密代码对象，确保没有解密的代码对象留在内存中。

运行时保护机制

PyArmor通过pytransform模块提供运行时保护，该模块包含：

_pytransform.dll（Windows）或_pytransform.so（Linux）：核心保护库
__init__.py：Python接口模块
多种限制模式防止非授权使用

PyArmor-Unpacker的三种解密方法

PyArmor-Unpacker提供了三种不同的解密方法，每种方法适用于不同的场景和Python版本。

方法一：动态注入解密法

这是最直接的解密方法，适用于Python 3.7-3.9版本。操作步骤如下：

准备环境：将methods/method 1/目录下的所有文件复制到要解密的文件所在目录
运行目标程序：启动被PyArmor保护的程序
注入Python代码：使用进程注入工具（如Process Hacker 2）注入PyInjector
执行解密脚本：运行method_1.py文件
运行解密后的程序：使用run.py运行部分解密的程序

这种方法的核心原理是通过进程注入技术，在运行时获取当前执行的代码对象，然后利用PyArmor的运行时函数进行解密。

方法二：完整代码对象修复法

这种方法在方法一的基础上更进一步，不仅解密代码，还完全移除PyArmor的保护层：

准备环境：将methods/method 2/目录下的所有文件复制到目标目录
运行目标程序：启动被保护的程序
注入Python代码：使用PyInjector进行代码注入
获取解密文件：在dumps目录中找到完全解密的.pyc文件
反编译获取源码：使用反编译工具如pycdc获取Python源代码

这种方法的关键创新在于"修复"代码对象。当检测到脚本包含__armor_enter__时，它会修改代码对象，使其在__armor_enter__调用后立即返回，从而获取解密的代码对象而不执行原始字节码。

方法三：静态审计日志解密法（推荐）

这是最先进的解密方法，支持Python 3.9.7及以上版本，无需运行被保护的程序：

准备环境：将methods/method 3/目录下的文件复制到目标目录
执行静态解密：在终端运行python3 bypass.py filename.pyc
获取解密文件：在dumps目录中找到完全解密的.pyc文件
反编译获取源码：使用反编译工具获取原始Python代码

这种方法利用了Python 3.9.7引入的审计日志功能。通过安装审计钩子，可以捕获marshal.loads调用，从而在PyArmor解密代码对象时获取它们，实现完全静态的解密过程。

技术实现细节解析

绕过限制模式

PyArmor的默认限制模式会阻止非授权使用。PyArmor-Unpacker通过内存补丁技术绕过这一限制：

import ctypes from ctypes.wintypes import * # 加载_pytransform.dll并修改内存权限 h_pytransform = ctypes.cdll.LoadLibrary("pytransform\\_pytransform.dll") pytransform_base = h_pytransform._handle # 设置内存为可读写执行 VirtualProtect(pytransform_base+patch_offset, num_nops, PAGE_EXECUTE_READWRITE, ctypes.byref(oldprotect)) # 使用NOP指令覆盖限制检查代码 ctypes.memset(pytransform_base+patch_offset, 0x90, num_nops) # 0x90是NOP操作码

处理扩展参数(EXTENDED_ARG)

在修复绝对跳转指令时，需要正确处理EXTENDED_ARG操作码：

def calculate_extended_args(arg: int): """计算必要的EXTENDED_ARG参数""" extended_args = [] new_arg = arg if arg > 255: extended_arg = arg >> 8 while True: if extended_arg > 255: extended_arg -= 255 extended_args.append(255) else: extended_args.append(extended_arg) break new_arg = arg % 256 return extended_args, new_arg

Python使用EXTENDED_ARG操作码处理大于255的参数值，每个EXTENDED_ARG将参数左移8位，确保正确解析大数值参数。

审计钩子技术

方法三的核心是利用Python的审计钩子机制：

import sys def audit_hook(event, arg): if event == "marshal.loads": # 捕获marshal.loads调用，获取解密的代码对象 handle_marshal_loads(arg) elif event == "exec": # 处理exec事件 handle_exec_event(arg) sys.addaudithook(audit_hook)

实战应用指南

选择合适的解密方法

根据你的具体需求选择合适的方法：

方法一：适用于需要快速查看部分解密代码的场景
方法二：适用于需要完整解密代码并进行深入分析的场景
方法三：适用于安全分析场景，避免运行潜在恶意代码

版本兼容性注意事项

方法三仅支持Python 3.9.7及以上版本
所有方法都需要使用与被保护程序相同的Python版本
对于多文件项目，确保处理所有相关模块

常见问题解决

解密失败：检查Python版本是否匹配，确保使用正确的解密方法
内存访问错误：确保有足够的权限进行内存操作
代码执行异常：检查是否正确处理了所有代码对象的递归解密

高级技巧与最佳实践

批量处理多个文件

对于包含多个模块的项目，可以编写脚本批量处理：

import os from pathlib import Path def batch_unpack(directory): """批量解密目录中的所有PyArmor保护文件""" for file_path in Path(directory).glob("**/*.pyc"): if is_pyarmor_protected(file_path): unpack_file(file_path)

集成到自动化工作流

将PyArmor-Unpacker集成到CI/CD管道或自动化分析工具中：

创建自定义解密脚本
添加错误处理和日志记录
集成结果验证机制
自动化报告生成

安全注意事项

仅在合法授权范围内使用解密工具
注意处理可能包含恶意代码的文件
在隔离环境中运行未知代码
定期更新工具以应对新的保护机制

项目架构与代码结构

PyArmor-Unpacker采用模块化设计，主要包含以下核心模块：

核心解密引擎

methods/method 3/bypass.py：静态解密主逻辑
methods/method 2/code.py：动态注入解密逻辑
methods/method 1/code.py：基础注入代码

辅助功能模块

字节码操作工具
内存操作函数
审计钩子管理
文件输出处理

递归解密算法

项目实现了递归解密算法，能够处理嵌套的代码对象：

def recursive_unpack(code_obj): """递归解密所有嵌套的代码对象""" # 解密当前代码对象 unpacked = unpack_code_object(code_obj) # 递归处理常量中的代码对象 for const in unpacked.co_consts: if isinstance(const, types.CodeType): recursive_unpack(const) return unpacked