Skip to content

patrickhener/goshs

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

499 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Version GitHub GitHub go.mod Go version GitHub issues goreleaser Go Report Card codecov GitHub stars

goshs-logo

You're mid-engagement. You need to transfer a file, catch an SMB hash, or stand up a quick HTTPS server — and python3 -m http.server won't cut it.

goshs is a single-binary file server built for the moments when you need more than Python's SimpleHTTPServer but don't want to configure Apache. HTTP/S, WebDAV, SFTP, SMB, basic auth, share links, DNS/SMTP callbacks, NTLM hash capture + cracking — all from one command.

intro

goshs-screenshot-light goshs-screenshot-dark

Collaboration / CTF Features

goshs-collab

goshs-smb-ntlm

Quick Start

# Serve the current directory on port 8000
goshs

# Serve with HTTPS (self-signed) and basic auth
goshs -s -ss -b user:password

# Capture SMB hashes
goshs -smb -smb-domain CORP

# Catch DNS callbacks and receive emails
goshs -dns -dns-ip 1.2.3.4 -smtp -smtp-domain your-domain.com

Documentation

For a detailed documentation go to goshs.de

Features

📁 File Operations Download, upload (drag & drop, POST/PUT), delete, bulk ZIP, QR codes
🔌 Protocols HTTP/S, WebDAV, SFTP, SMB
🔒 Auth & Security Basic auth, certificate auth, TLS (self-signed, Let's Encrypt, custom cert), IP whitelist, file-based ACLs
⚙️ Server Modes Read-only, upload-only, no-delete, silent, invisible, CLI command execution
🔗 Share Links Token-based sharing, download limit, time limit
🎯 Collaboration / CTF DNS server, SMTP server, SMB NTLM hash capture + cracking, redirect endpoint
🔔 Integration Webhooks, tunnel via localhost.run, config file, JSON API, mDNS
🛠️ Misc Dark/light themes, clipboard, self-update, log output, embed files, drop privileges

Installation

Method
🦫 Go go install goshs.de/goshs/v2@latest
🐉 Kali sudo apt install goshs
🍺 Homebrew brew install goshs
🪟 Scoop scoop bucket add extras && scoop install extras/goshs
🐳 Docker docker run --rm -it -p 8000:8000 -v "$PWD:/pwd" patrickhener/goshs:latest -d /pwd
📦 Release Download from GitHub Releases
🔧 Build yourself

Building requirements are uglify-js and sass. After installing these packages run:

git clone https://github.com/patrickhener/goshs.git
cd goshs
make build-all

Code Contributors

Contributors

Security Contributors

These are the awesome contributors that made goshs even more secure ❤️

wooseokdotkim Guilhem7

Community

Join the Discord Community and start connecting.

Join Discord

Star History

Star History Chart

Credits

A special thank you goes to sc0tfree for inspiring this project with his project updog written in Python.

About

Feature-rich single-binary file server for red teamers and developers. HTTP/S · WebDAV · SFTP · SMB · NTLM hash capture · DNS/SMTP callbacks · TLS · Auth · Share links. A powerful python3 -m http.server replacement.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Contributors