PyArmor Documentation v5.9.5

语言	格式	评分
英语	.pdf	3
摘要
PyArmor 是一个用于保护 Python 脚本的命令行工具，通过混淆代码对象、清空局部变量、验证许可证文件等方式保护脚本。它支持多种模式，包括高级模式，适用于不同的安全需求和性能要求。文档详细介绍了安装、使用、高级主题、示例以及许可证管理等内容，涵盖了从基础混淆到高级保护的多种功能。
AI总结
### PyArmor 文档总结 #### 1. 安装与验证 - 安装：PyArmor 是一个命令行工具，用于混淆和保护 Python 脚本。 - 验证：通过命令 `pyarmor -v` 可以验证安装是否成功。 - 命令：安装后会添加 `pyarmor` 命令，支持 `obfuscate`、`license` 等功能。 - 卸载：提供干净卸载方法，确保彻底移除。 #### 2. 使用 PyArmor - 混淆脚本：通过 `pyarmor obfuscate` 命令混淆 Python 脚本，保护代码对象和字面量字符串。 - 分发：混淆后的脚本可以分发到其他平台运行。 - 许可证：生成许可证文件以限制脚本的使用范围。 - 高级功能： - 扩展模式：支持按需扩展许可证类型。 - 单模块/包：支持混淆单个模块或整个包。 - 打包：将混淆后的脚本打包为可执行文件。 - 运行时保护：通过 `restrict` 模式提高安全性。 #### 3. 高级主题 - 多包处理：支持同时混淆多个包，避免冲突。 - 跨平台分发：支持将混淆后的脚本分发到不同平台。 - 其他 Python 版本：支持使用其他版本的 Python 进行混淆。 - 运行时保护：通过钩子机制保护核心动态库 `_pytransform`。 - 插件扩展：通过插件注入代码，增强功能（如检查网络时间）。 - 打包工具兼容：支持与 PyInstaller、Nuitka 等工具集成。 #### 4. 示例 - PyQt 应用：通过 `pyarmor` 和 PyInstaller 打包 PyQt 应用。 - Django 网站：使用 `mod_wsgi` 在 Apache 上运行混淆后的 Django 脚本。 #### 5. 项目管理 - 模式：支持 `cross_protection` 模式，保护项目中的所有脚本。 - 升级：推荐将旧版 capsule 升级为新版 `pytransform.key`，以获得更好的安全性。 - 性能与安全：通过 `restrict` 模式进一步提高安全性，限制脚本运行环境。 #### 6. 升级说明 - 新功能： - 引入 `pytransform.key` 替代旧版的 `pyshield.key`、`pyshield.lic` 和 `product.key`。 - 提高核心模块的保护强度，修复多项性能和兼容性问题。 - 注意事项： - 升级后需重新混淆脚本以生效新保护机制。 - 旧版许可证仍可使用，但需重新生成脚本。 #### 7. 变更日志 - 版本更新：从 5.9.5 到 4.5.0，记录了所有功能改进和错误修复。 - 重要更新： - 修复多进程启动失败问题。 - 支持 Windows、Linux 等平台的兼容性改进。 - 提高运行时错误信息的清晰度。 - 新增 `-q` 或 `--silent` 选项以静默运行命令。 #### 8. 安全与性能 - 代码保护：通过混淆字节码、清理局部变量和运行时验证许可证提高安全性。 - 高级模式：从 5.5.0 开始引入，增强保护但仅限 x86/x64 架构。 - 性能优化：通过 JIT 技术保护核心代码，减少静态文件中的二进制代码。 #### 9. 问题与支持 - 故障排除：涵盖段错误、引导问题、打包问题、许可证问题等常见问题。 - 文档支持：提供详细的使用文档和安全指南，帮助用户解决问题。 #### 10. 许可证与支持 - 购买：提供商业许可证以解锁更多功能。 - 联系：通过官网或邮件联系技术支持。 --- 总结：PyArmor 是一个功能强大的 Python 脚本保护工具，支持混淆、分发、许可证管理以及高级安全保护。文档详细介绍了其安装、使用、高级功能和问题处理，并提供了丰富的示例和升级指南，帮助用户充分利用其功能。