Skip to content

README.md

Latest commit

 

History

History
134 lines (109 loc) · 4.23 KB

README.md

File metadata and controls

134 lines (109 loc) · 4.23 KB

Supported Python versions Supported Python versions Vue3 Vue3 UI MIT

Static

MetaView
Metasploit Framework Web UI on Vue3

A web-based interface for the Metasploit Framework with multi-user support and an intuitive UI.

Arch

For more detailed information on setting up and using msfdb, you can find out here .

✨ Capabilities

  • Modern web interface
  • Project management (add, edit and remove workspaces)
  • Visualization of data stored in the Metasploit Framework Database: Hosts, Services, Notes, Vulns, Creds, Loots, Sessions
  • Import data from MaxPatrol, Nmap, Acunetix
  • Managing the structure of websites being tested (WMAP and Acunetix scanning)
  • View session events such as meterpreter MainView

👥 Team mode

  • Separation of roles and projects
  • Tag operation history
  • Creating tasks for project users

📊 Dashboards

  • Live dashboards with metrics
  • Visualization of scan results Dashboards

🚀 Quick start

💻 Local installation (requires Python 3.8 - 3.13)

# Clone
git clone https://github.com/sh94ya/MetaView.git
cd MetaView

# Linux
python3 -m venv venv
source venv/bin/activate
pip install -e .
# Edit config.ini (See Configuration section)
# Run
gunicorn --workers 4 --bind 127.0.0.1:5000 main:app

# Windows
python.exe -m venv venv
venv\Scripts\activate.bat
pip install -e .
# Edit config.ini (See Configuration section)
# Run
python.exe main.py

# Open in a browser (default creds - admin:admin)
http://localhost:5000

🐋 Docker

Single container

# Clone
git clone https://github.com/sh94ya/MetaView.git
cd MetaView

# Build Docker Image
docker build -t metaview .

# Edit config.ini (See Configuration section)

# Run container
docker run -p 5000:5000 -v $(pwd)/config.ini:/app/config.ini metaview

# Open in a browser (default creds - admin:admin)
http://localhost:5000

Docker Compose (MetaView and PostgreSQL up)

# Clone
git clone https://github.com/sh94ya/MetaView.git
cd MetaView

# Edit config.ini
ADDRESS=db

# Build and Run metaview-web and postgresql-db containers
docker compose up --build

# Open in a browser (default creds - admin:admin)
http://localhost:5000

🔧 Configuration

Edit config.ini:

In the [DB] section of the config.ini file, set the data for establishing a connection to the PostgreSQL database for joint work with msfconsole.

[DB]
LOGIN=msf
PASSWORD=msf
ADDRESS=127.0.0.1
PORT=5432
DATABASE=msf

Security

Change your secret key:

[JWT]
SECRET_KEY = '<change-your-secret_key>'

🛠 Тechnology stack

Flask + Vue 3 (with Quasar Framework)

⚠️ Disclaimer

IMPORTANT: This tool is intended solely for:

  • Legal penetration testing
  • Educational purposes
  • Cybersecurity research

The developer is not responsible for illegal use.

📄 License

Distributed under the MIT License. See the LICENSE file for details.

👨‍💻 Author

sh94ya — Lead Developer — GitHub

🌟 Support the project

Give a ⭐️ on GitHub if you like the project!