How kgretzky/evilginx2 works
Evilginx is a Go-based reverse-proxy phishing framework. Its principal workflow starts with an operator configuring a site and phishlet, then serving DNS/TLS and proxy traffic; the proxy tracks authentication material in sessions, with persistence available through the database. The graph also preserves the command/help interface, blacklist, ACME HTTP endpoint, and documented Gophish integration. Several connections are supported by excerpts or the README; unsampled implementation details are not inferred.
Main entry points: main.go Application startup · terminal.go Command terminal · http_proxy.go Reverse proxy · config.go Configuration
Components 18
Operator control
- Application startup
main.go - Command terminal
core/terminal.go - Command help
core/help.go - Input parser
parser/parser.go - Gophish integration
core/gophish.go
Site setup
- Configuration
core/config.go - Phishlet definitions
core/phishlet.go - IP blacklist
core/blacklist.go
Traffic handling
- DNS server
core/nameserver.go - Certificate manager
core/certdb.go - ACME HTTP endpoint
core/http_server.go - Reverse proxy
core/http_proxy.go
Session and storage
- Authentication session
core/session.go - Persistent database
database/database.go - Session persistence
database/db_session.go
Other components
- Operator
- Browser
- Upstream website
Connections 24
- Operator → Application startup: starts
README.md - Application startup → Configuration: initializes
main.go - Application startup → Persistent database: opens
main.go - Application startup → Phishlet definitions: loads
main.go - Application startup → DNS server: starts
main.go - Application startup → Certificate manager: initializes
main.go - Application startup → Reverse proxy: starts
main.go - Application startup → Command terminal: starts
main.go - Operator → Command terminal: configures
README.md - Command terminal → Configuration: updates
core/terminal.go - Command terminal → Command help: registers commands
core/terminal.go - Command terminal → Input parser: uses
core/terminal.go - Command terminal → Gophish integration: tests connection
core/terminal.go - Configuration → Phishlet definitions: loads definitions
- Configuration → DNS server: supplies settings
core/nameserver.go - Certificate manager → Configuration: reads settings
core/certdb.go - Certificate manager → DNS server: uses nameserver
core/certdb.go - Browser → Reverse proxy: sends requests
README.md - Reverse proxy → Upstream website: forwards requests
README.md - Reverse proxy → Authentication session: tracks tokens
core/http_proxy.go - Reverse proxy → Persistent database: uses storage
core/http_proxy.go - Persistent database → Session persistence: persists sessions
database/db_session.go - Reverse proxy → IP blacklist: checks addresses
- Certificate manager → ACME HTTP endpoint: serves challenges