https://github.com/bradfier/gestetner

A netcat & HTTP pastebin
https://github.com/bradfier/gestetner

pastebin rust

Last synced: 9 days ago
JSON representation

A netcat & HTTP pastebin

• Host: GitHub
• URL: https://github.com/bradfier/gestetner
• Owner: bradfier
• License: agpl-3.0
• Created: 2021-05-26T19:29:55.000Z (over 3 years ago)
• Default Branch: master
• Last Pushed: 2022-01-02T17:04:24.000Z (almost 3 years ago)
• Last Synced: 2024-10-15T17:24:35.106Z (24 days ago)
• Topics: pastebin, rust
• Language: Rust
• Homepage:
• Size: 40 KB
• Stars: 2
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-starred - bradfier/gestetner - A netcat & HTTP pastebin (rust)

README

        
# gestetner

A netcat and HTTP command line pastebin for sharing straight from your terminal.

## Why another one?

I was able to find pastebin servers which supported publishing pastes over plain sockets (with `nc`) or

over HTTP(S) with `curl`, but not one that supported both!

There are some scenarios where all you have available is a shell, and being able to [paste to a plain socket](https://github.com/solusipse/fiche#pure-bash-alternative-to-netcat)

is surprisingly useful.

## Client Usage

```

SYNOPSIS

     | nc etc.fstab.me 9999

     | curl --data-binary @- https://etc.fstab.me

EXAMPLES

    ~$ ls -l | curl --data-binary @- https://etc.fstab.me

       https://etc.fstab.me/abcd

    ~$ ls -l | nc etc.fstab.me 9999

        https://etc.fstab.me/efgh

```

## Server Usage

```

USAGE:

  gestetner -l '[::]:9999' -w '[::]:8080' -p /tmp/gst -u http://localhost:8080

FLAGS:

  -h, --help        Prints help information

OPTIONS:

  -u URL            Set the base URL to be returned in paste responses

  -l HOST:PORT      Set the listening socket address for incoming pastes

  -p PATH           Set the filesystem path in which to store pastes

  -w HOST:PORT      Set the listening socket for the HTTP server

  -n LENGTH         Set the length of the random paste slug (default: 4)

  -m MAX_SIZE       Set the maximum size of a paste in bytes (default: 512KiB)

  -r RATE           Maximum number of pastes per minute from a single IP (default: 5)

  --capacity SIZE   Set the maximum size of the paste directory (default: 100MiB)

```

Gestetner has built-in rate limiting, a paste size limiter, and will remove the oldest pastes in order to keep its disk

usage below the value you supply for `capacity`.

## Installation

```

$ git clone [email protected]:bradfier/gestetner.git

$ cargo build --release

$ sudo cp target/release/gestetner /usr/local/bin/

$ gestetner -l 127.0.0.1:9999 -w 127.0.0.1:8080 -p /tmp -u http://localhost:8080

```

Alternatively, install from Crates.io with `cargo install gestetner` or use the provided `Dockerfile` to build an image instead.

## License

`gestetner` is licensed under the GNU Affero General Public License, Version 3.

See [LICENSE](LICENSE) for more information.