portproxy

Simple port forwarding tool, built with tokio-rs 🦀

What does it do?

Pretty much the very same thing as Windows' netsh interface portproxy or Linux's iptables forward - it maps the incoming connections from listen local adress & port to remote connect address and port.

Only TCP port forwarding is supported at this time.

This tool does not currently offer anything more over the native OS tools, maybe besides the unification and ease of defining the mappings.

Install

Cargo

sh cargo install portproxy

From source

Clone the repo and compile it: sh git clone https://github.com/spitfire05/portproxy.git cd portproxy cargo install

Pre-compiled binaries

Windows binaries are avialable in the releases section of this repo.

Configuration

portproxy will try to read the config for paths in following order:

1) --config CLI arg, if set 2) Value of PORTPROXY_CONFIG env variable, if set 3) ~/.config/portproxy/toml

Config should contain one or more [[proxy]] elements, that define the port mappings:

[[proxy]] listen = "localhost:8080" # local address to listen on connect = "some-server.lan:8485" # remote (or local) address to connect to

Run

Running is as simple as it can be - just call the portproxy binary. There are optional flags/parameters:

``` Usage: portproxy [OPTIONS]

Options: -c, --config-path Path to read the config from. If not set, will fall back to value of $PORTPROXY_CONFIG, and "~/.config/portproxy.toml", in that order -l, --log-level [default: info] [possible values: error, warn, info, debug, trace] -d, --log-dir Directory to write the log files to. Logging to file will be disabled if this is not set -h, --help Print help -V, --version Print version ```

As a service/daemon

Windows

Use Shawl to create a windows service of portproxy.

shawl add --no-restart --no-log --name portproxy -- C:\full\path\to\portproxy.exe --log-level debug --log-dir C:\full\path\to\logs\directory <optional args>