2019-09-11 19:48:57 +02:00
|
|
|
Metasploit [![Build Status](https://travis-ci.org/rapid7/metasploit-framework.svg?branch=master)](https://travis-ci.org/rapid7/metasploit-framework) [![Maintainability](https://api.codeclimate.com/v1/badges/943e398e619c09568f3f/maintainability)](https://codeclimate.com/github/rapid7/metasploit-framework/maintainability) [![Test Coverage](https://api.codeclimate.com/v1/badges/943e398e619c09568f3f/test_coverage)](https://codeclimate.com/github/rapid7/metasploit-framework/test_coverage) [![Docker Pulls](https://img.shields.io/docker/pulls/metasploitframework/metasploit-framework.svg)](https://hub.docker.com/r/metasploitframework/metasploit-framework/)
|
2012-05-30 17:40:31 +02:00
|
|
|
==
|
|
|
|
The Metasploit Framework is released under a BSD-style license. See
|
2019-10-07 09:46:15 +02:00
|
|
|
[COPYING](COPYING) for more details.
|
2012-05-30 17:40:31 +02:00
|
|
|
|
2015-03-29 01:51:15 +01:00
|
|
|
The latest version of this software is available from: https://metasploit.com
|
2012-05-30 17:40:31 +02:00
|
|
|
|
|
|
|
Bug tracking and development information can be found at:
|
|
|
|
https://github.com/rapid7/metasploit-framework
|
|
|
|
|
2015-01-30 21:28:39 +01:00
|
|
|
New bugs and feature requests should be directed to:
|
2017-05-16 21:25:30 +02:00
|
|
|
https://r-7.co/MSF-BUGv1
|
2015-01-30 21:28:39 +01:00
|
|
|
|
2014-12-20 00:25:56 +01:00
|
|
|
API documentation for writing modules can be found at:
|
|
|
|
https://rapid7.github.io/metasploit-framework/api
|
2012-05-30 17:40:31 +02:00
|
|
|
|
2017-07-20 16:32:52 +02:00
|
|
|
Questions and suggestions can be sent to: Freenode IRC channel or e-mail the metasploit-hackers mailing list
|
2012-05-30 17:40:31 +02:00
|
|
|
|
|
|
|
Installing
|
|
|
|
--
|
2014-04-11 22:55:18 +02:00
|
|
|
|
2017-08-20 20:23:54 +02:00
|
|
|
Generally, you should use [the free installer](https://github.com/rapid7/metasploit-framework/wiki/Nightly-Installers),
|
2015-03-29 13:08:06 +02:00
|
|
|
which contains all of the dependencies and will get you up and running with a
|
2017-05-16 21:25:30 +02:00
|
|
|
few clicks. See the [Dev Environment Setup](https://r-7.co/MSF-DEV) if
|
2014-04-11 22:55:18 +02:00
|
|
|
you'd like to deal with dependencies on your own.
|
2012-05-30 17:40:31 +02:00
|
|
|
|
|
|
|
Using Metasploit
|
|
|
|
--
|
|
|
|
Metasploit can do all sorts of things. The first thing you'll want to do
|
|
|
|
is start `msfconsole`, but after that, you'll probably be best served by
|
2014-12-20 19:53:34 +01:00
|
|
|
reading [Metasploit Unleashed][unleashed], the [great community
|
|
|
|
resources](https://metasploit.github.io), or the [wiki].
|
2012-05-30 17:40:31 +02:00
|
|
|
|
|
|
|
Contributing
|
|
|
|
--
|
2015-03-29 01:51:15 +01:00
|
|
|
See the [Dev Environment Setup][wiki-devenv] guide on GitHub, which will
|
|
|
|
walk you through the whole process from installing all the
|
2012-05-30 17:40:31 +02:00
|
|
|
dependencies, to cloning the repository, and finally to submitting a
|
2015-03-29 01:51:15 +01:00
|
|
|
pull request. For slightly more information, see
|
2012-11-07 03:18:58 +01:00
|
|
|
[Contributing](https://github.com/rapid7/metasploit-framework/blob/master/CONTRIBUTING.md).
|
2012-05-30 17:40:31 +02:00
|
|
|
|
|
|
|
|
2014-12-20 19:53:34 +01:00
|
|
|
[wiki]: https://github.com/rapid7/metasploit-framework/wiki
|
2013-06-15 14:12:59 +02:00
|
|
|
[wiki-devenv]: https://github.com/rapid7/metasploit-framework/wiki/Setting-Up-a-Metasploit-Development-Environment "Metasploit Development Environment Setup"
|
2012-05-30 17:40:31 +02:00
|
|
|
[wiki-start]: https://github.com/rapid7/metasploit-framework/wiki/ "Metasploit Wiki"
|
|
|
|
[wiki-usage]: https://github.com/rapid7/metasploit-framework/wiki/Using-Metasploit "Using Metasploit"
|
2017-05-16 21:25:30 +02:00
|
|
|
[unleashed]: https://www.offensive-security.com/metasploit-unleashed/ "Metasploit Unleashed"
|
2012-05-30 17:40:31 +02:00
|
|
|
|
|
|
|
|