JuttSahib1999/FileHashAnalyzer
GitHub: JuttSahib1999/FileHashAnalyzer
一款基于 Python 和 PyQt6 构建的跨平台桌面工具,支持多算法文件哈希生成与 VirusTotal 实时威胁情报查询,帮助用户验证文件完整性并检测恶意文件。
Stars: 0 | Forks: 0
# 🔐 File Hash Analyzer Pro
**集成 VirusTotal 的高级文件哈希分析工具 | 2026 版**
[](https://www.python.org/downloads/)
[](LICENSE)
[](https://github.com/JuttSahib1999/FileHashAnalyzer)
[](http://makeapullrequest.com)
[](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, 哈希计算, 威胁情报, 开发者工具, 文件校验, 无后门, 桌面应用, 逆向工具