PyArmor Documentation v5.9.5

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

摘要

《PyArmor Documentation v5.9.5》详细介绍了PyArmor工具的功能和更新日志。PyArmor是一个命令行工具，用于混淆Python脚本，并将混淆后的脚本绑定到固定机器或设置过期时间。它通过混淆代码对象、函数代码、清除帧的局部变量以及验证许可证文件等方式保护Python脚本。PyArmor支持Python 2.6、2.7和Python 3，并在Windows、Mac OS X、Linux等平台上进行了测试。文档还记录了各版本的更新内容，包括新增的加密模式、性能优化、错误修复、新功能（如Web GUI界面）以及对不同平台的支持改进。

AI总结

《PyArmor Documentation v5.9.5》主要介绍了PyArmor工具的功能、更新日志以及使用说明。以下是核心内容的总结：

### 1. **PyArmor 概述**
- **功能**：PyArmor 是一个命令行工具，用于混淆 Python 脚本，支持将混淆后的脚本绑定到特定设备或设置过期时间。
- **保护机制**：通过混淆代码对象、运行时混淆函数的 `co_code`、清除执行完成后的 `f_locals` 以及验证许可证文件等方式保护 Python 脚本。
- **兼容性**：支持 Python 2.6、2.7 和 Python 3，兼容 Windows、Mac OS X、Linux 等平台，并在嵌入式平台（如 Raspberry Pi）上有一定测试。

### 2. **主要更新日志**
- **5.9.0 版本**：
- 引入 Web GUI 界面（Pyarmor WebApp），支持通过 `MANIFEST.in` 文件列出加密文件。
- 加密命令支持保存与源文件相同的文件结构，新增 `--manifest` 选项。
- 优化解密机制，提升性能，修复递归调用中的未知操作码问题。
- **3.0.1 版本**：
- 使用 `ctypes` 加载核心库，不再需要为每个 Python 版本构建扩展。
- 避免通过 C 调试器获取源代码，默认输出路径改为 `build`。
- **2.3.4 版本**：
- 试用版许可证不再过期（但加密脚本的密钥固定）。
- **3.2.0 版本**：
- 引入新的混淆模式，显著提升运行和导入混淆脚本的性能，默认使用此模式。
- 新增 `benchmark.py` 脚本用于测试目标机器性能。
- **4.3.0 版本**：
- 简化 Web UI，提供清晰的示例和模板脚本，方便用户快速混淆 Python 脚本。
- 运行时文件始终保存在与混淆脚本相同的路径中。

### 3. **其他重要更新**
- **性能优化**：引入多种加密模式（如模式 2 和 3），提升加密脚本的性能。
- **平台支持**：修复了在 Linux x86_64、MacOS 等平台上的兼容性问题，支持 ARMv6 架构。
- **许可证绑定**：新增 `--bind-mac`、`--bind-ip`、`--bind-domain` 等选项，支持将许可证绑定到特定设备或网络。
- **文档改进**：更新了文档和示例，修复了示例中的错误，并提供了更清晰的使用说明。

### 4. **问题修复**
- 修复了 `py2exe`、`odoo` 与 PyArmor 混淆脚本的兼容性问题。
- 修复了异常追踪中模块名显示不正确的问题。
- 修复了 `sys.settrace` 和 `sys.setprofile` 在自动包装模式下的问题。

### 5. **总结**
PyArmor 通过不断优化混淆机制和提升性能，增强了 Python 脚本的保护能力，同时提供了更友好的用户界面和详细的文档，帮助用户更高效地使用该工具。