For a handful of reasons, I run a Windows PC at home in headless mode. I run TightVNC on it so that I can access it graphically. I use Screens on my iPad, or macOS Screen Sharing.app to access the PC.
I only use this PC when I'm at home, so at first glance I don't really need an internet-based remote access solution. However, sometimes the client I'm connecting from is connected to a VPN. For example, I frequently am using my work computer, connected to the corporate VPN, when I need/want to do something on my PC.
Since the VPNs in question don't split-tunnel, I must drop the connection. Then connect to the PC directly via my LAN. Then do the thing. Then re-connect to the VPN.
So, after a few weeks of doing that, I became sick of it. To make my VNC accessible from the web, I decided to spin up an instance of noVNC on my k8s cluster.
About the K8s Cluster #
The cluster is nothing special. In fact, it's not even a cluster... it's just a single VM running MicroK8s. My VM is running on a 2.3Ghz Xeon Proxmox host, with 2 vCPUs and 5Gi RAM.
About noVNC #
noVNC is a project that you may have encountered embedded in other projects. For example, Proxmox VE uses noVNC to show VM consoles. It uses WebSockets and Canvas to make an HTML5 VNC viewer.
There's a standalone version, i.e. one that does not need to be integrated into other software. We can run a containerized noVNC instance that connects to the VNC server running on our Windows PC.
Some people also use noVNC to access graphical applications running in containers. To be clear, that's not what's happening here. The system we are accessing is not a Docker container, but a hardware PC.
Installing noVNC in Kubernetes #
Prepare the namespace
Give your novnc deployment its own namespace to live in.
Configure the deployment
Configure novnc container to run as a deployment on the K8s cluster.
- image: jhankins/docker-novnc:latest
- name: novnc
Expose the service
Exposing the service allows you to access the service from outside the cluster.
Note that I'm using Traefik
IngressRouteresources to manage the ingress for the service. I'll explain my Traefik setup in a later post, but note that you'll need a LoadBalancer active to use the service as-is. I recommend MetalLB if you're running at home.
- protocol: TCP
- match: Host(`your-hostname.here`)
- name: novnc
Next Steps #
We've accomplished what we set out to do— provide a web-based VNC viewer for a PC on our LAN.
Clearly, there are better things to be done here when it comes to securing the application and making the Kubernetes resources more templated (e.g. use environment variables for the
$VNC_HOST, etc.). I also plan on trying geek1011/easy-novnc since it has some additional features that would make this setup even better.
Headless mode generally means the system doesn't have a monitor connected. ↩︎