← 返回列表

ExternalHound: 基于 FastAPI + React 的企业级资产管理和关系图谱可视化平台

聚合站 SecWiki技术 入库 2026-11-18T02:39:39

现代化渗透测试数据管理平台

一个基于 FastAPI + React 的企业级资产管理和关系图谱可视化平台 专为渗透测试团队、安全研究人员和红队打造

🚧 早期开发版本 (Early Development)

💡 欢迎反馈

ExternalHound 是一个专为渗透测试和安全评估设计的资产管理平台,提供强大的数据聚合、关系分析和可视化能力。

使用自动化脚本快速启动完整开发环境:

# 1. 克隆仓库
git clone https://github.com/bilisheep/ExternalHound.git
cd ExternalHound
# 2. 初始化项目(首次运行)
./scripts/bootstrap.sh
# 3. 启动开发环境
./scripts/dev.sh

bootstrap.sh 会自动:

dev.sh 会自动:

访问 http://localhost:5173 即可使用系统。

配置优先级: 环境变量 > .env 文件 > config.toml 默认值

详细配置文档请参考 backend/CONFIG.md

后端配置:

前端配置:

开发环境默认密码:

⚠️ 生产环境请务必修改所有默认密码!

ExternalHound/
├── backend/              # FastAPI 后端
│   ├── app/
│   │   ├── api/v1/      # REST API 路由
│   │   ├── models/      # SQLAlchemy 模型
│   │   ├── schemas/     # Pydantic 模式
│   │   ├── services/    # 业务逻辑层
│   │   ├── repositories/# 数据访问层
│   │   ├── parsers/     # 解析器插件
│   │   └── db/          # 数据库连接
│   ├── alembic/         # 数据库迁移
│   ├── config.toml      # 配置文件(从 config.example.toml 复制)
│   ├── config.example.toml  # 配置模板
│   ├── CONFIG.md        # 配置说明文档
│   └── requirements.txt
├── frontend/            # React 前端
│   ├── src/
│   │   ├── pages/       # 页面组件
│   │   ├── components/  # 可复用组件
│   │   ├── hooks/       # 自定义 Hooks
│   │   ├── services/    # API 客户端
│   │   ├── contexts/    # React Contexts
│   │   └── types/       # TypeScript 类型
│   ├── vite.config.ts
│   └── package.json
├── db/                  # 数据库相关
│   └── init/            # 数据库初始化脚本
│       ├── postgres/    # PostgreSQL 初始化
│       └── neo4j/       # Neo4j 初始化
├── scripts/             # 开发运维脚本
│   ├── bootstrap.sh     # 项目初始化脚本
│   └── dev.sh           # 开发环境启动脚本
├── doc/                 # 详细技术文档 (中文)
├── docker-compose.yml   # 完整环境编排
├── DEPLOYMENT.md        # 部署指南
├── .env.example         # 环境变量模板
└── README.md            # 本文件
  1. 后端开发: 参考 doc/DEVELOPMENT.md 了解如何添加 API、修改数据库、调试等
  2. 前端开发: 参考 doc/DEVELOPMENT.md 了解如何添加页面、使用 Hooks、调用 API 等
  3. 插件开发: 参考 doc/PLUGIN_DEVELOPMENT.md 学习如何开发解析器插件
# 查看 API 文档
http://localhost:8000/docs
# 数据库迁移
cd backend
alembic revision --autogenerate -m "描述"
alembic upgrade head
# 运行测试
cd backend && pytest
cd frontend && npm test

详细的开发指南、调试技巧、性能优化、故障排查等请参考 doc/DEVELOPMENT.md

详细的生产部署指南请参考 DEPLOYMENT.md,包含:

详细技术文档位于 doc/ 目录 (中文):

原文链接:https://github.com/bilisheep/ExternalHound/tree/main/