ProxMate zet een Proxmox-cluster om in een multi-gebruikers privénetwerk

Proxmox VE blijft zich steeds sterker positioneren als virtualisatieplatform, maar het delen van een cluster tussen ontwikkelaars, afdelingen, studenten of kleine teams brengt een uitdaging met zich mee: toegang geven tot het beheerpanel van Proxmox verleent vaak veel meer inzage en beheermogelijkheden dan nodig is. ProxMate biedt hiervoor een oplossing door een self-hosted webportal te plaatsen bovenop het cluster, waar elke gebruiker slechts zijn eigen virtuele machines en containers kan beheren, met quotas, console, back-ups en isolatie tussen gebruikers.

De kernpunten van ProxMate in 20 seconden

  • ProxMate voegt een multi-gebruikersportal toe aan een bestaand Proxmox VE cluster.
  • Elke gebruiker krijgt quotas voor CPU, RAM en opslag, en beheert eigen VM’s en LXC-containers.
  • Inclusief webconsole, snapshots, backups, monitoring, migratie en firewallregels.
  • Het is self-hosted en de Community Edition gebruikt de AGPLv3-licentie.
  • Installatie kan via Docker of met een speciaal runbook voor Claude Code.

Het concept doet denken aan diensten zoals DigitalOcean: de beheerder behoudt de controle over de infrastructuur, terwijl gebruikers een eenvoudigere interface krijgen om resources te gebruiken. Het project definieert ProxMate als een DigitalOcean-achtige WebUI gebouwd boven een bestaande Proxmox-omgeving.

Hierdoor positioneert ProxMate zich tussen het traditionele beheerpaneel van het hypervisor en een volledige cloud-platformoplossing. Het vervangt Proxmox VE niet en is geen ander hypervisor. Het maakt gebruik van de API en maakt de resources toegankelijk als een beheerde dienst voor meerdere gebruikers.

ProxMate is open source en is te vinden op de officiële GitHub-repository.

Van Proxmox naar een kleine privécloud

Een van de centrale functies is het uitnodigingssysteem.

De beheerder kan toegang verstrekken met limieten voor CPU, geheugen en opslag. Eenmaal binnen kan de gebruiker eigen VM’s en LXC-containers aanmaken, zonder volledige beheerdersrechten op het Proxmox-dashboard.

De virtuele machines kunnen uitgerold worden via ISO-images, templates of cloud-images. Het project bevat momenteel 20 vooraf klaargemaakte images: 16 voor x86-64 en 4 voor ARM64, volgens de documentatie. Tijdens deployment kan ook een SSH-sleutel worden meegegeven voor directe toegang.

Verschillende standaard operaties worden ondersteund:

  • Aan- en uitzetten, herstarten;
  • Resizing en reconstrueren;
  • Snapshots en geautomatiseerde backups;
  • Labeling en bulk-operaties;
  • In- en uitschakelplanning;
  • Migratie tussen nodes;
  • Grafische console via noVNC en tekstconsole;
  • GPU pass-through en PCI-apparaten via requests;
  • Automatische toewijzing van VM’s over beschikbare nodes.

Daarnaast bestaat de optie om een VM te delen met andere gebruikers, met drie permissieniveaus: Viewer, Operator en Manager. Geen van deze kan VM’s verwijderen, migreren of opnieuw delen.

Dit is vooral relevant voor geavanceerde homelabs, onderwijsinstellingen, kleine interne infrastructuurproviders, ontwikkelteams en onderwijscentra die Proxmox gebruiken maar niet elke gebruiker volledige admin-toegang willen geven.

ProxMate is ook beschikbaar in EDU- en Pro/business-edities. Brando Jewell, de ontwikkelaar, zoekt momenteel early adopters van Proxmox om deze versies te testen vóór de officiële lancering. De Community Edition blijft volgens plan gratis en open source.

Installatie van ProxMate

Voor Linux-systemen biedt het project een installatieprogramma. De aanpak vermijdt bewust de gebruikelijke curl | sudo bash-methode, en volgt een meer gecontroleerde procedure:

Eerst wordt het installatiebestand gedownload:

curl -fsSLo install.sh https://raw.githubusercontent.com/r0073d-l053r/ProxMate/main/install.sh

Vervolgens wordt het bestand bekeken:

less install.sh

En pas daarna wordt het script uitgevoerd:

bash install.sh

Deze aanpak is niet enkel cosmetisch; het beveiligt tegen het onbedoeld uitvoeren van potentieel riskante scripts. Het installatieproces controleert afhankelijkheden zoals Docker, Docker Compose v2, Git, curl en OpenSSL, genereert een ENCRYPTION_KEY, zet de configuratie op en bouwt de containers.

De Proxmox API-token wordt daarna via de webwizard ingevoerd, waardoor het niet per ongeluk in de shellgeschiedenis belandt.

Voor de installatie worden ongeveer 4 GB RAM en 5 GB opslag aanbevolen. Het ondersteunt Debian, Ubuntu, Fedora, RHEL, CentOS, Rocky Linux, openSUSE, Alpine Linux en heeft een speciale procedure voor Arch Linux.

Er is ook een bijzondere optie voor 2026: de repository bevat DEPLOY_WITH_CLAUDE.md, een runbook dat door een planagent kan worden gevolgd. Het kan aan Claude Code worden gegeven om het installatieproces uit te voeren, met ingebouwde controlestappen.

Veiligheid in een multi-gebruikersportal

De effectiviteit van ProxMate hangt sterk af van dat extra beveiligingslaag, zodat die niet eenvoudig tot een toegangspunt wordt voor het hele cluster.

De architectuur houdt de Proxmox-credentials op de server. De token wordt niet rechtstreeks naar de browser gestuurd; API-operaties verlopen via het geïntegreerde backend van ProxMate.

