paozip for Python

Python ソースコードを暗号化して、大切なコードを守るツール

ユーザーズマニュアル

バージョン 2.0.0

2026年2月

有限会社 パオ・アット・オフィス

https://www.pao.ac/

目次

1. はじめに
2. 1.1 paozip for Python とは
3. 1.2 特長
4. 1.3 仕組み（ラッパー方式）

5. 1.4 PHP版との違い

6. 動作環境

7. 2.1 対応 OS
8. 2.2 対応 Python バージョン

9. 2.3 対応フレームワーク

10. セットアップ

11. 3.1 Docker で試す（おすすめ）
12. 3.2 Linux / macOS にインストール

13. 3.3 インストールの確認

14. クイックスタート

15. 4.1 暗号化してみよう
16. 4.2 ラッパーを作ってみよう
17. 4.3 実行してみよう

18. 4.4 paozip run で直接実行

19. CLI コマンドリファレンス

20. 5.1 encrypt（暗号化）
21. 5.2 decrypt（復号）
22. 5.3 run（実行）
23. 5.4 check（確認）
24. 5.5 version（バージョン）

25. 5.6 コマンド一覧

26. Python API リファレンス

27. 6.1 encrypt()
28. 6.2 decrypt()
29. 6.3 encrypt_file()
30. 6.4 decrypt_file()
31. 6.5 decrypt_file_to()
32. 6.6 is_encrypted() / is_encrypted_file()

33. 6.7 install_importer()

34. ラッパーの書き方

35. 7.1 基本パターン
36. 7.2 Web アプリ（Flask / Django）
37. 7.3 CLI アプリ

38. 7.4 やってはいけないこと

39. 暗号化キーについて

40. 8.1 キーの仕組み
41. 8.2 複数環境で使う場合

42. 8.3 注意事項

43. 各種環境での利用

44. 9.1 Flask
45. 9.2 Django

46. 9.3 Docker

47. トラブルシューティング

48. ライセンス・お問い合わせ

1. はじめに

1.1 paozip for Python とは

paozip for Python は、Python のソースコードを暗号化するツールです。

暗号化すると .py ファイルが .pye ファイルになり、ソースコードは完全に読めなくなります。でも——ラッパー経由で普通に import して実行できます。

こんな時に便利： - 自社開発の Python アプリを納品したい（でもソースは見せたくない） - AI/ML のモデル処理コードを配布したい（でもアルゴリズムは秘密にしたい） - Django / Flask で作った業務システムを設置したい（でもロジックは隠したい）

1.2 特長

1.3 仕組み（ラッパー方式）

paozip for Python は ラッパー方式 で動作します。

┌───────────────────────────────────────────────────────────┐
│                   あなたの配布物                             │
├───────────────────────────────────────────────────────────┤
│                                                           │
│   app.py（ラッパー）              logic.pye（暗号化済み）   │
│   ┌──────────────────┐           ┌──────────────────┐    │
│   │ import paozip    │           │ 09 50 41 4F 5A...│    │
│   │ paozip.install_  │  import   │ （バイナリデータ） │    │
│   │   importer()     │ ───────▶  │ 中身は読めない！  │    │
│   │ import logic     │           └──────────────────┘    │
│   └──────────────────┘                                    │
│         │                                                 │
│         ▼                                                 │
│   python app.py で実行                                     │
│                                                           │
└───────────────────────────────────────────────────────────┘

ポイント： - app.py（ラッパー）は公開してOK。中身はたった3行 - logic.pye（暗号化）に秘密のロジックを隠す - ユーザーは python app.py で普通に実行できる - ディスクには復号ファイルは書き出されない（メモリ上で復号）

1.4 PHP版との違い

【PHP版 — 透過型】                 【Python版 — ラッパー型】

sample.php（暗号化済み）           app.py（ラッパー）→ logic.pye（暗号化）

php sample.php                     python app.py
     │                                  │
     ▼                                  ▼
  自動で復号＆実行                     ラッパーが復号＆import

ファイル: 1つだけ                    ファイル: 2つ必要
コード変更: 不要                    コード変更: ラッパーを書く（3行だけ！）
拡張子: .php のまま                 拡張子: .pye に変更

Python は言語の仕組み上、PHP のような完全透過型は実現できません。 でもラッパーはたった3行！ 十分シンプルです。

2. 動作環境

2.1 対応 OS

