View source for Multi-tunnel

{{DISPLAYTITLE:multi-tunnel}}

multi-tunnel allows starting and managing SSH tunnels in a straightforward manner. Create a TOML configuration file, start the service and you're all set. If you change the configuration, send a SIGHUP (aka <code>systemctl reload</code>) and it'll start/stop tunnels as necessary.

Tunnels that get stopped or killed for any reason will be restarted after a 5-second delay.

== Configuration ==
For example, to tunnel httpd running on port 8080 to a remote server on 8000 and nginx running on port 8081 to 8001 on the remote server:<syntaxhighlight lang="toml">
connection = "remote.host"

[httpd]
local = 8080
remote = 8000

[nginx]
local = 8081
remote = 8001
</syntaxhighlight>The name is arbitrary and is used only for log entries.

== Monitoring ==
A Prometheus endpoint to scrape is available at <code><nowiki>http://0.0.0.0:46581/metrics</nowiki></code>.

== Download ==
x64 and armv7 downloads are [https://gitlab.com/legoktm/multi-tunnel/-/tags provided for each tagged release].

== License ==
multi-tunnel is dual licensed under the GPL v3 or later OR copyleft-next 0.3.1, see LICENSES/.

== External links ==

* [https://gitlab.com/legoktm/multi-tunnel Git repository]
* [https://crates.io/crates/multi-tunnel On crates.io]