How maliceio/malice works
Malice is a Docker-based malware analysis framework intended to provide a self-hosted VirusTotal-style workflow. The main path accepts a sample through the CLI, records file metadata, stores the sample for container access, and dispatches enabled intelligence and MIME-selected plugins; results are stored in Elasticsearch. Separate CLI capabilities manage plugins, look up hashes, watch folders, and start the ELK-backed UI. The graph also shows Docker operations and the API surface. Some command implementations and API routes were not sampled, so those branches are documented or left without speculative internal links.
Main entry points: scan.go Scan workflow · run.go Container operations · client.go Docker client · main.go Malice CLI
Components 17
CLI and API
- Malice CLI
main.go - Scan workflow
commands/scan.go - Other commands
commands - HTTP API
api/server
Sample analysis
- File metadata
malice/persist/file.go - Sample volume
malice/persist/filestore.go - Plugin dispatch
plugins/plugins.go - Plugin management
commands/plugin.go
Docker runtime
- Docker client
malice/docker/client/client.go - Container operations
malice/docker/client/container/run.go - Image operations
malice/docker/client/image/image.go - Elasticsearch startup
malice/database/database.go - Analysis plugins
plugins/plugins.go
Results and UI
- Elasticsearch
- Kibana startup
malice/ui/ui.go - Kibana UI
Other components
- Researcher
Connections 23
- Researcher → Malice CLI: runs commands
- Malice CLI → Scan workflow: dispatches scan
main.go - Malice CLI → Other commands: dispatches commands
main.go - Scan workflow → Docker client: creates client
commands/scan.go - Scan workflow → Container operations: cleans containers
commands/scan.go - Scan workflow → Elasticsearch startup: starts database
commands/scan.go - Scan workflow → File metadata: reads sample
commands/scan.go - Scan workflow → Sample volume: copies sample
commands/scan.go - Scan workflow → Elasticsearch: stores file info
commands/scan.go - Scan workflow → Plugin dispatch: runs plugins
commands/scan.go - Plugin dispatch → Analysis plugins: starts plugins
plugins/plugins.go - Analysis plugins → Container operations: starts containers
plugins/plugins.go - Plugin management → Plugin dispatch: manages plugins
commands/plugin.go - Plugin management → Docker client: creates client
commands/plugin.go - Elasticsearch startup → Container operations: starts container
malice/database/database.go - Elasticsearch startup → Elasticsearch: waits for connection
malice/database/database.go - Container operations → Docker client: uses client
malice/docker/client/container/run.go - Image operations → Docker client: uses client
malice/docker/client/image/image.go - Other commands → Kibana startup: starts UI
- Kibana startup → Container operations: starts container
malice/ui/ui.go - Kibana startup → Kibana UI: starts Kibana
malice/ui/ui.go - Kibana UI → Elasticsearch: views scan results
- Other commands → HTTP API: serves API