PyArmor Documentation v5.5.4

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

摘要

PyArmor 是一个用于混淆和保护 Python 脚本的命令行工具，通过混淆代码对象、在运行时保护字节码以及验证许可证文件来实现脚本保护。它支持多种模式，包括高级模式和混淆代码模式，并适用于 Windows、Mac OS X 和 Linux 等平台。文档详细介绍了其安装、使用方法、许可证管理以及与 PyInstaller 和其他工具的集成。此外，PyArmor 还提供了针对动态库 _pytransform 的保护机制，并支持嵌入式平台如 Raspberry Pi 等。

AI总结

《PyArmor 文档》总结：

PyArmor 是一个用于保护 Python 脚本的命令行工具，主要功能包括混淆代码、绑定脚本到特定机器或设置过期时间。它通过以下方式保护脚本：
- **混淆代码对象**：保护常量和字符串。
- **运行时混淆**：在运行时混淆每个函数的 `co_code`。
- **清除局部变量**：脚本执行完成后清除局部变量。
- **验证许可证**：运行时检查许可证文件。

### 主要功能
1. **安装与使用**：
- 支持 Python 2.6、2.7 和 Python 3。
- 适用于 Windows、MacOS 和 Linux，部分嵌入式平台（如 Raspberry Pi）也可用。
- 提供安装验证和命令行工具。

2. **核心保护机制**：
- **混淆代码**：保护脚本内容，防止逆向工程。
- **许可证验证**：确保脚本在授权设备上运行。
- **动态库保护**：通过 `_pytransform` 库增强安全性。

3. **运行时模块**：
- `pytransform` 模块负责核心保护功能，包括代码还原和验证。

4. **性能与兼容性**：
- 并未显著影响脚本性能。
- 支持多平台和常见嵌入式系统。

### 重要更新
- **版本 5.5.4**：
- 引入新命令 `pack`，支持使用 PyInstaller 打包混淆后的脚本。
- 升级胶囊文件 `pytransform.key`，替代旧的 `pyshield.key` 和 `product.key`。
- 支持插件扩展许可证类型。
- 修复 multiprocessing 在混淆脚本中的问题。

- **安全性增强**：
- 提升 `_pytransform` 动态库的保护。
- 添加反调试代码，防止逆向分析。

- **性能优化**：
- 优化代码混淆和运行时保护流程。

### 使用场景
- **开发者**：保护敏感脚本，防止反编译和恶意使用。
- **分发商**：通过许可证控制脚本的使用范围和有效期。

总结：PyArmor 是一个功能强大的脚本保护工具，适用于需要防止逆向工程和恶意使用场景，支持多平台和多种保护模式，适合开发者和分发商使用。