2.2 対応 Python バージョン

2.3 対応フレームワーク

3. セットアップ

3.1 Docker で試す（おすすめ）

Step 1: Docker 環境を起動

cd paozip-python-test
docker-compose up -d --build

初回はビルドに時間がかかります。コーヒーでも飲んで待ちましょう。

Step 2: コンテナに入る

docker-compose exec paozip-python-test bash

Step 3: セットアップ

cd /app/paozip-python
pip install .

Step 4: 確認

paozip version

バージョン情報が表示されれば成功！

3.2 Linux / macOS にインストール

必要なもの: - Python 3.8 以上（開発ヘッダー含む） - C コンパイラ（gcc） - zlib

# Ubuntu/Debian
sudo apt install python3-dev gcc zlib1g-dev

# CentOS/RHEL
sudo dnf install python3-devel gcc zlib-devel

cd paozip-python
pip install .

3.3 インストールの確認

paozip version
python -c "import paozip; print(paozip.__version__)"

4. クイックスタート

4.1 暗号化してみよう

テスト用のファイルがあるとします：

# logic.py — 秘密のロジック
def secret_calculate(x, y):
    return (x * 137 + y * 42) ^ 0xDEAD

def get_message():
    return "Hello from encrypted Python!"

暗号化コマンド：

paozip encrypt logic.py

✔ logic.py → logic.pye

logic.py が logic.pye に暗号化されました。

cat logic.pye
# → バイナリデータ（読めない！）

4.2 ラッパーを作ってみよう

暗号化したモジュールを使うには、ラッパーを書きます。たった3行です：

# app.py — ラッパー（公開してOK）
import paozip
paozip.install_importer()    # import フックをインストール

import logic                 # logic.pye を自動的に復号して読み込み！

print(logic.get_message())
print(logic.secret_calculate(100, 200))

4.3 実行してみよう

python app.py

Hello from encrypted Python!
35065

暗号化されたコードが、ラッパー経由で普通に動きました！

logic.py は暗号化されて logic.pye になっています。 でも import logic と書くだけで、自動的に .pye ファイルから復号して読み込みます。

4.4 paozip run で直接実行

ラッパーを書かずに、暗号化ファイルを直接実行することもできます：

paozip run logic.pye

引数も渡せます：

paozip run my_script.pye --input data.csv --output result.json

paozip run は、暗号化ファイルを復号してメモリ上で実行します。 if __name__ == "__main__" のブロックも正しく動作します。

5. CLI コマンドリファレンス

5.1 encrypt（暗号化）

paozip encrypt <file.py> [-o <output>] [-b] [-f]

paozip encrypt logic.py               # → logic.pye
paozip encrypt logic.py -b            # → logic.pye + logic.pao（バックアップ）
paozip encrypt logic.py -o secret.pye # → secret.pye

5.2 decrypt（復号）

paozip decrypt <file.pye> [-o <output>] [-f]

paozip decrypt logic.pye              # → logic.py
paozip decrypt logic.pye -o restored.py

5.3 run（実行）

paozip run <file.pye> [args...]

paozip run my_script.pye
paozip run my_script.pye arg1 arg2
paozip run server.pye --port 8080

5.4 check（確認）

paozip check <file>

暗号化されていれば終了コード 0、されていなければ 1。

paozip check logic.pye && echo "暗号化済み"
paozip check logic.py  || echo "暗号化されていない"

5.5 version（バージョン）

paozip version

5.6 コマンド一覧

6. Python API リファレンス

import paozip

6.1 encrypt()

paozip.encrypt(data: bytes|str, key: str = None) -> bytes

データを暗号化します。文字列を渡すと自動的に UTF-8 エンコードされます。

encrypted = paozip.encrypt("秘密のデータ")
encrypted = paozip.encrypt(b"\x00\x01\x02")

6.2 decrypt()

paozip.decrypt(data: bytes, key: str = None) -> bytes

暗号化されたデータを復号します。戻り値は bytes です。

decrypted = paozip.decrypt(encrypted)
text = decrypted.decode('utf-8')  # 文字列が欲しい場合

6.3 encrypt_file()

paozip.encrypt_file(input_path: str, output_path: str = None, key: str = None) -> str

ファイルを暗号化します。出力パスを省略すると .pye 拡張子になります。

