Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/shirosaidev/sharesniffer
Network share sniffer and auto-mounter for crawling remote file systems
https://github.com/shirosaidev/sharesniffer
cifs file-sharing fileshare filesystem network-analysis nfs nmap nmap-scripts python smb sniffer sniffing storage
Last synced: 3 months ago
JSON representation
Network share sniffer and auto-mounter for crawling remote file systems
- Host: GitHub
- URL: https://github.com/shirosaidev/sharesniffer
- Owner: shirosaidev
- License: apache-2.0
- Created: 2018-03-06T02:54:55.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2022-03-27T04:17:22.000Z (over 2 years ago)
- Last Synced: 2024-04-24T13:20:20.122Z (6 months ago)
- Topics: cifs, file-sharing, fileshare, filesystem, network-analysis, nfs, nmap, nmap-scripts, python, smb, sniffer, sniffing, storage
- Language: Python
- Size: 75.2 KB
- Stars: 200
- Watchers: 16
- Forks: 46
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- awesome-hacking-lists - shirosaidev/sharesniffer - Network share sniffer and auto-mounter for crawling remote file systems (Python)
- awesome-network-stuff - **152**星
README
# sharesniffer
[](./LICENSE)
[](https://github.com/shirosaidev/sharesniffer/releases/latest)
[](https://www.patreon.com/shirosaidev)
[](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=CLF223XAS4W72)
sharesniffer is a network analysis tool for finding open and closed file shares on your local network. It includes auto-network discovery and auto-mounting of any open cifs and nfs shares.
## How to use
Example to find all hosts on any local network with open/closed nfs/smb shares:
```sh
python sharesniffer.py
```
Example to find all hosts in 192.168.56.0/24 network, excluding possible router/firewalls, and auto-mount any open nfs/smb shares at /mnt:
```sh
python sharesniffer.py -l 4 --hosts 192.168.56.0/24 -e 192.168.56.1,192.168.56.254 -a -m /mnt
```
## Requirements
- Python 2.7. or 3.5/3.6 (tested on 2.7.15 and 3.6.5)
- Linux or macOS
- Nmap https://nmap.org 7. in PATH (tested on 7.70)
- Nmap scripts (.nse) (on Linux/macOS they are usually in /usr/local/share/nmap/scripts/ or /usr/share/nmap/scripts/)
- python-nmap (pip install python-nmap)
- netifaces (pip install netifaces)
### Download
```shell
$ git clone https://github.com/shirosaidev/sharesniffer.git
$ cd sharesniffer
```
[Download latest version](https://github.com/shirosaidev/sharesniffer/releases/latest)
### CLI Options
```
usage: sharesniffer.py [-h] [--hosts HOSTS] [-e EXCLUDEHOSTS] [-l SPEEDLEVEL]
[-n] [--nfsmntopt NFSMNTOPT] [-s]
[--smbmntopt SMBMNTOPT] [--smbtype SMBTYPE]
[--smbuser SMBUSER] [--smbpass SMBPASS] [-a]
[-m MOUNTPOINT] [-p MOUNTPREFIX] [-v] [--debug] [-q]
[-V]
optional arguments:
-h, --help show this help message and exit
--hosts HOSTS Hosts to scan, example: 10.10.56.0/22 or 10.10.56.2
(default: scan all hosts)
-e EXCLUDEHOSTS, --excludehosts EXCLUDEHOSTS
Hosts to exclude from scan, example:
10.10.56.1,10.10.56.254
-l SPEEDLEVEL, --speedlevel SPEEDLEVEL
Scan speed aggressiveness level from 3-5, lower for
more accuracy (default: 4)
-n, --nfs Scan network for nfs shares
--nfsmntopt NFSMNTOPT
nfs mount options (default: ro,nosuid,nodev,noexec,udp
,proto=udp,noatime,nodiratime,rsize=1024,dsize=1024,ve
rs=3,rdirplus)
-s, --smb Scan network for smb shares
--smbmntopt SMBMNTOPT
smb mount options (default: ro,nosuid,nodev,noexec,udp
,proto=udp,noatime,nodiratime,rsize=1024,dsize=1024)
--smbtype SMBTYPE Can be smbfs (default) or cifs
--smbuser SMBUSER smb username (default: guest)
--smbpass SMBPASS smb password (default: none)
-a, --automount Auto-mount any open nfs/smb shares
-m MOUNTPOINT, --mountpoint MOUNTPOINT
Mountpoint to mount shares (default: ./)
-p MOUNTPREFIX, --mountprefix MOUNTPREFIX
Prefix for mountpoint directory name (default:
sharesniffer)
-v, --verbose Increase output verbosity
--debug Debug message output
-q, --quiet Run quiet and just print out any possible mount points
for crawling
-V, --version Prints version and exits
```