项目快速概览
【免费下载链接】guarddog:snake: :mag: GuardDog is a CLI tool to Identify malicious PyPI and npm packages项目地址: https://gitcode.com/gh_mirrors/gu/guarddog
GuardDog是一款专业的命令行安全工具，专门用于识别Python包（PyPI）、Node.js包（npm）和Go模块中的潜在恶意代码。它能快速扫描软件依赖，检测多种攻击模式，帮助开发者避免供应链攻击风险。
极速上手指南
环境准备与安装
首先克隆项目仓库并安装依赖：
git clone https://gitcode.com/gh_mirrors/gu/guarddog cd guarddog pip install -e .基础扫描操作
安装完成后，你可以立即开始使用GuardDog进行安全扫描：
# 扫描单个Python包 guarddog scan requests # 扫描npm包 guarddog scan lodash --ecosystem npm # 扫描Go模块 guarddog scan github.com/gin-gonic/gin --ecosystem go核心功能详解
多生态系统支持
GuardDog支持三大主流包管理生态系统：
- PyPI包扫描：检测Python包中的恶意代码
- npm包扫描：识别Node.js依赖中的安全威胁
- Go模块扫描：扫描Go项目依赖的安全性
恶意模式识别
工具内置多种检测规则，能够识别以下恶意行为：
- Base64编码隐藏代码- 检测通过Base64编码的恶意执行逻辑
- 拼写错误攻击- 识别与知名包名称相似的恶意包
- 元数据缺失- 发现描述信息为空的可疑包
- 捆绑二进制文件- 检测包中是否包含可疑的可执行文件
扫描结果解读
GuardDog的扫描结果采用直观的颜色编码：
- 绿色输出：未发现恶意指标，包相对安全
- 红色警告：发现潜在恶意行为，需要进一步审查
实战应用案例
正常包扫描示例
guarddog scan requests输出结果：
Found 0 potentially malicious indicators scanning requests恶意包检测示例
guarddog scan xolokvhcqvifyf输出结果：
Found 2 potentially malicious indicators in xolokvhcqvifyf - exec-base64: 检测到Base64编码的恶意代码执行 - empty_information: 该包在PyPI上描述为空拼写错误攻击检测
guarddog scan beautifulsup4输出结果：
Found 2 potentially malicious indicators in beautifulsup4 - typosquatting: 包名与beautifulsoup4高度相似 - empty_information: 该包在PyPI上描述为空高级配置技巧
自定义扫描规则
你可以在项目中创建自定义检测规则，增强扫描能力：
- 在
guarddog/analyzer/sourcecode/目录下添加YAML规则文件 - 规则支持正则表达式匹配和语义分析
- 可以针对特定项目需求定制检测逻辑
批量扫描与自动化
对于大型项目，建议设置自动化扫描流程：
# 扫描requirements.txt中的所有包 cat requirements.txt | xargs -n 1 guarddog scan # 结合CI/CD工具实现持续安全监控输出格式定制
GuardDog支持多种输出格式：
- 默认格式：人类可读的彩色输出
- JSON格式：便于程序化处理和分析
- 标准报告格式：与安全工具集成
最佳实践建议
开发阶段集成
将GuardDog集成到开发工作流中：
- 预提交检查：在代码提交前扫描新增依赖
- CI/CD集成：在构建流程中自动执行安全扫描
- 定期审计：周期性扫描项目所有依赖
应急响应措施
当检测到恶意包时，建议采取以下措施：
- 立即移除：从项目中删除可疑依赖
- 版本回退：回滚到已知安全的版本
- 安全评估：对受影响代码进行全面安全检查
GuardDog作为开源安全工具，为开发者提供了简单有效的依赖安全检查方案。通过合理的配置和集成，它能够显著提升项目的供应链安全水平。
【免费下载链接】guarddog:snake: :mag: GuardDog is a CLI tool to Identify malicious PyPI and npm packages项目地址: https://gitcode.com/gh_mirrors/gu/guarddog
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