De beveiliging wordt verder versterkt met TOTP voor twee-factor authenticatie, passkeys via WebAuthn, en de mogelijkheid om externe identity providers via OpenID Connect te gebruiken. Sessies gebruiken httpOnly cookies en SameSite=Lax. Daarnaast zijn beveiligingen tegen CSRF ingebouwd voor muterende verzoeken.

Een belangrijke aandachtspunten voor beheerders is echter het netwerkafzonderingsbeleid:

Het gebruikersisolatie hangt mede af van correcte firewallconfiguratie op het Proxmox-cluster.

ProxMate stelt firewallregels in voor VM-interfaces en voorkomt dat VM’s toegang krijgen tot de privé-netwerken (RFC1918) van de infrastructuur en andere VM’s. Het project wijst er expliciet op dat deze VM-regels geen volledige isolatie bieden als de clusterfirewall niet actueel is of uitgeschakeld.

Voor strengere scheiding raadt men aan om bruggen of VLANs te gebruiken, of de SDN-mogelijkheden van Proxmox in te zetten.

Ook de token die voor de verbinding met Proxmox wordt gebruikt, verdient zorgvuldige aandacht.

Hoewel tijdens tests het verleidelijk kan zijn om root@pam-accounts te gebruiken, beveelt de documentatie aan voor specifieke gebruikers en rollen te zorgen met de minimale toegangsrechten. Sommige operaties, zoals firewall-aanpassingen op datacenter-niveau, kunnen hogere privileges vereisen en moeten apart worden geëvalueerd.

ProxMate versleutelt geheime gegevens zoals de Proxmox-token en SMTP/SAML-inloggegevens met AES-256-GCM via ENCRYPTION_KEY. Die sleutel dient stabiel te blijven en extern te worden bewaard, omdat verlies van zowel server als sleutel onherstelbare schade kan veroorzaken aan de beveiligde gegevens.

Meer dan slechts een mooi dashboard voor Proxmox

Het project ontwikkelt ook functionaliteiten die verder gaan dan basis provisioning.

ProxMate IDE, nog in beta, maakt het mogelijk om binnen een VM een ontwikkelomgeving te draaien gebaseerd op VS Code of code-server, gecombineerd met OpenCode voor implementatietaken. De beheerder bepaalt welke modellen beschikbaar zijn, terwijl de omgeving binnen de toewijdende VM blijft.

Daarnaast wordt realtime monitoring, audit logging, metrics voor Prometheus, node-maintenance onderpings (drainage), en een geheugenbalancer (vergelijkbaar met DRS) ondersteund.

Het systeem MateStates zorgt voor geautomatiseerde backups, VM-specifieke policies, retentie en herstel. Ook maakt ProxMate nachtelijke backups van de eigen database.

Het project bevat daarnaast meer dan 700 backend-tests voor kritische gebieden zoals quotas, permissies, firewallregels, VMplaatsing, back-ups, migraties, cloud-init en bescherming tegen SSRF-aanvallen. Voor continue integratie worden ook frontend-tests met Playwright, Docker image-building, CodeQL-analyse, Trivy en SBOM-generatie gebruikt.

Deze uitgebreide functionaliteiten maken ProxMate interessanter dan enkel een alternatieve dashboard-oplossing.

Het ecosysteem rondom Proxmox ontwikkelt zich daarnaast verder, bijvoorbeeld met datacenter management tools zoals Datacenter Manager. ProxMate stelt een ander probleem: deels van die infrastructuur direct delen met eindgebruikers, zonder hen volledige toegang tot de hypervisor te geven.

Dat is waarschijnlijk het grootste voordeel: een bedrijf kan bijvoorbeeld 8 vCPU, 16 GB RAM en 200 GB opslag toewijzen aan een ontwikkelaar; een universiteitslab kan capaciteit verdelen onder studenten; of een homelab-beheerder kan familie en collega’s laten servers maken zonder uitgebreide kennis van het volledige Proxmox-paneel.

Het vervangt geen volledige cloud-platforms zoals AWS, Azure of OpenStack, noch neemt het het werk van beheerders weg op het gebied van netwerk, storage, security, high availability of capaciteit. Het biedt een zelfbedieningslaag die dichterbij komt bij de ervaring van een kleine private cloud, met Proxmox als onderlaag en volledige controle voor de eigenaar.

Dit sluit goed aan bij de toenemende interesse van organisaties in Proxmox voor workloads die voorheen op andere virtualisatieplatforms liepen.

Veelgestelde vragen

Wat is ProxMate?

ProxMate is een self-hosted webportal dat wordt geïnstalleerd bovenop een bestaand Proxmox VE cluster. Het maakt het mogelijk om VM’s en containers toe te wijzen aan verschillende gebruikers, met quotas en rechten, zonder dat zij volledige beheerdersrechten krijgen.

Vervangt ProxMate Proxmox VE?

Nee. Proxmox blijft de machines, netwerken en opslag beheren. ProxMate gebruikt de API van Proxmox en voegt een extra laag toe voor gebruiksgemak en zelfbeheer.

Is ProxMate gratis en open source?

De Community Edition is vrijgegeven onder de GNU Affero General Public License v3.0 (AGPLv3). Het project werkt volgens een open core-model en biedt ook EDU- en commerciële versies met aanvullende functionaliteiten.

Is het veilig om ProxMate bloot te stellen aan internet?

Het bevat diverse beveiligingsmaatregelen, maar een publieke installatie vereist aanvullende configuraties: gebruik van HTTPS, minimale permissies voor tokens, firewallinstellingen, two-factor authenticatie of SSO en het voorkomen van directe blootstelling van de beheerinterface. Raadpleeg hiervoor de documentatie voor best practices.

Scroll naar boven