readme_en.md

中文 • English

stab

This is a modern, simple, lightweight, and high-performance TCP tunnel tool for easily exposing local ports to remote servers.

Main features:

• humanized
• ultra high performance
• heartbeat detection
• traffic statistics
• Allow manual disconnection
• Allow exposure of multiple local ports

The following figure shows the performance comparison between stab and bore:

The environment is wsl ubuntu 24.04, and the pressure test command is:

 ab -n 100000 -c 5000 http://127.0.0.1:2000/

1.Installation

If you have the Rust development environment installed, the easiest way is to use the cargo command:

cargo install stab

If you don't have cargo, you can directly download the precompiled program from the release page and use it.

2.Server

You can run the following command on your server:

stab server

This will start stab in server mode, with the default control port being 5746, but you can modify it:

stab server -c 7777

Once successfully running, you will see output similar to the following:

09:39:49 [INFO] src\server.rs:39 => server listening 0.0.0.0:5746
09:39:49 [INFO] src\web\mod.rs:31 => web server:http://localhost:3000

Here, 0.0.0.0:5656 represents the control port, and http://localhost:3400 represents the web service. You can open this link to view information about all clients currently connected to this server, and you can manually disconnect these links if needed:

3.Local

Then you can run the following command locally:

stab local -l 8000=server.com

The above command is a shorthand form, and the full format is:

stab local --link 127.0.0.1:8000=server.com:0

This command links your local 127.0.0.1:8000 port with server.com:0, which is the default behavior, and the port will be automatically allocated by the server.

Of course, you can also specify the port that needs to be exposed on the server:

stab local --link 127.0.0.1:8000=server.com:7878

If your server has changed the default control port, you should also change it here:

stab local -c 7777 --link 8000=server.com

4.Example

Let's say you start stab server mode in server.com:

stab server

And you start a web server on local port 8000, after which you can connect to the server via stab to expose the local web service:

stab local -l 8000=server.com

When you successfully connect to the server, you will get log output similar to the following:

09:46:42 [INFO] src\client.rs:72 => listening at server.com:1024

At this point, you will be able to access your local web service via server.com:1024.

5.Secret

To prevent abuse by others, you can add a key:

stab server -s test

At this point the client will have to fill in the key to connect to the server:

stab local -l 8000=your.server.com -s test

6.Toml Configuration (Recommended)

In addition to using command line parameters, you can configure all options via a toml configuration file.

Server configuration file example server.toml:

mode = "Server" # Select server mode
port = 5959 # Set control port
secret = "test secret" # Set secret key
log = 5 # Set log level: 1-5, default is 5
log_path = "logs"      # Set the log saving location. The default is the logs directory under the current directory

[server]
web_port = 80 # Set web port
port_range = "2000-3000" # Set the range of ports allowed to use
pool_size = 8            # Set the connection pool size, default to 8 

Apply this configuration file:

stab -f server.toml

Local configuration file example local.toml:

mode = "Local"         # Select local mode
port = 5959            # Set control port
secret = "test secret" # Set secret key
log = 5                # Set log level: 1-5, default is 5
log_path = "logs"      # Set the log saving location. The default is the logs directory under the current directory

[local]
to = "server.com"       # Set the default server
links = [
    "127.0.0.1:8080=server.com:2000",  # Complete writing method
    "8080=server.com:1900",            # Equivalent to: 127.0.0.1:8080=server.com:1900
    "8081=server.com",                 # Equivalent to: 127.0.0.1:8081=server.com:0
    "8082=2001",                       # Equivalent to: 127.0.0.1:8082={to}:2001
    "8083",                            # Equivalent to: 127.0.0.1:8083={to}:0
] # Set the links to be established with the server, supporting multiple links simultaneously

Apply this configuration file:

stab -f local.toml