bin+lib soft-serve

Easily serve your filesystem

7 releases

0.0.8 Apr 26, 2024
0.0.7 Apr 26, 2024

23 downloads per month

MIT license

24KB
258 lines

sfs - Soft Serve

A very simple file server, named after my favorite kind of ice cream 🍦

Features

  • HTTP/1 and HTTP/2
  • FTP
  • TFTP
  • As simple as it gets

Installation

With cargo-binstall

cargo binstall soft-serve

or cargo install

cargo install soft-serve --locked

Usage

Serves the current directory over HTTP

sfs

Serves the dist directory over HTTP

sfs dist

Serves files over FTP

sfs ftp files

Serves files over TFTP

sfs ftp files --trivial

or

sfs ftp files -t

Options

--port or -p

Set the port the server lsitens on. Defaults to 5001 for HTTP and 5002 for FTP and TFTP.

--ip or -i

Set the IP address of the server. Defaults to 127.0.0.1

--no-index-convenience (HTTP only)

Turns off the convenience functionality of / being treated as /index.html.

--trivial or -t (FTP only)

Serve files over TFTP instead of FTP.

As Library

soft-serve = { version = "0.0.8", no-default-features = true, features = ["http", "ftp"] }

Dependencies

~6–21MB
~320K SLoC