Securing a cloud VPS.
For the most part, nothing special needs to be done to run Eth Docker on a VPS. However, budget VPS providers do not filter the traffic that can reach the machine: This is definitely not desirable for unsecured ports like Grafana or execution client, if the shared option is being used. All that should be reachable are the P2P ports.
The arguably best way to secure Grafana, Web UI and execution client ports is via encryption. For this, please see the secure proxy instructions.
If you prefer to keep the ports unencrypted and wish to secure them via ufw, please read on.
Securing Grafana and execution client via ufw
While Docker automatically opens the Linux firewall for ports it "maps" to the host, it also
allows rules to be placed in front of that, via the DOCKER-USER
chain.
The following idea uses that chain and integrates ufw with it, so that simple ufw rules can be used to secure Grafana.
1) Edit after.rules:
sudo nano /etc/ufw/after.rules
and add to the end of the file, after the existing COMMIT
:
*filter
:ufw-user-input - [0:0]
:DOCKER-USER - [0:0]
# ufw in front of docker while allowing all inter-container traffic
-A DOCKER-USER -j RETURN -s 10.0.0.0/8
-A DOCKER-USER -j RETURN -s 172.16.0.0/12
-A DOCKER-USER -j RETURN -s 192.168.0.0/16
-A DOCKER-USER -j ufw-user-input
-A DOCKER-USER -j RETURN
COMMIT
Note this deliberately keeps ufw rules from influencing any traffic sourced from RFC1918 (private) addresses, which includes the docker containers. This may not be what you need, in which case just remove those three lines, and be sure to allow needed container traffic through explicit ufw rules, if you are blocking a port.
2) Edit before.init
sudo nano /etc/ufw/before.init
and change stop)
to read:
stop)
# typically required
iptables -F DOCKER-USER || true
iptables -A DOCKER-USER -j RETURN || true
iptables -X ufw-user-input || true
;;
Then, make it executable: sudo chmod 750 /etc/ufw/before.init
Dropping ufw-user-input
through before.init
is a required step. Without it, ufw cannot be reloaded, it would display an error message
stating "ERROR: Could not load logging rules".
3) Reload ufw
sudo ufw reload
Example: Grafana on port 3000
Reference common ufw rules and commands to help in creating ufw rules.
Say I have Grafana enabled on port 3000 and no reverse proxy. I'd like to keep it reachable via SSH tunnel while dropping all other connections.
First, verify that Grafana is running and port 3000 is open to world using something like https://www.yougetsignal.com/tools/open-ports/
Next, create ufw rules to allow access from localhost
and drop access from anywhere else:
sudo ufw allow from 127.0.0.1 to any port 3000
sudo ufw deny 3000
Check again on "yougetsignal" or the like that port 3000 is now closed.
Connect to your node with ssh tunneling, e.g. ssh -L3000:node-IP:3000 user@node-IP
and browse to http://127.0.0.1:3000
on the client
you started the SSH session from. You expect to be able to reach the Grafana dashboard.
Example: Prysm Web UI on port 7500
Reference common ufw rules and commands to help in creating ufw rules.
Say I have the Prysm Web UI enabled on port 7500 and no reverse proxy. I'd like to keep it reachable via SSH tunnel while dropping all other connections.
First, verify that Prysm Web UI is running and port 7500 is open to world using something like you get signal
Next, create ufw rules to allow access from localhost
and drop access from anywhere else:
sudo ufw allow from 127.0.0.1 to any port 7500
sudo ufw deny 7500
Check again on you get signal or the like that port 7500 is now closed.
Connect to your node with ssh tunneling, e.g. ssh -L7500:node-IP:7500 user@node-IP
and browse to http://127.0.0.1:7500
on the client
you started the SSH session from. You expect to be able to reach the Prysm Web UI.
Example: Shared or standalone execution client on port 8545
It can be useful to have a single execution client service multiple consensus clients, for example when testing, or running a solo staking docker-compose stack as well as a pool docker-compose stack.
To allow Docker traffic to the execution client while dropping all other traffic:
sudo ufw allow from 172.16.0.0/12 to any port 8545
sudo ufw allow from 192.168.0.0/16 to any port 8545
sudo ufw allow from 10.0.0.0/8 to any port 8545
sudo ufw deny 8545
sudo ufw allow from 172.16.0.0/12 to any port 8546
sudo ufw allow from 192.168.0.0/16 to any port 8546
sudo ufw allow from 10.0.0.0/8 to any port 8546
sudo ufw deny 8546
With ISP traffic caps, it could be quite attractive to run the execution client in a small VPS, and reference it from a consensus client somewhere else. This requires a secure proxy.
Acknowledgements
The ufw integration is a slightly tweaked version of https://github.com/chaifeng/ufw-docker by way of https://p1ngouin.com/posts/how-to-manage-iptables-rules-with-ufw-and-docker