merino

Crates.iomerino
lib.rsmerino
version0.1.3
sourcesrc
created_at2019-06-20 23:16:17.835455
updated_at2019-06-23 02:16:40.818918
descriptionA SOCKS5 Proxy server written in Rust
homepage
repositoryhttps://github.com/ajmwagar/merino
max_upload_size
id142444
size24,792
Avery Wagar (ajmwagar)

documentation

README

                     _
 _ __ ___   ___ _ __(_)_ __   ___
| '_ ` _ \ / _ \ '__| | '_ \ / _ \
| | | | | |  __/ |  | | | | | (_) |
|_| |_| |_|\___|_|  |_|_| |_|\___/

A SOCKS5 Proxy server written in Rust

🎁 Features

  • Multi-threaded connection handler
  • Lightweight (only uses CPU time for starting connections)
  • Standalone binary (no system dependencies)
  • 1+ Gb/second connection speeds (upload/download)
  • Tunable logging (try export RUST_LOG=merino=DEBUG)
  • SOCKS5 Compatible Authentication methods:
    • NoAuth
    • Username & Password
    • GSSAPI Coming Soon!

📦 Installation & 🏃 Usage

Installation

cargo install merino

OR

git clone https://github.com/ajmwagar/merino
cd merino
cargo install --path .

Usage

# Start a SOCKS5 Proxy server listening on port 1080 without authentication
merino --no-auth

# Use username/password authentication and read users from users.csv
merino --users users.csv

# Display a help menu
merino --help 

🚥 Roadmap

  • IPV6 Support
  • SOCKS5 Authentication Methods
    • NOAUTH
    • USERPASS
  • SOCKS5 Commands
    • CONNECT
    • BIND
    • ASSOCIATE
  • Actix based backend
  • SOCKS4 Support
Commit count: 75

cargo fmt