# PyZipSecurity-Basics

**Repository Path**: joy_2_0/py-zip-security-basics

## Basic Information

- **Project Name**: PyZipSecurity-Basics
- **Description**: PyZipSecurity-Basics 是一个围绕压缩文件安全处理机制而构建的示例工程，主要关注 ZIP 文件在实际系统中可能引发的资源消耗风险，并提供相应的安全防护实现。项目通过构造不同类型的大体量压缩包用于测试，并配套实现了解压过程中的文件数量与解压后体积校验逻辑，可为服务端文件上传解析模块、后端中间件、安全检测链路提供参考。
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-11-25
- **Last Updated**: 2025-11-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 安全机制, 网络攻防, 压缩炸弹

## README

# PyZipSecurity-Basics

PyZipSecurity-Basics 是一个围绕 ZIP 压缩文件安全处理机制构建的示例项目，旨在演示服务端在处理压缩包时可能面对的资源消耗风险，并提供一套清晰可复用的解压防护逻辑。项目包含两类典型大体量压缩包的构造脚本，以及用于安全解压的校验模块，可用于测试系统对异常压缩文件的处理能力，适配文件上传、后端解析和安全检测等场景。

---

## Modules / 模块说明

### `safe_unzip.py`
带文件数量与解压后体积双重限制的安全解压模块，通过在解压前检查 ZIP 包内部结构，有效避免资源耗尽类风险，可直接作为上传解析链路中的安全组件示例。

### `make_zip_boom_flat.py`
生成由大量文件构成的压缩包示例，适合用于测试解压过程中的 I/O 与磁盘压力。

### `make_zip_boom_nested.py`
构造深度目录嵌套型压缩包，用于模拟路径展开与递归解压过程中可能出现的极端情况。

---

## Usage / 使用方式

```bash
python make_zip_boom_flat.py
python make_zip_boom_nested.py
python safe_unzip.py