sarfaraz-16/phishguard-ai

# PhishGuard AI PhishGuard AI 是一个综合性的网络安全平台，旨在提供深度域名情报和威胁检测。它针对各种威胁数据库分析 URL，执行启发式钓鱼分析，检测盗版相关内容，并提供详细的侦察数据，包括 SSL 有效性、域名年限和托管情报。 ## 技术栈 - **前端:** React.js + Vite, Tailwind CSS - **后端:** Node.js + Express - **数据库:** MongoDB - **安全协议:** SSL/TLS 检查, WHOIS 分析, DNS 解析, 域名误植 (Typosquatting) 启发式分析 ## 项目结构 ``` phishguard-ai/ ├── backend/ │ ├── data/ # Threat intelligence datasets (JSON) │ ├── models/ # Mongoose database schemas │ ├── routes/ # Express API endpoints │ ├── services/ # Backend intelligence & analyzer modules │ ├── server.js # Main application entry point │ └── .env # Environment configuration ├── frontend/ │ ├── src/ │ │ ├── components/ # UI Dashboard and Scan components │ │ ├── services/ # API interaction layer │ │ └── App.jsx # Main React entry point │ ├── package.json │ └── vite.config.js └── README.md ``` ## 安装指南 请按照以下步骤在本地设置项目： 1. **克隆仓库：** git clone https://github.com/selvipraveen252-png/phishguard-ai.git cd phishguard-ai 2. **后端设置：** cd backend npm install 3. **前端设置：** cd ../frontend npm install ## 环境变量设置 在 `backend/` 目录下创建一个 `.env` 文件并添加以下变量： ``` PORT=5000 MONGO_URI=your_mongodb_connection_string IPINFO_API_KEY=your_ipinfo_api_key WHOIS_API_KEY=your_whois_api_key VT_API_KEY=your_virustotal_api_key ``` ## API 密钥设置 要启用完整的情报功能，您必须从以下提供商处获取 API 密钥： 1. **IP 地理位置 (IPinfo):** - 访问 [ipinfo.io](https://ipinfo.io) - 创建一个免费账户。 - 将您的访问令牌复制到 `IPINFO_API_KEY`。 2. **恶意软件信誉 (VirusTotal):** - 访问 [virustotal.com](https://www.virustotal.com) - 注册一个免费的开发者账户。 - 转到您个人资料中的 API 密钥部分。 - 将密钥复制到 `VT_API_KEY`。 3. **WHOIS 查询 (WHOISXMLAPI):** - 访问 [whoisxmlapi.com](https://www.whoisxmlapi.com) - 注册一个免费计划。 - 在仪表盘中找到您的 API 密钥。 - 将密钥复制到 `WHOIS_API_KEY`。 ## 运行后端服务器 导航到后端目录并启动服务器： ``` cd backend npm start ``` 后端服务器将运行于： `http://localhost:5000` ## 运行前端应用程序 导航到前端目录并启动开发服务器： ``` cd frontend npm run dev ``` 前端应用程序将运行于： `http://localhost:5173` ## 默认端口 | 组件 | 默认 URL | |-----------|-------------| | 前端 | http://localhost:5173 | | 后端 | http://localhost:5000 | | MongoDB | mongodb://localhost:27017 | ## 故障排除 - **MongoDB 连接错误：** 确保您的 MongoDB 服务正在运行，并且 `.env` 中的 `MONGO_URI` 正确。 - **API 失败：** 验证您的 API 密钥是否有效，并且未超出其免费层限额。 - **CORS 问题：** 后端配置为允许来自 `http://localhost:5173` 的请求。如果您更改了前端端口，请更新 `backend/server.js` 中的 `origin`。 ## 作者 PhishGuard AI 开发团队

标签：Express, GitHub, GNU通用公共许可证, MERN 全栈, MITM代理, MongoDB, Node.js, React, SSL 证书检测, Syscalls, Tailwind CSS, TLS, URL 分析, VirusTotal 集成, Vite, WHOIS 查询, 主机情报, 人工智能, 启发式分析, 域名威胁情报, 域名年龄分析, 域名抢注检测, 威胁情报, 开发者工具, 恶意软件扫描, 用户模式Hook绕过, 网络安全, 网络钓鱼检测, 自定义脚本, 配置审计, 防御工具, 隐私保护