Pyarmor高级功能使用指南：代码混淆与保护进阶技巧

Pyarmor高级功能使用指南：代码混淆与保护进阶技巧

pyarmor A tool used to obfuscate python scripts, bind obfuscated scripts to fixed machine or expire obfuscated scripts. 项目地址: https://gitcode.com/gh_mirrors/py/pyarmor

前言

Pyarmor作为一款专业的Python代码保护工具，提供了多种高级功能来增强代码安全性。本文将深入介绍Pyarmor的高级特性，包括RFT模式、BCC模式、错误处理定制等，帮助开发者更好地保护Python代码。

RFT模式（重构模式）

RFT（Refactor）模式是Pyarmor Pro版本提供的强大功能，它能在源代码级别重构Python脚本，重命名大多数内置名称、函数、类和局部变量。

启用RFT模式

使用--enable-rft选项即可启用RFT模式：

pyarmor gen --enable-rft foo.py

RFT模式工作原理

RFT模式会对代码进行深度转换，例如：

原始代码：

import sys

def sum2(a, b):
    return a + b

转换后代码：

pyarmor__17 = __assert_armored__(b'\x83\xda\x03sys')

def pyarmor__22(a, b):
    return a + b

注意事项

1. RFT模式不会修改__all__模块属性中的名称
2. 不会改变函数参数名称
3. 对于不确定是否能重命名的名称，会保持原样

调试RFT模式

如需查看具体重构效果，可启用跟踪功能：

pyarmor cfg trace_rft=1
pyarmor gen --enable-rft foo.py

转换后的脚本将保存在.pyarmor/rft目录下。

BCC模式（字节码转换模式）

BCC（Bytecode to C）模式是另一项Pro功能，它能将Python函数和方法转换为等效的C函数，直接编译为机器指令执行。

准备工作

BCC模式需要C编译器支持：

• Linux/Darwin：gcc或clang
• Windows：仅支持clang.exe

启用BCC模式

pyarmor gen --enable-bcc foo.py

调试与排除

1. 查看哪些函数被转换：

pyarmor cfg enable_trace=1
pyarmor gen --enable-bcc foo.py
grep trace.bcc pyarmor.trace.log

2. 排除特定函数：

pyarmor cfg -p foo bcc:excludes "sum2"

3. 排除整个模块：

pyarmor cfg -p joker.card bcc:disabled=1

错误处理定制

Pyarmor允许自定义运行时错误处理方式：

1. 仅显示错误信息：

pyarmor cfg on_error=1

2. 静默退出：

pyarmor cfg on_error=2

3. 恢复默认：

pyarmor cfg on_error=0

字符串混淆过滤

Pyarmor提供了灵活的字符串混淆配置：

1. 设置最小混淆长度：

pyarmor cfg mix.str:threshold 10

2. 使用正则表达式排除：

pyarmor cfg mix.str:excludes "/.{1000,}/"

3. 指定包含规则：

pyarmor cfg mix.str:includes = "/.{8,32}/"

跨平台支持

Pyarmor支持生成跨平台运行的混淆脚本：

pyarmor gen --platform windows.x86_64 --platform linux.x86_64 foo.py

多Python版本支持

使同一混淆脚本支持多个Python版本：

1. 为每个Python版本安装Pyarmor
2. 启用MultiPythonPlugin插件
3. 为每个版本生成独立输出
4. 合并输出目录

python3.8 -m pyarmor.cli gen -O dist1 foo.py
python3.9 -m pyarmor.cli gen -O dist2 foo.py
python3.8 -m pyarmor.cli.merge -O dist dist1 dist2

共享运行时包

可预先生成运行时包并重复使用：

1. 生成运行时包：

pyarmor gen runtime -O build/my_runtime1

2. 使用运行时包：

pyarmor gen --use-runtime build/my_runtime1 foo.py
cp -a build/my_runime1/pyarmor_runtime_000000 dist/

结语

Pyarmor提供了多种高级功能来满足不同场景下的代码保护需求。通过合理配置RFT模式、BCC模式以及各种过滤规则，开发者可以在保证代码安全性的同时，兼顾运行效率和兼容性。建议根据实际项目需求，选择合适的功能组合进行代码保护。

pyarmor A tool used to obfuscate python scripts, bind obfuscated scripts to fixed machine or expire obfuscated scripts. 项目地址: https://gitcode.com/gh_mirrors/py/pyarmor