22 releases (12 breaking)

0.13.1 Oct 16, 2020
0.12.0 Aug 31, 2020
0.11.2 Jul 10, 2020
0.6.1 Mar 23, 2020
0.5.0 Nov 15, 2019

#49 in Network programming

Download history 48/week @ 2020-07-05 48/week @ 2020-07-12 32/week @ 2020-07-19 8/week @ 2020-07-26 7/week @ 2020-08-02 50/week @ 2020-08-09 51/week @ 2020-08-16 12/week @ 2020-08-23 85/week @ 2020-08-30 52/week @ 2020-09-06 16/week @ 2020-09-13 23/week @ 2020-09-20 70/week @ 2020-09-27 46/week @ 2020-10-04 31/week @ 2020-10-11 53/week @ 2020-10-18

158 downloads per month
Used in 3 crates

Apache-2.0

290KB
6K SLoC

libunftp

Crate Version API Docs Build Status Crate License

When you need to FTP, but don't want to.

logo

The libunftp library drives unFTP. It's an extensible, async, cloud orientated FTP(S) server implementation in Rust brought to you by the bol.com techlab.

Because of its plug-able authentication (PAM, JSON File, Generic REST) and storage backends (e.g. local filesystem, Google Cloud Storage) it's more flexible than traditional FTP servers and a perfect match for the cloud.

It runs on top of the Tokio asynchronous run-time and tries to make use of Async IO as much as possible.

Prerequisites

You'll need Rust 1.41 or higher to build libunftp.

Getting started

If you've got Rust and cargo installed, create your project with

cargo new myftp

Then add the libunftp and tokio crates to your project's dependencies in Cargo.toml:

[dependencies]
libunftp = "0.13.1"
tokio = { version = "0.2", features = ["full"] }

Now you're ready to develop your server! Add the following to src/main.rs:

#[tokio::main]
pub async fn main() {
    let ftp_home = std::env::temp_dir();
    let server = libunftp::Server::with_fs(ftp_home)
        .greeting("Welcome to my FTP server")
        .passive_ports(50000..65535);
    
    server.listen("127.0.0.1:2121").await;
}

You can now run your server with cargo run and connect to localhost:2121 with your favourite FTP client e.g.:

lftp -p 2121 localhost

For more help refer to:

Contributing

Thank you for your interest in contributing to libunftp!

Please feel free to create a github issue if you encounter any problems.

Want to submit a feature request? Then head over to our contribution guide (CONTRIBUTING.md).

License

You're free to use, modify and distribute this software under the terms of the Apache License v2.0.

Dependencies

~18MB
~425K SLoC