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
1 year ago
If the PiKVM located on a local network needs to be made accessible from the Internet,
the easiest way to achieve this is a port forwarding on the router.
In this case, an external (global) IP address must be assigned to the router.
This service is provided by the ISP.
3 years ago
1 year ago
!!! tip
1 year ago
If using an external IP address is not possible, it is recommended to try
the [Tailscale VPN](tailscale.md).
3 years ago
1 year ago
* To configure port forwarding, refer to the documentation of the router.
* The Web UI listening ports `80` (HTTP) and `443` (HTTPS).
* By default port `80` performs permanent forwarding to `443` for security reasons.
* Forwarding the port `443` is sufficient.
* The [VNC](vnc.md) server runs on port `5900` (disabled by default).
3 years ago
1 year ago
!!! warning
1 year 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).
* A good practice is using a custom port number instead of `443` from the Internet side, for example `14438` to avoid common port scanners.
1 year ago
* If you still decide to use the `443` port number, you may have to forward port `80` to get a redirect for your convenience.
1 year ago
Remember that port forwarding is a powerful and convenient tool, but security depends entirely on the user.
In some cases, a VPN may be a more secure, but less convenient option (since it requires a VPN client on all devices that access PiKVM).