traffic_forward 0.1.1

Support for Linux traffic forwarding settings via both the console and a web API.
Documentation

Traffic Forwarding

Traffic Forwarding

Read this in other languages: 中文.

Quick Start

Prerequisite: The server already has a Rust environment.

Installation:

cargo install traffic_forward

Upon successful installation, you will see the following path:

...
 Compiling clap v4.5.4
   Compiling ron v0.8.1
   Compiling traffic_forward v0.1.0
    Finished release [optimized] target(s) in 2m 17s
  Installing /home/youre_account/.cargo/bin/traffic_forward
   Installed package `traffic_forward v0.1.0` (executable `traffic_forward`)

【Non-root Account】 Add a soft link to /usr/bin

sudo ln -s /home/youre_account/.cargo/bin/traffic_forward /usr/bin/traffic_forward

View version:

traffic_forward --version
traffic_forward 0.1.0

Or:

sudo traffic_forward --version
traffic_forward 0.1.0

Usage:

  • Add forwarding:
# Use local port 5555 to forward to 192.102.11.44:8000
sudo traffic_forward add 192.102.11.44:8000 5555
  • List of existing rules:
sudo traffic_forward list
0.0.0.0:5555 -> 192.102.11.44:8000
  • Query traffic consumption for a specific IP:
sudo traffic_forward query 192.102.11.44
  • Delete forwarding rule for a specific IP:
sudo traffic_forward delete 192.102.11.44
Delete completed
  • Start the web API:
 sudo traffic_forward web

Web API Interface

Add

  • uri: iptables/add
  • method: post
  • request
{
	"target_ip": "192.168.50.50",
	"target_port": "4488",
	"local_port": "4433",
}
  • response
{
	"code": 1,
	"msg": "Success",
	"data": null
}

Delete

  • uri: iptables/del
  • method: post
  • request
{
	"target_ip": "192.168.50.50"
}
  • response
{
	"code": 1,
	"msg": "Success",
	"data": null
}

List

  • uri: iptables/list
  • method: get
  • request: empty (change next version will)
  • response
{
	"code": 1,
	"msg": "Success",
	"data": {
		"list": [
			{
				"ip": "192.168.50.50",
				"target_port": "4488",
				"local_port": "4433"
			}
		]
	}
}

If the rules are successfully written but cannot be used normally to implement traffic proxy, please ensure that Linux has enabled forwarding.