JuttSahib1999/FileHashAnalyzer

GitHub: JuttSahib1999/FileHashAnalyzer

一款基于 Python 和 PyQt6 构建的跨平台桌面工具,支持多算法文件哈希生成与 VirusTotal 实时威胁情报查询,帮助用户验证文件完整性并检测恶意文件。

Stars: 0 | Forks: 0

# 🔐 File Hash Analyzer Pro **集成 VirusTotal 的高级文件哈希分析工具 | 2026 版** [![Python 版本](https://img.shields.io/badge/python-3.8%2B-blue)](https://www.python.org/downloads/) [![许可证](https://img.shields.io/badge/license-MIT-green)](LICENSE) [![平台](https://img.shields.io/badge/platform-Windows%20%7C%20Linux%20%7C%20macOS-lightgrey)](https://github.com/JuttSahib1999/FileHashAnalyzer) [![欢迎 PR](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](http://makeapullrequest.com) [![维护状态](https://img.shields.io/badge/Maintained%3F-yes-green.svg)](https://github.com/JuttSahib1999/FileHashAnalyzer/graphs/commit-activity) ## 📋 目录 - [概述](#-overview) - [功能](#-features) - [安装说明](#-installation) - [用法](#-usage) - [截图](#-screenshots) - [API 集成](#-api-integration) - [安全性](#-security) - [贡献](#-contributing) - [许可证](#-license) ## 🚀 概述 **File Hash Analyzer Pro** 是一款专业、用户友好的 GUI 工具,用于分析文件完整性和安全性。它会计算多种加密哈希值(MD5、SHA1、SHA256、SHA512),并与 VirusTotal 数据库进行比对,以确定文件是恶意的还是安全的。 ### 为什么选择这款工具? - 🔒 **安全第一**:在执行前验证文件完整性 - 🚀 **闪电速度**:针对大文件进行了优化 - 🎯 **精准无误**:使用多种哈希算法进行验证 - 🌐 **云端赋能**:集成 VirusTotal 获取实时威胁情报 - 💻 **跨平台**:支持 Windows、Linux 和 macOS ## ✨ 功能 ### 核心能力 - ✅ **多哈希生成**:MD5、SHA1、SHA256、SHA512 - ✅ **VirusTotal 集成**:实时威胁检测 - ✅ **现代化 GUI**:简洁的深色主题界面 - ✅ **大文件支持**:轻松处理大于 10GB 的文件 - ✅ **进度追踪**:实时进度指示器 - ✅ **导出报告**:生成 JSON 格式的审计日志 - ✅ **API Key 管理**:安全的本地存储 - ✅ **跨平台**:支持 Windows、Linux、macOS ### 高级功能 - 🔄 **多线程分析**:UI 无卡顿 - 📊 **详细统计信息**:提供检测比例和引擎细分 - 🎨 **现代化 UI**:专业的深色主题 - 🔐 **安全可靠**:不在云端存储任何数据 - ⚡ **深度优化**:高效的分块处理 - 🛡️ **安全警报**:清晰明确的恶意/安全判定结果 ## 📦 安装说明 ### 前置条件 - Python 3.8 或更高版本 - pip (Python 包管理器) ### 快速安装 # 克隆仓库 git clone https://github.com/JuttSahib1999/FileHashAnalyzer.git cd FileHashAnalyzer # 安装依赖项 pip install -r requirements.txt # 运行应用 python file_hash_analyzer_gui.py 单行安装命令 (Linux/macOS) git clone https://github.com/JuttSahib1999/FileHashAnalyzer.git && cd FileHashAnalyzer && pip install -r requirements.txt && python file_hash_analyzer_gui.py ## 🎯 用法 快速入门 获取 VirusTotal API Key 访问 [VirusTotal](https://www.virustotal.com/) 创建一个免费账号 导航至个人资料页 → API Key 复制你的 API Key 启动应用 python file_hash_analyzer_gui.py 分析文件 点击“Browse”选择文件 (可选)输入你的 VirusTotal API Key 点击“Start Analysis” 查看综合分析结果 ## 📸 截图 主界面 https://github.com/JuttSahib1999/FileHashAnalyzer/blob/main/screenshots/main_interface.png 分析结果 - 安全文件 https://github.com/JuttSahib1999/FileHashAnalyzer/blob/main/screenshots/clean_file.png 分析结果 - 恶意文件 https://github.com/JuttSahib1999/FileHashAnalyzer/blob/main/screenshots/malicious_file.png 导出报告 https://github.com/JuttSahib1999/FileHashAnalyzer/blob/main/screenshots/export_report.png ## 🔌 API 集成 VirusTotal API 该工具使用 VirusTotal API v3 获取威胁情报: Endpoint:https://www.virustotal.com/api/v3/files/{hash} 速率限制:4 次请求/分钟(免费版) 响应:全面的分析结果 错误处理:优雅地处理速率限制问题 API Key 存储 密钥本地存储在 ~/.file_analyzer_config.json 中 本地加密(不进行外部传输) 可选:使用环境变量 VIRUSTOTAL_API_KEY ## 🔒 安全性 最佳实践 ✅ 切勿公开分享你的 API Key ✅ 在 CI/CD 中使用环境变量 ✅ 在执行前验证文件 ✅ 保持工具更新 ✅ 审慎查看 VirusTotal 的结果 安全特性 🔐 本地 API Key 存储 🔒 不向 VirusTotal 上传文件(仅限哈希校验) 🛡️ 安全的 API Key 密码输入框 ⚠️ 针对恶意文件提供明确的安全警告 ## 📄 许可证 本项目基于 MIT 许可证授权 - 详情请参阅 [LICENSE](https://github.com/JuttSahib1999/FileHashAnalyzer/blob/main/LICENSE) 文件。 🙏 支持 联系方式 作者:Abdul Muqeet Tabraiz GitHub:[JuttSahib1999](https://github.com/JuttSahib1999) LinkedIn:[AbdulMuqeetTabraiz](https://www.linkedin.com/in/abdul-muqeet-tabraiz/) 为仓库点亮 Star 如果你觉得这款工具好用,请考虑在 GitHub 上给它点个 ⭐! 由 Abdul Muqeet Tabraiz 用 ❤️ 制作 保持安全,保持受保护!🔐
标签:Ask搜索, PyQt6, Python, VirusTotal, 哈希计算, 威胁情报, 开发者工具, 文件校验, 无后门, 桌面应用, 逆向工具