Bêta précoce (0.1.0), pas encore pour un process critique. Voir la roadmap
PNeX logo

Windows (WSL 2)

Faire tourner PNeX sur un PC Windows avec WSL 2 et Docker

PNeX tourne dans une distribution Ubuntu WSL 2, avec Docker Engine installé dans WSL par le script, ou l'intégration WSL de Docker Desktop. C'est une bonne façon d'essayer PNeX sur un PC ; pour une installation permanente, un Raspberry Pi ou un petit serveur Linux reste allumé quand le PC se met en veille.

Windows 11 22H2 ou plus récent est requis pour le réseau miroir. Sans lui, WSL est derrière un NAT et les devices de votre réseau ne peuvent pas atteindre le serveur.

1. WSL et réseau

Dans PowerShell (administrateur) :

wsl --install -d Ubuntu

Créez %UserProfile%\.wslconfig :

[wsl2]
networkingMode=mirrored

2. systemd (Docker Engine dans WSL)

Ignorez cette étape avec Docker Desktop. Dans Ubuntu, ajoutez à /etc/wsl.conf :

[boot]
systemd=true

3. Redémarrer WSL et ouvrir les ports

Dans PowerShell (administrateur) :

wsl --shutdown
Set-NetFirewallHyperVVMSetting -Name '{40E0AC32-46A5-438A-A0B2-2B479E8F2E90}' -DefaultInboundAction Allow
New-NetFirewallRule -DisplayName "PNeX HTTPS" -Direction Inbound -Protocol TCP -LocalPort 80,443 -Action Allow

4. Installer

Dans Ubuntu :

curl -fsSL https://raw.githubusercontent.com/Pnex/pnex-deploy/main/install.sh \
  | sudo bash -s -- --admin-user [email protected]

Sous WSL, l'installeur nomme le serveur d'après son adresse locale, par exemple https://pnex-192-168-1-20.sslip.io, car mDNS (.local) ne traverse pas WSL. Il prévient si WSL est encore en réseau NAT. Faites ensuite confiance à l'autorité de certification du serveur sous Windows : téléchargez https://<serveur>/api/v1/meta/ca, ouvrez pnex-ca.crt → Installer le certificat → Ordinateur local → Autorités de certification racines de confiance.

Donnez au PC une réservation DHCP : le nom contient l'adresse IP (voir Noms et TLS).

On this page