paozip.encrypt_file("logic.py")             # → logic.pye
paozip.encrypt_file("logic.py", "out.pye")  # → out.pye

6.4 decrypt_file()

paozip.decrypt_file(input_path: str, key: str = None) -> bytes

暗号化ファイルを復号して bytes を返します（ファイルには書き出しません）。

data = paozip.decrypt_file("logic.pye")
source = data.decode('utf-8')

6.5 decrypt_file_to()

paozip.decrypt_file_to(input_path: str, output_path: str = None, key: str = None) -> str

暗号化ファイルを復号してファイルに書き出します。

paozip.decrypt_file_to("logic.pye")               # → logic.py
paozip.decrypt_file_to("logic.pye", "restored.py") # → restored.py

6.6 is_encrypted() / is_encrypted_file()

paozip.is_encrypted(data: bytes) -> bool
paozip.is_encrypted_file(path: str) -> bool

データやファイルが暗号化されているか判定します。

if paozip.is_encrypted_file("logic.pye"):
    print("暗号化済みです")

6.7 install_importer()

paozip.install_importer() -> None

Python の import フックをインストールします。 これを呼んだ後、import 文で .pye ファイルを自動的に読み込めるようになります。

import paozip
paozip.install_importer()

import my_module  # my_module.pye があれば自動的に復号して読み込み

重要： 必ずモジュールのトップレベルで呼んでください。 if __name__ == "__main__" の中で呼ぶと、それ以前の import には効きません。

7. ラッパーの書き方

7.1 基本パターン

# app.py（ラッパー — 公開してOK）
import paozip
paozip.install_importer()

# ここから下は暗号化モジュールを自由に import できる
import logic           # → logic.pye を読み込み
import utils           # → utils.pye を読み込み
from models import User  # → models/__init__.pye を読み込み

# アプリのメイン処理
logic.main()

7.2 Web アプリ（Flask / Django）

Flask:

# app.py
import paozip
paozip.install_importer()

from flask import Flask
import secret_routes  # secret_routes.pye

app = Flask(__name__)
secret_routes.register(app)

if __name__ == '__main__':
    app.run()

Django:

# manage.py の先頭に追加
import paozip
paozip.install_importer()

# 以降は通常の Django コード
import os
import sys

def main():
    os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'myproject.settings')
    # ...

7.3 CLI アプリ

# run.py（ラッパー）
import paozip
paozip.install_importer()
import my_cli  # my_cli.pye

if __name__ == '__main__':
    my_cli.main()

7.4 やってはいけないこと

NG: if __name__ の中で install_importer() を呼ぶ

# NG! これだとダメ！
import paozip

import logic  # ← この時点ではまだフックが入っていない → エラー！

if __name__ == '__main__':
    paozip.install_importer()  # ← 遅すぎる！
    logic.main()

OK: トップレベルで呼ぶ

# OK! これが正解！
import paozip
paozip.install_importer()  # ← import の前に必ず呼ぶ

import logic  # ← フックが有効なので .pye を読み込める

install_importer() は import 文よりも前に 呼んでください。 これさえ守れば、あとは普通の Python と同じです。

8. 暗号化キーについて

8.1 キーの仕組み

暗号化キーは paozip のビルド（pip install）時に自動生成されます。

キーの優先順位：

キーは 64 文字の16進数文字列（256 ビット相当）です。

8.2 複数環境で使う場合

開発環境と本番環境で同じ暗号化ファイルを使うには、同じキーでビルドする必要があります。

方法 1: .paozip_key ファイルをコピー

# 開発環境でビルド後、キーファイルをコピー
scp paozip-python/.paozip_key user@production:/tmp/paozip-python/

# 本番環境で同じキーでビルド
cd /tmp/paozip-python
pip install .

方法 2: 環境変数で指定

export PAOZIP_KEY="あなたのキー（64文字の16進数）"
pip install .

8.3 注意事項

• .paozip_key ファイルを紛失すると暗号化ファイルを復号できなくなります
• .paozip_key は 安全な場所に保管してください
• 本番環境に .paozip_key を配布する必要はありません（ビルド済みの paozip がキーを内包）
• .pye ファイルを Web サーバーの公開ディレクトリに置かないでください

9. 各種環境での利用

9.1 Flask

# app.py
import paozip
paozip.install_importer()

from flask import Flask
import secret_logic  # → secret_logic.pye

app = Flask(__name__)

