https://github.com/vflame6/sharefinder
Active network shares enumeration tool.
https://github.com/vflame6/sharefinder
active-directory network-security scanner shared-folders smb
Last synced: 4 months ago
JSON representation
Active network shares enumeration tool.
- Host: GitHub
- URL: https://github.com/vflame6/sharefinder
- Owner: vflame6
- License: mit
- Created: 2025-03-12T10:46:55.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2026-02-28T11:20:56.000Z (4 months ago)
- Last Synced: 2026-02-28T15:40:26.670Z (4 months ago)
- Topics: active-directory, network-security, scanner, shared-folders, smb
- Language: Go
- Homepage: https://maksimradaev.com/posts/introducing-sharefinder/
- Size: 775 KB
- Stars: 10
- Watchers: 0
- Forks: 3
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
sharefinder
Active network shares enumeration tool.
Created by Maksim Radaev/[@vflame6](https://github.com/vflame6)
---
`sharefinder` is a network share discovery tool that enumerates shares, permissions and files in networks and domains.
## Features
Main commands:
- `hunt`: hunt network shares inside Active Directory domain
- `auth`: search for shares with specified credentials
- `guest`: search for shares accessible with guest authentication
- `null`: search for shares accessible by null session
You can check out a demo HTML report generated by the tool.
## Usage
```shell
sharefinder -h
```
Here is the help menu for the tool.
```yaml
usage: sharefinder [] [ ...]
sharefinder is a network share discovery tool that enumerates shares, permissions and files in networks and domains.
Flags:
-h, --[no-]help Show context-sensitive help (also try --help-long and --help-man).
--[no-]debug Enable debug mode, print debug messages
--[no-]quiet Enable quiet mode, print only results
-o, --output="" Filename to write output in raw format
--output-xml="" Filename to write XML formatted output
--output-all="" Filename to write output in all formats
--[no-]html Generate HTML report (requires XML output)
--threads=10 Number of threads
--timeout=5s Seconds to wait for connection
--smb-port=445 Target port of SMB service
--proxy="" SOCKS-proxy address to use for connection in format IP:PORT
-e, --exclude="IPC$,NETLOGON,ADMIN$,print$,C$"
Exclude list
--[no-]list List readable shares
--[no-]recurse List readable shares recursively
--[no-]version Show application version.
Commands:
help [...]
null
guest []
auth --username=USERNAME []
hunt --username=USERNAME []
```
## Installation
`sharefinder` requires **go1.25** to install successfully.
```shell
go install -v github.com/vflame6/sharefinder@latest
```
Compiled versions are available on [Release Binaries](https://github.com/vflame6/sharefinder/releases) page.
To Build:
```
go build -o sharefinder main.go
```
Build with Docker:
```shell
docker build -t sharefinder .
```
## Contributing
Feel free to open an issue if something does not work, or if you have any issues. New ideas to improve the tool are much appreciated.