git：https://gitcode.com/gh_mirrors/py/pyarmor
https://github.com/dashingsoft/pyarmor

中文文檔：https://pyarmor.readthedocs.io/zh/latest/
英文文檔：https://pyarmor.readthedocs.io/en/latest/

PyArmor 是一個用來加密和保護 Python 腳本的命令行工具。下面是一份快速上手指南，涵蓋了安裝、基本加密、高級授權(quán)和打包等核心操作。

1. 安裝 PyArmor

安裝過程很簡單，直接用 pip 就可以。

pip install pyarmor
# 如果需要升級
pip install --upgrade pyarmor

安裝完成后，可以用 pyarmor --version 驗證是否成功。

2. 快速入門：加密單個腳本

最基礎的使用場景是加密一個單獨的 .py 文件。假設你的腳本叫 foo.py。

# 在 v8+ 版本中，推薦使用 'gen' 命令
pyarmor gen foo.py

或者使用舊版本的 obfuscate 命令。

pyarmor obfuscate foo.py

• 運行結(jié)果：執(zhí)行后，所有加密文件和運行依賴會被放在 dist 文件夾里。
• 關鍵依賴：加密腳本本身無法獨立運行，必須和 dist 目錄下的運行輔助包（如 pyarmor_runtime_000000）放在一起。把整個 dist 目錄發(fā)布出去，客戶就能直接運行了。

3. 給代碼加上“有效期”

通過設置到期時間，可以控制程序的使用期限，這在分發(fā)試用版時很有用。

• 設置天數(shù)（30天后過期）：

  pyarmor gen -e 30 foo.py
  

• 設置具體日期：

  pyarmor gen -e 2026-12-31 foo.py
  

默認情況下，檢查的是系統(tǒng)本地時間。如果希望從網(wǎng)絡時間服務器獲取時間，可以先進行配置，這樣用戶修改電腦本地時間也無法繞過授權(quán)。

pyarmor cfg nts=pool.ntp.org
pyarmor gen -e 30 foo.py

4. 將腳本“綁定”到指定機器

通過綁定硬件信息（如MAC地址、硬盤序列號），可以讓代碼只能在指定的機器上運行，防止隨意拷貝。

• 獲取客戶機器的硬件信息（在客戶機器上運行）：

# v8.4.6 以后的版本
python -m pyarmor.cli.hdinfo
# 舊版本
pyarmor hdinfo

• 加密時進行綁定：

# 綁定MAC地址
pyarmor gen -b "00:16:3e:35:19:3d" foo.py

# 綁定硬盤序列號
pyarmor gen -b "HXS2000CN2A" foo.py

綁定多個MAC地址
pyarmor gen --bind 66:77:88:9a:cc:fa,f8:ff:c2:27:00:7f your_script.py

也可以同時綁定多個設備，只需多次使用 -b 選項。

• 增強型加密選項

完整示例：

pyarmor gen --enable-jit --mix-str --assert-call foo.py

5. 打包成獨立可執(zhí)行文件

# 打包為單文件
pyarmor gen --pack onefile -O dist_onefile main.py

# 打包為目錄
pyarmor gen --pack onedir -O dist_onedir main.py

注意：非.py文件需手動復制到輸出目錄

• 發(fā)布注意事項

加密后的腳本依賴運行時環(huán)境，發(fā)布結(jié)構(gòu)示例：

dist/
├── foo.py
└── pyarmor_runtime_000000/
    ├── __init__.py
    └── pyarmor_runtime.so

6. 常用命令與選項速查

• -O, --output：指定加密文件的輸出目錄，默認為 dist。
• -r, --recursive：遞歸加密指定目錄下的所有 .py 文件，用于加密整個項目或包。
• --exclude：在遞歸加密時，排除某些目錄或文件。
• -d, --debug：開啟調(diào)試模式，如果加密過程遇到問題，這個選項會打印更詳細的錯誤信息，有助于排查問題。
• -h, --help：查看任何命令的詳細用法，例如 pyarmor gen -h。

注意：PyArmor 的命令和選項在不同版本間可能會有細微差異。如果在使用中遇到問題，可以隨時通過 pyarmor <command> -h 查看當前版本的幫助信息。

• 多文件/包加密‌：遞歸加密整個項目目錄。

# 加密整個包，保留目錄結(jié)構(gòu)
pyarmor gen -r -O dist_output src/mypackage

• 跨平臺兼容‌：生成支持多平臺的運行時（增加體積）。

pyarmor gen --platform windows.x86_64,linux.x86_64 your_script.py

到此這篇關于python腳本加密工具PyArmor的實現(xiàn)的文章就介紹到這了,更多相關python PyArmor內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家！

最新評論