jknyght9/greymhatter
GitHub: jknyght9/greymhatter
GreymHatter 是一款基于 Fedora 的 DFIR 发行版,集成了取证工具、分析平台和课程材料,用于安全教学和实际事件响应办案。
Stars: 6 | Forks: 0

# GreymHatter
一个基于 Fedora Linux 的数字取证与事件响应 (DFIR) 发行版。GreymHatter 作为教学和实际办案平台构建,将取证工具、分析平台和工作流自动化集成到一个可部署的虚拟机中。
[在此阅读文档](https://jknyght9.github.io/greymhatter/)
## 功能
- **XFCE 桌面**,包含 Qogir 主题、Plank dock 和 Conky 系统监控
- **Ghostty 终端**,包含 Fish shell 和预配置的 DFIR 辅助功能
- **取证工具**:Hayabusa、Sleuthkit (VMDK/VHD)、Volatility 2 & 3、capa、FLOSS、bulk_extractor、yq
- **分析平台**:Timesketch、Yeti、SpiderFoot、CyberChef(Docker 容器)
- **课程交付**:基于 MkDocs 并在本地提供的课程材料
- **双架构**:支持 AMD64 和 ARM64 (Apple Silicon)
- **自动化构建**:使用 Packer + Ansible 生成可复现的虚拟机镜像
## 快速开始
下载最新版本并导入到 VMware Workstation 或 Fusion 中。
| 架构 | 下载 |
|---|---|
| AMD64 (Intel/AMD) | [greymhatter-f42-amd64-20260603.e9e97d0.ova](https://releases.greymhatter.com/v2.0.0/greymhatter-f42-amd64-20260603.e9e97d0.ova) |
| ARM64 (Apple Silicon) | [greymhatter-f42-arm64-20260603.e9e97d0.zip](https://releases.greymhatter.com/v2.0.0/greymhatter-f42-arm64-20260603.e9e97d0.zip) |
| 校验和 | [SHA256SUMS](https://releases.greymhatter.com/v2.0.0/SHA256SUMS) |
```
Username: hatter
Password: H@tt3r123!
```
## 从源码构建
### 前置条件
- [Packer](https://developer.hashicorp.com/packer/install) (`brew install hashicorp/tap/packer`)
- [Docker](https://www.docker.com/)(用于 MkDocs 和工具编译)
- Proxmox 服务器(用于 AMD64 构建)或 VMware Fusion(用于 ARM64 构建)
### 构建 Pipeline
```
# AMD64 (Proxmox)
make base-amd64 # Stage 1: ISO → base template (run once)
make build-amd64 # Stage 2: Clone → Ansible → final template
make export-amd64 # Stage 3: Template → OVA
# ARM64 (VMware Fusion)
make build-arm64-base # Stage 1: ISO → base VM (run once)
make build-arm64 # Stage 2: Boot base → Ansible → final VM
make export-arm64 # Stage 3: VM → OVA
# 开发 (快速迭代)
make dev DEV_VM_IP= # SCP + Ansible on a live VM
```
### 测试
```
make test DEV_VM_IP= # Automated pass/fail
make test-manual DEV_VM_IP= # Verbose output for manual review
```
### 文档
```
make docs # Preview at http://localhost:8000
```
## 架构
```
greymhatter/
├── ansible/ # Ansible playbook and roles (9 roles)
│ ├── roles/base/ # OS config, packages, firewall
│ ├── roles/docker/ # Docker CE, daemon config
│ ├── roles/desktop/ # XFCE, Plank, conky, theming
│ ├── roles/user/ # User creation, dotfiles, fish shell
│ ├── roles/tools/ # DFIR tools (compiled via Docker builder)
│ ├── roles/containers/ # Timesketch, Yeti, SpiderFoot, CyberChef
│ ├── roles/courses/ # MkDocs course material delivery
│ ├── roles/samba/ # SMB file sharing
│ └── roles/verify/ # Post-install verification + manifest
├── packer/ # Packer templates (Proxmox + Fusion)
├── docs/ # Project documentation (MkDocs)
├── home/ # User dotfiles (fish, ghostty, tmux, nvim)
├── docker/ # Docker Compose files for services
├── media/v2/ # Logos, backgrounds, branding
├── tests/ # Integration test suite
└── Makefile # Build targets
```
## 容器服务
| 服务 | 端口 | 自动启动 | 启动命令 |
|------------|------|------------|-------------------|
| Homepage | 3000 | 是 | — |
| CyberChef | 8080 | 是 | — |
| Courses | 8000 | 是 | — |
| Timesketch | 443 | 否 | `starttimesketch` |
| Yeti | 8888 | 否 | `startyeti` |
| SpiderFoot | 5001 | 否 | `startspiderfoot` |
## 更新已部署的虚拟机
```
greymhatter-update
```
## 免责声明
本平台专为教学目的而开发,未在生产环境中进行过测试。本项目的作者和维护者不对使用本产品期间造成的任何数据或生产力损失负责。
## 截图





标签:BurpSuite集成, Fedora Linux, PB级数据处理, 安全运维, 库, 应急响应, 操作系统发行版, 数字取证, 生成式AI安全, 系统提示词, 自动化构建, 自动化脚本, 虚拟机, 请求拦截