Résoudre le problème du port 8006 utilisé sur Proxmox : guide pas-à-pas

Si tu as déjà galéré à accéder à l’interface web de Proxmox à cause d’une erreur du style PR_CONNECT_RESET_ERROR ou si ton service pveproxy refuse de démarrer avec un message d’erreur tel que :

failed to start pveproxy.service - unable to create socket - address already in use

ce tuto est fait pour toi !

On va voir ensemble comment identifier et libérer le port 8006, souvent squatté par un autre processus, ce qui empêche Proxmox de fonctionner correctement.


Symptômes courants


Étape 1 : Identifier quel processus utilise le port 8006

Ouvre une console root sur ta machine Proxmox et tape :

ss -tulpn | grep 8006

Cette commande liste tous les processus qui écoutent sur le port 8006 (le port par défaut de l’interface web Proxmox).

Si tu obtiens une ligne du style :

tcp   LISTEN 0      4096    :8006    *:*  users:(("beszel-agent",pid=737,fd=3))

alors le coupable est un processus appelé beszel-agent (ou un autre selon ton cas).


Étape 2 : Tuer le processus qui squatte le port

Pour libérer le port, il faut tuer le processus qui l’utilise. Tape :

kill -9 737

Remplace 737 par le PID exact que tu as trouvé.

Si la commande retourne no such process, c’est que le process est déjà mort, tu peux passer à l’étape suivante.


Étape 3 : Désactiver le service lié au processus (si c'est un service systemd)

Pour éviter que le processus revienne au prochain démarrage :

  1. Identifie le service avec :

    systemctl list-units | grep beszel
    
  2. Arrête-le :

    systemctl stop beszel-agent.service
    
  3. Désactive son démarrage automatique :

    systemctl disable beszel-agent.service
    
  4. Vérifie son statut :

    systemctl status beszel-agent.service
    

Tu devrais voir quelque chose comme inactive (dead).


Étape 4 : Vérifier que le port est libéré

Repasse la commande pour voir si le port 8006 est libre :

ss -tulpn | grep 8006

Si rien ne s’affiche, tu es bon ! Le port est libre.


Étape 5 : Relancer le service Proxmox

Relance le service pveproxy qui gère l’interface web :

systemctl start pveproxy

Vérifie qu’il tourne sans erreur :

systemctl status pveproxy

Tu dois voir Active: active (running).


Étape 6 : Tester l’accès à l’interface web

Depuis ton navigateur, connecte-toi à l’adresse :

https://<IP-DE-TON-PROXMOX>:8006

Tu devrais enfin accéder à ta interface Proxmox en toute tranquillité.


Bonus : Nettoyer les tâches cron (si besoin)

Certains agents ou services installent des tâches planifiées (cron jobs) qui peuvent relancer automatiquement des processus. Pour vérifier :

Si tu trouves un script lié à l’agent, tu peux le supprimer ou le désactiver.


Conclusion

Cette méthode simple de diagnostic et résolution t’évite de tourner en rond quand un processus tiers squatte le port 8006 sur Proxmox, empêchant l’accès à l’interface web.

N’hésite pas à partager ce tuto autour de toi, ça peut sauver pas mal de monde de la galère !

Cabane en bois cosy