You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
pikvm/docs/port_forwarding.md

28 lines
1.5 KiB
Markdown

3 years ago
# Port forwarding
9 months ago
If you need to make PiKVM accessible from Internet,
9 months ago
the easiest way to achieve this is by forwarding a port on the router.
10 months ago
In this case, an external (global) IP address must be assigned to the router.
This service is provided by the ISP.
3 years ago
10 months ago
!!! tip
10 months ago
If using an external IP address is not possible, it is recommended to try
the [Tailscale VPN](tailscale.md).
3 years ago
10 months ago
* To configure port forwarding, refer to the documentation of the router.
9 months ago
* The Web UI listening ports are `80` (HTTP) and `443` (HTTPS).
* By default, port `80` performs permanent forwarding to `443` for security reasons.
* Forwarding the port `443` is sufficient in most cases.
* If enabled, the [VNC](vnc.md) server runs on port `5900` (disabled by default).
3 years ago
10 months ago
!!! warning
10 months ago
* **[Set strong passwords and enable two-factor authorization](auth.md)
before opening access to PiKVM from the Internet!**
* It is strongly recommended to obtain a valid HTTPS certificate, for example via [Let's Encrypt](letsencrypt.md).
9 months ago
* A good practice is using a custom port number instead of `443` from the Internet side, for example `14438`, to avoid common port scanners.
9 months ago
* If you still decide to use the `443` port number, you may want to forward port `80` to get a convenient redirect.
10 months ago
9 months ago
Port forwarding is a powerful and convenient tool, but remember that security depends entirely on your configuration.
In most cases, a VPN is a more secure, but less convenient option (since it requires a VPN client on all devices that access PiKVM).