pyupio/safety

pyupio/safety镜像描述

镜像概述

pyupio/safety是基于Safety工具的Docker镜像，专注于检测Python项目依赖的已知安全漏洞。它可扫描已安装依赖或需求文件，识别风险并提供修复建议，帮助开发者保障项目安全。

核心功能

• 扫描当前Python环境中已安装依赖的安全漏洞
• 读取本地需求文件（如requirements.txt）进行批量检查
• 从标准输入接收依赖列表（如pip freeze输出）
• 支持JSON、简洁列表等多种输出格式
• 可使用本地漏洞数据库或PyUp API（需密钥）获取实时数据
• 允许忽略指定ID的漏洞，适配项目特殊需求

使用场景

1. 本地项目审计：快速检查虚拟环境或需求文件中的漏洞
2. CI/CD集成：在持续集成流程中加入依赖安全检查，防止漏洞代码合并
3. Docker镜像扫描：对Python镜像内部的依赖进行安全检测
4. 批量依赖检查：通过stdin输入批量依赖列表，高效完成审计

配置说明

关键选项

• --key：PyUp API密钥（获取实时漏洞数据）
• --db：本地漏洞数据库路径
• --stdin：从标准输入读取依赖
• --file/-r：指定需求文件路径
• --json：输出JSON格式报告
• --ignore/-i：忽略指定ID的漏洞

Docker部署示例

1. 检查stdin输入的依赖

bash
echo "insecure-package==0.1" | docker run -i --rm pyupio/safety safety check --stdin

2. 检查本地需求文件

挂载本地requirements.txt到容器：

bash
docker run -i --rm -v $(pwd)/requirements.txt:/app/req.txt pyupio/safety safety check -r /app/req.txt

3. 扫描其他Docker镜像内的依赖

bash
docker run -it --rm your-python-image "/bin/bash -c 'pip install safety && safety check'"

4. 输出JSON格式报告

bash
pip freeze | docker run -i --rm pyupio/safety safety check --stdin --json