PyArmor Documentation v6.2.7

• 语言: 英语
• 格式: .epub
• 来源: pyarmor.readthedocs.io

摘要

PyArmor is a command-line tool used to obfuscate Python scripts, bind them to specific machines, or expire obfuscated scripts. It protects Python scripts through code obfuscation, runtime code protection, and license verification. PyArmor supports Python 2.6, 2.7, and Python 3, and has been tested on Windows, macOS, and Linux. It also supports FreeBSD and various embedded platforms like Raspberry Pi. The tool includes features like generating licenses, extending license types, obfuscating single modules or packages, and advanced security modes. The document details various versions, installation procedures, and advanced topics such as using super mode for enhanced security.

AI总结

《PyArmor Documentation v6.2.7》是PyArmor工具的官方文档，介绍了PyArmor的功能、安装、使用方法以及版本更新日志。PyArmor是一款用于混淆Python脚本的命令行工具，主要功能包括：

1. **核心功能**：
- **代码混淆**：保护常量和字面字符串，混淆函数的`co_code`。
- **清除本地变量**：在代码执行完成后清除帧的`f_locals`。
- **许可证验证**：运行时验证许可证文件。

2. **支持平台与版本**：
- 支持Python 2.6、2.7和3.x。
- 已在Windows、MacOS、Linux、FreeBSD及嵌入式平台（如Raspberry Pi、Banana Pi等）上测试。

3. **主要功能模块**：
- **安装与配置**：包括安装、验证、卸载及设置环境变量`PYARMOR_HOME`。
- **混淆脚本**：支持单模块和整个包的混淆。
- **许可证管理**：生成、扩展和验证许可证。
- **高级功能**：包括超级模式（Super Mode）、插件扩展、动态库保护等。

4. **超级模式**（Super Mode）：
- 提供最高安全级别的保护，通过改变`PyCode_Type`结构实现。
- 生成唯一的运行时文件`pytransform.so`，简化保护脚本的结构。
- 支持Python 2.7、3.7、3.8，后续计划支持3.5和3.6。

5. **变更日志**：
- **6.2.7**：修复Darwin平台崩溃问题，完善数据文件保护文档。
- **6.2.6**：修复许可证信息获取问题。
- **6.2.5**：新增`--with-license`选项，优化代码混淆逻辑。
- **6.2.4**：修复Mac和Windows 32位系统的许可证问题。
- **6.2.3**：支持设置`PYARMOR_HOME`，优化打包功能。
- **6.2.2**：修复超级模式下的兼容性问题，支持更多平台。
- **6.2.1**：修复许可证绑定网络卡问题，支持更多平台（如iOS、PPC64LE）。
- **6.2.0**：引入超级模式，优化许可证管理。

6. **其他功能**：
- 提供GUI向导和命令行工具。
- 支持插件扩展许可证类型。
- 提供性能优化和文档支持。

总结来看，PyArmor是一款功能强大、多平台适用的Python脚本保护工具，通过代码混淆、本地变量清除和许可证验证等手段，有效保护Python脚本的安全性。其超级模式和插件机制进一步提升了安全性和灵活性，适用于对代码保护有较高要求的场景。