How drk1wi/modlishka works
Modlishka is a configurable, plugin-extensible HTTP(S) reverse proxy for authorized security testing and related proxy use cases. Its main workflow loads configuration and plugins, starts HTTP/TLS listeners, routes browser traffic to target domains, and rewrites responses for the proxy domain. The documented credential collection/control panel, dynamic client-domain hooking, and automatic certificate generation are represented as capability branches; some of their wiring is not visible in the sampled excerpts, so those links are marked unverified.
Main entry points: core_plugin.go Plugin Hooks · main.go Application Startup · proxy.go Proxy Transformation · server.go Request Routing
Components 19
Startup and Config
- Application Startup
main.go - Configuration
config/config.go - Runtime Rules
runtime/vars.go
Proxy Runtime
- HTTP/TLS Listeners
core/server.go - Request Routing
core/server.go - Proxy Transformation
core/proxy.go - Host and SSRF Checks
runtime/security.go - Domain Translation
runtime/func.go
Plugin Capabilities
- Plugin Hooks
plugin/core_plugin.go - Credential Capture
plugin/control.go - Credential Control Panel
plugin/control.go - Credential Store
plugin/control.go - TLS Certificate Generation
plugin/autocert.go - Domain Hook Diagnostics
plugin/hijack.go - Target Templates
plugin/template.go
Observability
- Request Logging
log/log.go
Other components
- Operator
- Browser Client
- Target Websites
Connections 22
- Operator → Application Startup: configures and starts
README.md - Application Startup → Configuration: parses options
main.go - Application Startup → Plugin Hooks: enables plugins
main.go - Application Startup → Runtime Rules: sets runtime config
main.go - Application Startup → HTTP/TLS Listeners: starts server
main.go - Configuration → Request Logging: configures logging
config/config.go - Browser Client → HTTP/TLS Listeners: sends HTTP(S)
README.md - HTTP/TLS Listeners → Request Routing: routes requests
core/server.go - Request Routing → Host and SSRF Checks: checks host and target
core/server.go - Request Routing → Proxy Transformation: creates and serves proxy
core/server.go - Request Routing → Domain Translation: resolves target domains
- Proxy Transformation → Target Websites: forwards traffic
README.md - Proxy Transformation → Runtime Rules: rewrites URLs
core/proxy.go - Proxy Transformation → Plugin Hooks: invokes response hooks
core/proxy.go - Plugin Hooks → Credential Capture: dispatches capture hooks
- Credential Capture → Credential Store: stores captured data
plugin/control.go - Credential Control Panel → Credential Store: reads and manages entries
plugin/control.go - Plugin Hooks → TLS Certificate Generation: enables certificate plugin
- Plugin Hooks → Domain Hook Diagnostics: dispatches diagnostics
- Plugin Hooks → Target Templates: enables template support
- Proxy Transformation → Request Logging: logs proxy activity
core/proxy.go - HTTP/TLS Listeners → Plugin Hooks: registers plugin handlers
core/server.go