How cert-polska/drakvuf-sandbox works
DRAKVUF Sandbox accepts suspicious files through its web interface, queues analysis jobs, runs them in an agentless virtual machine, post-processes the captured behavior, and presents reports and artifacts. The graph also includes documented installation and optional S3 storage capabilities. API and VM wiring is shown at the subsystem level because those implementations were not sampled; uncertain internal calls are omitted.
Main entry points: worker.py Analysis worker · api.py Web API · App.jsx Web frontend · storage.py Artifact access
Components 15
Web interface
- Web frontend
drakrun/web/frontend/src/App.jsx - Web API
drakrun/web/api.py - Artifact access
drakrun/web/storage.py
Analysis jobs
- RQ queue
drakrun/analyzer/worker.py - Analysis worker
drakrun/analyzer/worker.py
Sandbox execution
- File analyzer
drakrun/analyzer/analyzer.py - VM management
drakrun/lib/vm.py
Results and storage
- Post-processing
drakrun/analyzer/postprocessing/postprocess.py - Analysis plugins
drakrun/analyzer/postprocessing/plugins - Local analysis files
drakrun/lib/paths.py
System operations
- System installer
drakrun/cli/install.py
Other components
- Analyst
- Virtualization host
- DRAKVUF engine
- S3 object storage
Connections 18
- Analyst → Web frontend: uploads sample
- Web frontend → Web API: calls API
- Web API → RQ queue: enqueues job
- RQ queue → Analysis worker: dispatches job
- Analysis worker → File analyzer: runs analysis
- File analyzer → VM management: uses VM
- VM management → Virtualization host: manages guest
- File analyzer → DRAKVUF engine: captures behavior
- Analysis worker → Post-processing: processes output
- Post-processing → Analysis plugins: runs plugins
- Analysis worker → Local analysis files: writes artifacts
- Post-processing → Local analysis files: writes results
- Web frontend → Web API: requests results
- Web API → Artifact access: serves artifacts
- Artifact access → Local analysis files: reads files
- Analysis worker → S3 object storage: uploads analysis
- Artifact access → S3 object storage: reads objects
- System installer → Virtualization host: configures host