@app.route('/')
def index():
    return secret_logic.process()

paozip encrypt secret_logic.py
rm secret_logic.py     # 元ファイルを削除（.pye だけ残す）
python app.py

9.2 Django

# manage.py の先頭に追加
import paozip
paozip.install_importer()

# 暗号化したいファイルを暗号化
paozip encrypt myapp/views.py
paozip encrypt myapp/models.py
rm myapp/views.py myapp/models.py

# Django は通常通り起動
python manage.py runserver

.py と .pye の両方が存在する場合、.py が優先されます。 暗号化後は必ず元の .py ファイルを削除してください。

9.3 Docker

FROM python:3.12-slim

# ビルドツールをインストール
RUN apt-get update && apt-get install -y gcc zlib1g-dev

# paozip をインストール
COPY paozip-python/ /tmp/paozip-python/
RUN cd /tmp/paozip-python && pip install .

# アプリをコピー
COPY app/ /app/

# 暗号化（ビルド時）
RUN paozip encrypt /app/secret_logic.py \
 && rm /app/secret_logic.py

CMD ["python", "/app/app.py"]

10. トラブルシューティング

11. 使用許諾

paozip for Python の使用について、paozip for Python の使用者（以下「利用者様」と称します）と有限会社パオ・アット・オフィス（以下「弊社」と称します）は、以下の各項目についての内容に同意するものとします。

1. 使用許諾書

この使用許諾書は、利用者様が paozip for Python を使用する場合に同意しなければならない契約書です。

2. 使用許諾書の同意

利用者様が paozip for Python を使用する時点で、本使用許諾書に同意されたものとします。同意されない場合は、paozip for Python を使用する事はできません。

3. ライセンス（使用権）の購入

利用者様が paozip for Python の製品版を使用して開発を行う場合には、1台の開発用コンピュータで paozip for Python を使用するにあたり、1ライセンスを購入する必要があります。

お客様環境等、開発コンピュータでないマシンで paozip for Python を使用する場合ライセンスは必要ありません。ランタイムライセンスフリーでございます。

4. 著作権

paozip for Python の著作権は、いかなる場合においても弊社に帰属いたします。

5. 免責

paozip for Python の使用によって、直接的、あるいは、間接的に生じた、いかなる損害に対しても、弊社は補償賠償の責任を負わないものとします。

6. 禁止事項

paozip for Python 及びその複製物を第三者に譲渡・貸与する事は出来ません。paozip for Python を開発ツールとして再販/再配布することを禁止します。なお、暗号化されたファイルを配布することは問題ございません。

7. 保証の範囲

弊社は paozip for Python の仕様を予告無しに変更することがあります。その場合の利用者様に対する情報提供は、弊社 WEB サイトにて行う事とします。

8. 適用期間

本使用許諾条件は利用者様が paozip for Python を使用した日より有効です。

12. 代金支払い方法

paozip for Python の製品版をご利用頂ける場合は、ライセンスを購入して頂く必要があります。

体験版について: すべての機能を制限なくお試しいただけます（機能制限なし）。

必要なライセンス数の数え方

paozip for Python で開発を行うパソコンの台数

1ライセンス当たりの価格

11,000円（税込）

バグフィックス等のバージョンアップは原則として無償とさせて頂きます。

お支払方法

11,000円 × ライセンス数 を下記口座へ銀行振込、または、郵便振替による送金をして下さい。

※ 振込手数料は利用者様負担でお願い致します。

お支払いの通知と製品の送付

1. 振り込みが完了した時点で、必ず弊社 WEB サイトの入金連絡フォームから入金のご連絡をお願いいたします。
2. 弊社では上記連絡を受けて入金確認を行い、paozip for Python の製品版を利用者様へ電子メールにてお送りさせて頂きます。

見積書/納品書/請求書/領収証の発行

見積書/納品書/請求書/領収証の発行は可能でございます。製品サイトでの手続きにより発行いたします。

お問い合わせ

製品に関するお問い合わせは、下記までお願いいたします。

有限会社 パオ・アット・オフィス

• 製品サイト: https://www.pao.ac/paozip/
• 購入ページ: https://www.pao.ac/paozip/buy.html
• メール: info@pao.ac

paozip for Python — あなたの Python コードを、シンプルに、確実に、守ります。

© 2001-2026 有限会社 パオ・アット・オフィス / https://www.pao.ac/