use shblg to generate a static site from this repo

1 files changed, 94 insertions, 0 deletions

diff --git a/entries/ssh_forwarding.html b/entries/ssh_forwarding.html
new file mode 100755
index 0000000..d068f54
--- /dev/null
+++ b/entries/ssh_forwarding.html
@@ -0,0 +1,94 @@
+#!./entries.sh
+
+# Permanent SSH Forwarding (Tutorial)
+
+Take this situation: you have a cheap (or even free), low-powered remote server and a considerably better homeserver with more storage and power. For certain services that require more power, you'd obviously want to run them on that homeserver. 
+
+However, what if you don't want to, *or can't*, directly open ports onto your home network, or you if you simply want to keep all of your site to one IP? This is where SSH port forwarding comes in handy: using ssh to forward the open port from a service from your local server to the remote one, where it can be exposed to the rest of the internet. 
+
+## SSH Remote Port Forwarding
+
+SSH remote port forwarding is built right into ssh itself, and is quite simple:
+
+```
+ssh -R 5505:localhost:4404 user@remote.host
+```
+
+When this command is run on the local server, it will:
++ create an ssh connection to the remote server, as per usual
++ open the port 5505 on the remote server, 
++ all traffic on this port will be forwarded to port 4404 on the local server. 
+
+This command by itself is already everything you'd need to forward most ports easily to your remote server, of course, remember to open the port on your remote server's firewall, if applicable.
+
+However to ensure that that port is exposed properly on the remote server, you'd want to make sure that it is listening to all external traffic. 
+
+You can fix this by setting `GatewayPorts yes` in `/etc/ssh/sshd_config` on the remote server. (don't forget to restart sshd after editing the config)
+
+## Persistent ssh forwarding
+
+The above is all well and good, but you'd need to keep an interactive ssh connection up at all times, so the above isn't the most ideal solution. 
+
+To get around this, you can create a service to run on the local server to forward requested ports from the remote server.
+
+To begin, I'd recommend creating two users, one on each server. For sake of example, lets all them `bridge`. I'd recommend to avoid giving these users passwords, that way they can only be accessed through key based authentication. Of course you will still be able to log into them as root using `su - bridge`
+
+Next you should create an ssh keypair on the local server (`ssh-keygen`) and place the contents of your public key into `.ssh/authorized_keys` on the remote. This will make sure only the local server can ssh into the remote using that key.
+
+Then, create a script for your ssh port forwarding. I placed mine directly in the home folder on my local server, though it only matters that the bridge user can execute it. In your script you *must* use the `-nT` flag on your ssh command. These will allow you to run this script as a service, by preventing a virtual terminal being allocated. (read `man ssh` for more info)
+
+Here is my example of a script that you could use:
+
+	#!/bin/sh
+
+	PORTS="8080 25565"
+	DEST="bridge@remote.host"
+	SSH_PORT="22"
+	IDENTITY_FILE="~/.ssh"
+
+	/usr/bin/ssh -nNT $(echo $PORTS | awk -v host=$LOCALHOST '{for (i = 1; i <= NF; i++){ printf "-R %d:%s:%d ",$i,host,$i}}') -p $SSH_PORT -i $IDENTITY_FILE $DEST
+
+Next you'd want to run this script as a service. Check your distro's service system how to do this if you have any trouble.
+
+### Systemd service
+
+Say that the script you made was `/home/bridge/tunnel.sh`, you should create a user service with systemd for the bridge user.
+
+To do this create the following file in `/home/bridge/.config/systemd/user/tunnel.service`:
+
+	[Unit]
+	Description=SSH tunnel
+
+	[Service]
+	ExecStart=/home/bridge/tunnel.sh
+	RestartSec=5
+	Restart=always
+	KillMode=mixed
+
+	[Install]
+	WantedBy=default.target
+
+Then enable and start the service with: `systemd --user enable tunnel.service` and `system --user start tunnel.service`. Ensure that it is running with `systemd --user status tunnel`
+
+## Forwarding ports smaller than 1024
+
+As you may know, TCP/IP port numbers below 1024 are special in that normal users are not able to open, and hence forward from on the remote server.
+
+One solution to this is run a server on the remote that will proxy requests from port 80 to a different port (say port 8080).
+
+This can be achieved using `socat`.
+
+Say you forwarded traffic from port 8080 on remote to port 80 on local, you could then, on the remote server, run `sudo socat TCP-LISTEN:80,fork TCP:localhost:8080` to listen to traffic on port 80 and forward it to 8080, which will forward back to the local server.
+
+Here is an example of this in practice, forwarding port 80 and 443, by forwarding ports 8080 and 8443:
+
+	/usr/bin/ssh -nT -R 8443:localhost:443 -R 8080:localhost:80 -i $IDENTITY_FILE -p $SSH_PORT $DEST "(sudo socat TCP-LISTEN:80,fork TCP:localhost:8080) & sudo socat TCP-LISTEN:443,fork TCP:localhost:8443"
+
+However this command assumes that the remote user has access to sudo with **NO PASSWORD**. Alternatively you could create a similar service (this time as a system service) on the remote server running the socat commands.
+
+## Video Tutorial
+
+Here is an example of how you can use this to host a webserver (or any other service) from anywhere: even a hotel room. 
+
+<iframe width="560" height="315" src="https://www.youtube.com/embed/jqVAOZmbuhw" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+Credit: DenshiVideo