ZIPを開く前に、シンボリックリンクを止める|デジタル商品の合成見本

ZIPの一覧にtemplates/currentと出ていれば、当初は普通のファイルかフォルダだと考えられます。けれどZIPのメンバーには、別の場所を指すシンボリックリンクも入れられます。購入者へ渡すテンプレート一式では、リンクを必要としないなら、展開より前に止めるほうが判断しやすいです。
今回は実在の商品や購入者データを使わず、2つの合成ZIPを作りました。安全なZIPは通常ファイル2件で終了コード0、リンクを1件含むZIPは終了コード1です。AIにファイル案を増やしてもらう場面でも、最終的に配るZIPの種類まで確認するための小さな検査として扱えます。
前回は、ZIP内の../や絶対パスを展開前に検査しました。今回は名前の文字列ではなく、メンバーに記録された種類を読みます。../がなくても、リンクなら展開する側の扱いに依存するためです。
「名前がある」と「中身を持つ」は別でした
シンボリックリンクは、別のパスを指す特殊なファイルです。Linux系の形式情報では、通常ファイルとリンクは異なる種類として保存できます。ZIPを作るPythonのzipfileでも、各メンバーのexternal_attrにその情報を持たせられました。
最初は、ZIPは配布するファイルの入れ物なのだから、一覧を読めば十分だと考えられます。しかし、一覧は名前を示すだけです。templates/currentが文字列として見えても、その実体が何かまでは分かりません。購入者の環境でリンクをたどる設計まで持ち込まないため、ここではリンクを見つけた時点で失敗にします。
[素材と説明書をまとめる]
│
▼
[ZIPのメンバー一覧]
│
種類を読む
┌─────┴─────┐
▼ ▼
通常ファイル シンボリックリンク
│ │
▼ ▼
配布候補 展開せずに止める
この検査は、リンク先が安全かを判定するものではありません。リンクを許可しない配布物へ、リンクが1件でも混ざっていないかを確かめる関門です。
今回の言葉をそろえる
| 用語 | この見本での意味 |
|---|---|
| ZIPメンバー | ZIPの中に記録された1つの名前と内容です。 |
| シンボリックリンク | 自身の内容として、別のパスを指す特殊なファイルです。 |
| 属性 | ファイルの種類や権限のように、名前と内容以外へ付く情報です。 |
external_attr | PythonのZipInfoが持つ、ZIPメンバーの外部属性です。 |
stat.S_IFLNK | Pythonでシンボリックリンクの種類を表す定数です。 |
| 終了コード | コマンドの成否を数字で返す値です。この見本では0が通過、1が検出です。 |
普通のZIPとリンク入りZIPを作る
次のスクリプトを$TMPDIR/zip-symlink-lab/make_samples.pyとして保存しました。$TMPDIRは一時ディレクトリを表します。safe-product.zipには通常ファイルだけを2件、symlink-product.zipには通常ファイル1件と、../drafts/latestを指すリンク1件を入れます。判断の境目。
make_samples.pyの全文
from __future__ import annotations
import stat
import zipfile
from pathlib import Path
root = Path(__file__).parent
def add_file(archive: zipfile.ZipFile, name: str, body: str) -> None:
info = zipfile.ZipInfo(name)
info.external_attr = (stat.S_IFREG | 0o644) << 16
archive.writestr(info, body)
def add_symlink(archive: zipfile.ZipFile, name: str, target: str) -> None:
info = zipfile.ZipInfo(name)
info.create_system = 3
info.external_attr = (stat.S_IFLNK | 0o777) << 16
archive.writestr(info, target)
with zipfile.ZipFile(root / "safe-product.zip", "w") as archive:
add_file(archive, "README.md", "# delivery\n")
add_file(archive, "templates/plan.txt", "template\n")
with zipfile.ZipFile(root / "symlink-product.zip", "w") as archive:
add_file(archive, "README.md", "# delivery\n")
add_symlink(archive, "templates/current", "../drafts/latest")
print("safe-product.zip")
print("symlink-product.zip")
リンクを作る部分では、種類をstat.S_IFLNKにして、create_system = 3でUNIX系の属性として記録しました。リンク先はtemplates/currentという名前ではなく、本文の../drafts/latestです。見た目だけで配布物を確認すると、この違いを取りこぼします。
属性を読み、リンクなら終了コード1にする
検査器を$TMPDIR/zip-symlink-lab/check_zip_symlinks.pyとして保存します。external_attrを16ビット右へずらして種類の部分を取り出し、stat.S_IFLNKと一致するかを確かめます。リンクなら、名前と格納されたリンク先を表示して失敗にします。
check_zip_symlinks.pyの全文
from __future__ import annotations
import stat
import sys
import zipfile
from pathlib import PurePosixPath
def is_symlink(info: zipfile.ZipInfo) -> bool:
mode = info.external_attr >> 16
return stat.S_IFMT(mode) == stat.S_IFLNK
failed = False
for filename in sys.argv[1:]:
links: list[tuple[str, str]] = []
with zipfile.ZipFile(filename) as archive:
for info in archive.infolist():
if is_symlink(info):
target = archive.read(info).decode("utf-8", "replace")
links.append((info.filename, target))
state = "FAIL" if links else "PASS"
print(f"{PurePosixPath(filename).name}: {state} symlinks={len(links)}")
for name, target in links:
print(f" symlink: {name} -> {target}")
failed |= bool(links)
raise SystemExit(1 if failed else 0)
まず通常ファイルだけのZIPを通しました。実行時のPythonは3.13.5です。
cd "$TMPDIR/zip-symlink-lab"
python3 --version
python3 make_samples.py
python3 check_zip_symlinks.py safe-product.zip
printf 'safe_exit=%s\n' "$?"
Python 3.13.5
safe-product.zip
symlink-product.zip
safe-product.zip: PASS symlinks=0
safe_exit=0
次に、リンクを含む方を同じ検査器へ渡します。失敗しても終了コードを表示するため、このブロックだけset +eで止まらないようにしました。
set +e
python3 check_zip_symlinks.py symlink-product.zip
rc=$?
set -e
printf 'symlink_exit=%s\n' "$rc"
symlink-product.zip: FAIL symlinks=1
symlink: templates/current -> ../drafts/latest
symlink_exit=1
リンク1件を検出し、終了コードは1でした。ZIPを展開していないので、リンク先を作業場所でたどる必要はありません。販売候補のZIPを作った直後にこの検査を置けば、通常ファイルだけにするか、リンクを含める理由と対象環境を明示するかを、配布前に決められます。
最後に、検査が読んだ属性をそのまま出しました。120777だけがリンクとして判定されています。
python3 - <<'PY'
import stat, zipfile
for filename in ('safe-product.zip', 'symlink-product.zip'):
with zipfile.ZipFile(filename) as archive:
for info in archive.infolist():
mode = info.external_attr >> 16
print(f'{filename} {info.filename} mode={mode:o} is_symlink={stat.S_IFMT(mode) == stat.S_IFLNK}')
PY
safe-product.zip README.md mode=100644 is_symlink=False
safe-product.zip templates/plan.txt mode=100644 is_symlink=False
symlink-product.zip README.md mode=100644 is_symlink=False
symlink-product.zip templates/current mode=120777 is_symlink=True
止める場所を、展開より前にする
この見本ではリンクの内容が../drafts/latestでした。ただし、リンク先が商品フォルダ内に見える場合でも、今回は通しません。配布物にリンクを含めるなら、購入者が使うOS、解凍ツール、リンク先を一緒に設計してから個別に許可するべきだからです。
AIでテンプレート、画像、説明書をまとめると、ファイル数はすぐ増えます。だからといって、ファイル名だけを確認して終えると、種類の違いは残ります。この見本では、「ZIPに入っている」ことだけを納品条件にしません。リンクが不要な商品では、「通常ファイルだけ」をもう1つの条件にします。
この検査にも限界があります。ZIP属性を持たない形式や、Windowsのショートカットファイル、リンク先が実在するかは確認しません。今回の目的は、展開時の挙動を再現することではなく、リンクを不要な配布物から確実に除くことです。
出典
- Python公式文書: zipfile(
ZipFile、ZipInfo、アーカイブメンバーの読取りと書込み) - Python公式文書: stat(ファイル種別の定数とモードの判定)
- PKWARE APPNOTE.TXT(ZIP形式の仕様と外部ファイル属性)


