httprs

A fast simple command line http server tool.

Why httprs ?

If you're looking for a simple, fast, easy-to-use, generic-MIME-types-supporting and partial-content-supporting static file server like me, it might be an option.

Warning: It is currently an experimental project. Use it at your own risk!!!

Features

the main features are as followings, and certainly more will be added:

• performant and essy to use
• multi-platform support
• multiple MIME support
• colored logs
• partial content support

Installation

Download pre-built binaries from release page.

or install with cargo in terminal:

cargo install httprs

Usage

# quick start, running on http://127.0.0.1:9900
httprs
# run in insecure mode
httprs -H 0.0.0.0 -P 10000
# run in secure mode
httprs --secure --key /path/to/keyfile --cert /path/to/certfile
# run with graceful shutdown
httprs --graceful-shutdown
# help for more details
httprs --help

Roadmap

• Logging
  • Request/Response Logging
  • Silent Mode
  • Logging Level
  • Logging Output into File
• File Browser Support
  • Generic File Type Supporting: image/text/video/binary
  • File Metadata Details
    • File Size
    • Last Modified
    • More if Necessary
  • File List Ordering
  • Content-Type Customization
• Multiplatform Support
  • macOS
  • Linux
  • Windows
• HTTPS/TLS Transmission Encryption
• Partial Request/Response Support
  • If-Range REQUEST Header
  • If-Match REQUEST Header
  • Range REQUEST Header: when file size exceeds 50MB
  • Accept-Ranges RESPONSE Header
  • Content-Range RESPONSE Header
  • CODE 206 - Partial Content
  • CODE 416 - Range Not Satisfiable
• CORS Support
• Transmission Compression
• Authentication
  • Simple Basic
  • Token Based
• Graceful Shutdown
• Proxy
• Themes and Appearances Customization

How to contribute

Any advice is welcomed and feel free to make a fork and push your own code.

Acknowledgements

Thanks to those who are inspiring me, supporting me, providing me with ideas, advice, solutions, and all users who bear much using this.

• http-server-rs/http-server for initial thoughts.
• egmkang/local_ipaddress for resolving intranet binding IP addresses.

Licenses

MIT License