PyArmor Documentation v5.3.0

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

摘要

PyArmor 是一个用于混淆和保护 Python 脚本的命令行工具，通过多种技术手段保护 Python 脚本，包括混淆代码对象、清除局部变量和验证许可证文件。文档详细介绍了其安装、使用方法、运行时保护机制以及不同版本的更新内容，包括许可证绑定、动态库保护和 JIT 技术的应用。

AI总结

### PyArmor 文档总结

PyArmor 是一个用于保护 Python 脚本的命令行工具，主要功能包括混淆代码、绑定脚本到固定设备或设置过期时间。以下是其核心功能和关键信息：

#### 1. **主要功能**
- **代码混淆**：通过混淆代码对象保护常量和字面字符串，并在运行时动态恢复和重新混淆代码。
- **运行时保护**：清除函数执行后的局部变量，防止调试器捕获敏感信息。
- **许可证验证**：在运行时检查许可证文件，确保脚本合法使用。

#### 2. **安装与使用**
- **安装**：通过 `pip install pyarmor` 或 `pip install --upgrade pyarmor` 安装。
- **验证**：使用 `pyarmor --version` 检查是否安装成功。
- **常用命令**：
- `pyarmor obfuscate`：混淆脚本。
- `pyarmor license`：生成和管理许可证。
- `pyarmor pack`：打包混淆后的脚本。

#### 3. **安全性**
- **双重保护**：PyArmor 使用 JIT 技术保护核心动态库 `_pytransform.so`，防止调试器捕获密钥和修改代码段。
- **混淆机制**：对每个函数和整个模块进行双重混淆，运行时仅加载并执行当前调用的函数。

#### 4. **运行时模块 `pytransform`**
- 提供保护和验证功能，确保动态库未被篡改。
- JIT 技术用于生成代码段，防止调试工具捕获核心逻辑。

#### 5. **版本更新**
- **5.3.0 版本**：新增简化 WebUI 和清晰示例文档，支持 shell 脚本快速混淆。
- **重要改进**：
- 引入新的混淆模式，提升性能。
- 修复 PyInstaller、py2exe 等工具的兼容性问题。
- 支持 macOS 和嵌入式平台（如 Raspberry Pi）。

#### 6. **支持平台**
- 支持 Python 2.6、2.7 和 3.x。
- 兼容 Windows、Mac OS X、Linux 以及 FreeBSD 和嵌入式设备。

#### 7. **文档与资源**
- 提供详细的在线文档（[https://pyarmor.readthedocs.io/en/latest/](https://pyarmor.readthedocs.io/en/latest/))，涵盖安装、使用、安全性等主题。
- 示例脚本和模板脚本（如 `benchmark.py`）帮助用户快速上手。

### 总结
PyArmor 是一个功能强大的脚本保护工具，通过代码混淆、运行时保护和许可证管理，有效防止脚本被逆向和调试。其支持多平台和多种工具集成，适合需要保护 Python 脚本的开发者和企业。