Skip to content

A SimpleHTTPServer written in Go, enhanced with features and with a nice design - https://goshs.de

License

Notifications You must be signed in to change notification settings

patrickhener/goshs

Repository files navigation

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

goshs-logo

goshs is a replacement for Python's SimpleHTTPServer. It allows uploading and downloading via HTTP/S with either self-signed certificate or user provided certificate and you can use HTTP basic auth.

intro

goshs-screenshot-light goshs-screenshot-dark

Documentation

For a detailed documentation go to goshs.de

Features

  • Download or view files
    • Bulk download as .zip file
  • Upload files
    • POST request
    • PUT request
    • Drag & Drop in web interface
  • Delete files
    • Individually
    • Bulk delete
  • Authentication
    • Basic Authentication
    • Certificate Based Authentication via Client Certificate
  • Transport Layer Security (HTTPS)
    • self-signed
    • let's encrypt
    • provide own certificate
  • Non persistent clipboard
    • Download clipboard entries as .json file
  • WebDAV support
  • Read-Only and Upload-Only mode
  • Silent mode (no webserver output)
  • Retrieve json on cli
  • Drop user privileges before execution (Unix only)
    • Example: Run on port 80, but process is "www-data"
  • Themes
    • Dark Mode
    • Light Mode
  • Command Line
    • Run Commands on the system hosting goshs
  • File Based ACLs
    • You can place a .goshs in any folder to apply custom ACLs
    • You can apply custom basic auth per folder
    • You can restrict access to specific files completely
  • Embed files on compile time
  • Self updating binary
  • Write output to a log file

Installation

Release

You can download the executable from the release section

Go

go get -u github.com/patrickhener/goshs
go install github.com/patrickhener/goshs@latest

Build yourself

Building requirements are ugilfy-js and sass. After installing this packages you can easily just:

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

Kali repositories

When using kali you can easily just install it via cli, if it is not already installed:

sudo apt install goshs

Windows scoop package

If you are using the scoop package manager under Windows, you can install goshs this way:

scoop bucket add extras
scoop install extras/goshs

Credits

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