simple-http-server — simple static http server

How it looks like?

Screenshot

Command Line Arguments

Simple HTTP(s) Server 0.6.0

USAGE:
    simple-http-server [FLAGS] [OPTIONS] [--] [root]

FLAGS:
        --cors       Enable CORS via the "Access-Control-Allow-Origin" header
    -h, --help       Prints help information
    -i, --index      Enable automatic render index page [index.html, index.htm]
        --nocache    Disable http cache
        --norange    Disable header::Range support (partial request)
        --nosort     Disable directory entries sort (by: name, modified, size)
    -s, --silent     Disable all outputs
    -u, --upload     Enable upload files (multiple select)
    -V, --version    Prints version information

OPTIONS:
    -a, --auth <auth>                              HTTP Basic Auth (username:password)
        --cert <cert>                              TLS/SSL certificate (pkcs#12 format)
        --certpass <certpass>                      TLS/SSL certificate password
    -c, --compress <compress>...
            Enable file compression: gzip/deflate
                Example: -c=js,d.ts
                Note: disabled on partial request!
        --ip <ip>                                  IP address to bind [default: 0.0.0.0]
    -p, --port <port>                              Port number [default: 8000]
        --redirect <redirect>                      takes a URL to redirect to using HTTP 301 Moved Permanently
    -t, --threads <threads>                        How many worker threads [default: 3]
        --try-file <PATH>
            serve this file (server root relative) in place of missing files (useful for single page apps) [aliases:
            try-file-404]
    -l, --upload-size-limit <upload_size_limit>    Upload file size limit [bytes] [default: 8000000]

Installation

Download binary

Goto Download

windows-64bit
osx-64bit
linux-64bit

Install by cargo

# Install Rust
curl https://sh.rustup.rs -sSf | sh

# Install simple-http-server
cargo install simple-http-server
rehash
simple-http-server -h

Features

26 Open More issues

Closed

Sensitive information disclosure

Readable to /etc/passwd file http://your-ip/..%2f..%2f..%2f..%2f..%2f..%2f..%2f..%2f..%2f..%2f..%2f..%2fetc/passwd

opened May 17, 2018 by goecho 13

Closed

🚨 Potential Security Vulnerability

Hello, @TheWaWaR @vi @not-fl3 @michelk @tforgione - 2 potential high severity security vulnerability in your repository has been disclosed to huntr.

Visit report URL and validate them https://www.huntr.dev/bounties/3-other-TheWaWaR/simple-http-server/ https://www.huntr.dev/bounties/2-other-TheWaWaR/simple-http-server/

Best Regards

opened Jun 1, 2021 by x3rz 7

Closed

Strip symbols and add crate openssl to and allow the binary to run in distroless containers

Motivation

I was building a minimal distroless container image for this program, and I realized that the release binary's size can still be reduced significantly. Stripping the binary will cut a significant amount of size off the binary:

The binary also doesn't run in Google's distroless static or base image since it cannot find libssl.

Changes

Added strip into the release profile to automatically strip the binary upon building the release.
Added openssl as a build dependency so it will be integrated into the binary, allowing the binary to run on static:nonroot.

Here's an example Dockerfile I created for it: https://github.com/k4yt3x/simple-http-server/blob/master/Dockerfile

The final image is around 11 MiB in size, which is a decent size. I can open another PR for the Dockerfile if you're interested in maintaining it in your repo too.

opened Apr 11, 2022 by k4yt3x 5

Closed

Fix cross in CI

Fix #77

Artifacts: https://github.com/patrickelectric/simple-http-server/actions/runs/3970550188

release: https://github.com/patrickelectric/simple-http-server/releases/tag/fix_cross_ci

opened Jan 20, 2023 by patrickelectric 4

Closed

[feature] add mime type bindings by command line

While experimenting with WebAssembly I found that (at least in Firefox) WebAssembly.instantiateStreaming() requires .wasm-resources to be delivered as application/wasm. Otherwise you end up with "TypeError: Response has unsupported MIME type".

Since application/wasm doesn't seem to be official, yet (https://www.iana.org/assignments/media-types/media-types.xhtml#application) I cannot expect simple-http-server to include this binding.

It would be helpful to be able to add bindings between file extensions and mime types via command line.

opened Oct 2, 2018 by kawogi 4

Closed

Please support serve specified file for not found path (useful for single page apps)

Like the --entry-file parameter of live-server.

opened Mar 14, 2018 by J-F-Liu 4

Open

TLS/SSL Support

Hi,

I encountered an error while attempting to assign a certificate. The error message states that "TLS support is not enabled during compilation of simple-http-server." I am currently using version 0.6.7 of the software. Interestingly, when I switch to version 0.6.5, I can successfully complete the assignment without any problems.

As I am using Windows 11, I would appreciate any suggestions you have to resolve this issue.

Thank you.

opened May 28, 2023 by KyNicholas 0

Open

Please add Content-Disposition in the downloaded response header

The file name can be obtained through Content-Disposition

opened Feb 21, 2023 by mofazhe 0

Open

Is it possible to provide units for the "-l" parameter?

--upload-size-limit The default setting is in bytes, but when uploading large files, it's inconvenient to set a large number of bytes. I hope to carry the letters k, m, g after the number, so as to define the file size limit for uploading. For example, 10m, for example, 1g.

opened Feb 5, 2023 by snakeysky 0

Open