PyArmor介绍

PyArmor是一个专门用于保护 Python 源代码的工具。它通过代码混淆、加密和授权机制，使别人即使拿到程序文件，也很难查看或修改你的源码。

下面给你做一个系统介绍。

Pyarmor 9.2 用户文档

一、PyArmor 是什么

PyArmor是一个 Python 代码保护工具，主要功能是：

• 加密 Python 源代码
• 混淆代码结构
• 限制程序运行环境
• 生成授权 License

使用 PyArmor 后：

• 用户可以运行程序
• 但无法看到源码

常见使用场景：

• 商业 Python 软件分发
• AI/算法代码保护
• SDK 发布
• Python 工具软件

二、PyArmor 的工作原理

PyArmor 的核心思路是：

1. 对 Python 源代码进行加密
2. 生成一个运行时加载器
3. 程序运行时再解密执行

流程大致如下：

原始代码 ↓ PyArmor 加密 ↓ 生成保护代码 ↓ 用户运行程序 ↓ 运行时动态解密执行

例如：

原始代码

print("Hello World")

使用 PyArmor 保护后：

frompyarmor_runtimeimport__pyarmor__ __pyarmor__(...)

源码已经变成加密格式。

三、PyArmor 的主要功能

1 代码混淆（Obfuscation）

把源码转换成难以理解的形式，例如：

defadd(a,b):returna+b

可能变成：

deff1(a,b):returna+b

甚至被编译成加密字节码。

2 代码加密

PyArmor 会：

• 加密.py
• 生成.pyc或加密模块

别人无法反编译。

3 运行环境绑定

可以限制程序只能在：

• 指定机器
• 指定 IP
• 指定 MAC 地址
• 指定时间

运行。

例如：

只能在某台服务器运行

4 License 授权

可以生成授权文件：

license.lic

实现：

• 试用版
• 限时运行
• 指定机器运行

5 防止反编译

PyArmor 对代码做了：

• bytecode 加密
• runtime 保护

即使使用：

uncompyle6

也很难还原源码。

四、安装 PyArmor

安装非常简单：

pipinstallpyarmor

查看版本：

pyarmor--version

五、基本使用方法

假设你的项目：

project ├── main.py ├── utils.py └── config.yaml

1 加密代码

pyarmor gen main.py

生成目录：

dist/ ├── main.py └── pyarmor_runtime/

运行：

python dist/main.py

2 加密整个项目

pyarmor gen-r.

参数说明：

-r 递归加密目录

3 指定输出目录

pyarmor gen-Odist-r.

生成：

dist/

六、PyArmor + PyInstaller（常见组合）

实际项目中通常这样做：

Python代码 ↓ PyArmor 加密 ↓ PyInstaller 打包 ↓ EXE / 二进制程序

示例：

pyarmor gen main.py pyinstaller dist/main.py--onefile

最终得到：

MyApp.exe

用户：

• 能运行
• 看不到源码

七、PyArmor 优缺点

优点

1️⃣ 保护 Python 源码
2️⃣ 防止反编译
3️⃣ 支持 License
4️⃣ 支持项目级保护
5️⃣ 跨平台

支持：

• Linux
• Windows
• Mac

缺点

1️⃣不是 100% 安全

高级逆向仍可能破解。

2️⃣免费版有限制

部分高级功能需要付费。

3️⃣运行时稍微变慢

因为需要解密代码。

八、PyArmor 与其他方案对比

所以很多商业 Python 软件都用：

PyArmor + PyInstaller

九、适合的项目类型

非常适合：

• AI算法
• 机器人控制软件
• 商业Python软件
• SDK

不太适合：

• 开源项目
• 需要用户修改代码的项目

十、一个真实的发布流程（推荐）

企业常用流程：

开发代码 ↓ PyArmor加密 ↓ PyInstaller打包 ↓ 生成二进制程序 ↓ 客户运行

最终用户拿到：

MyApp

但：

看不到源码

✅总结一句话：

PyArmor 是 Python 最常用的源码保护工具之一，用于加密和混淆 Python 代码，防止源码泄露。