SSH Port Forwarding:Overview - Revision history

Josh: Content added - troubleshooting guide: SSH Port Forwarding Overview (10 sections)

2026-01-01T13:44:39Z

Content added - troubleshooting guide: SSH Port Forwarding Overview (10 sections)

← Older revision		Revision as of 13:44, 1 January 2026
Line 1:		Line 1:
	~~= SSH Port Forwarding Overview =~~

	This document describes the SSH port forwarding system architecture and how it works.		This document describes the SSH port forwarding system architecture and how it works.

Line 7:		Line 5:
	=== Components ===		=== Components ===

	= '''Configuration File''': <code>/etc/ssh-port-forwards.conf</code> =		==== '''Configuration File''': <code>/etc/ssh-port-forwards.conf</code> ====
	* Defines all SSH port forwards in a simple format		* Defines all SSH port forwards in a simple format

	* One device per line		* One device per line

	= '''Management Script''': <code>/usr/local/bin/ssh-port-forward-manager.sh</code> =		== '''Management Script''': <code>/usr/local/bin/ssh-port-forward-manager.sh</code> ==
	* Adds, removes, and lists SSH port forwards		* Adds, removes, and lists SSH port forwards

Line 19:		Line 17:
	* Validates configurations		* Validates configurations

	= '''Integration''': <code>/etc/openvpn/iptables-restore.sh</code> =		== '''Integration''': <code>/etc/openvpn/iptables-restore.sh</code> ==
	* Automatically applies all port forwards when VPN starts		* Automatically applies all port forwards when VPN starts

Line 44:		Line 42:

	<pre class="lang-bash">		<pre class="lang-bash">
	= View DNAT rules =		== View DNAT rules ==
	iptables -t nat -L PREROUTING -n -v \| grep DNAT		iptables -t nat -L PREROUTING -n -v \| grep DNAT

	= View FORWARD rules =		== View FORWARD rules ==
	iptables -t filter -L FORWARD -n -v \| grep -E "10\.8\.0\."		iptables -t filter -L FORWARD -n -v \| grep -E "10\.8\.0\."
	</pre>		</pre>

Josh: Content removed - troubleshooting guide: SSH Port Forwarding Overview (5 sections)

2026-01-01T13:28:13Z

Content removed - troubleshooting guide: SSH Port Forwarding Overview (5 sections)

← Older revision		Revision as of 13:28, 1 January 2026
Line 8:		Line 8:

	= '''Configuration File''': <code>/etc/ssh-port-forwards.conf</code> =		= '''Configuration File''': <code>/etc/ssh-port-forwards.conf</code> =
	'' Defines all SSH port forwards in a simple format		* Defines all SSH port forwards in a simple format
	'' One device per line
			* One device per line

	= '''Management Script''': <code>/usr/local/bin/ssh-port-forward-manager.sh</code> =		= '''Management Script''': <code>/usr/local/bin/ssh-port-forward-manager.sh</code> =
	'' Adds, removes, and lists SSH port forwards		* Adds, removes, and lists SSH port forwards
	'' Applies iptables rules automatically
	'' Validates configurations		* Applies iptables rules automatically

			* Validates configurations

	= '''Integration''': <code>/etc/openvpn/iptables-restore.sh</code> =		= '''Integration''': <code>/etc/openvpn/iptables-restore.sh</code> =
	'' Automatically applies all port forwards when VPN starts		* Automatically applies all port forwards when VPN starts
	'' Ensures rules persist after reboots
			* Ensures rules persist after reboots

	=== How It Works ===		=== How It Works ===
Line 49:		Line 53:
	== Related Documentation ==		== Related Documentation ==

	'' [[Documentation:Configuration](Configuration\|- Configuration file format		* [[Documentation:Configuration](Configuration\|- Configuration file format
	'' [Management]])(management.md) - Managing port forwards
	'' [[Troubleshooting:Port Forwarding Troubleshooting\|Troubleshooting]] - Troubleshooting guide		* [Management]])(management.md) - Managing port forwards

			* [[Troubleshooting:Port Forwarding Troubleshooting\|Troubleshooting]] - Troubleshooting guide

	[[Category:Documentation]]		[[Category:Documentation]]
	[[Category:Documentation/SSH Port Forwarding]]		[[Category:Documentation/SSH Port Forwarding]]

Josh: Added troubleshooting guide: SSH Port Forwarding Overview

2026-01-01T13:15:54Z

Added troubleshooting guide: SSH Port Forwarding Overview

New page

= SSH Port Forwarding Overview =

This document describes the SSH port forwarding system architecture and how it works.

== Architecture ==

=== Components ===

= '''Configuration File''': <code>/etc/ssh-port-forwards.conf</code> =
'' Defines all SSH port forwards in a simple format
'' One device per line

= '''Management Script''': <code>/usr/local/bin/ssh-port-forward-manager.sh</code> =
'' Adds, removes, and lists SSH port forwards
'' Applies iptables rules automatically
'' Validates configurations

= '''Integration''': <code>/etc/openvpn/iptables-restore.sh</code> =
'' Automatically applies all port forwards when VPN starts
'' Ensures rules persist after reboots

=== How It Works ===

<pre>
External Client → VPS:EXTERNAL_PORT (e.g., 22222)
→ iptables DNAT rule
→ VPN Tunnel (tun0)
→ VPN_DEVICE:SSH_PORT (e.g., 10.8.0.2:22)
</pre>

== Current Configuration ==

To see the current configuration:

<pre class="lang-bash">
cat /etc/ssh-port-forwards.conf
</pre>

To see active iptables rules:

<pre class="lang-bash">
= View DNAT rules =
iptables -t nat -L PREROUTING -n -v | grep DNAT

= View FORWARD rules =
iptables -t filter -L FORWARD -n -v | grep -E "10\.8\.0\."
</pre>

== Related Documentation ==

'' [[Documentation:Configuration](Configuration|- Configuration file format
'' [Management]])(management.md) - Managing port forwards
'' [[Troubleshooting:Port Forwarding Troubleshooting|Troubleshooting]] - Troubleshooting guide

[[Category:Documentation]]
[[Category:Documentation/SSH Port Forwarding]]