PORT=0 : l'astuce qui élimine les conflits de ports en développement

Depuis quelques semaines, un outil au nom minimaliste, Port Zero, circule dans les cercles de développeurs confrontés à un problème vieux comme le port 3000 : les conflits de ports en environnement local. Son principe tient en une ligne : réglez le port de votre serveur sur 0, et laissez l'outil attribuer un domaine stable à chaque process. Fini les EADDRINUSE, fini les tableaux de correspondance « 3000 pour l'API, 5173 pour le front, 5432 pour Postgres ».

On revient sur le mécanisme, sur ce qu'il change concrètement pour un développeur ou une équipe technique, et sur les limites à connaître avant de l'adopter en production de dev.

Le problème que tout développeur connaît

Un serveur de dev qui refuse de démarrer parce que le port est déjà pris, un second projet qui doit être lancé sur un port différent au prix d'une variable d'environnement à retenir, un test end-to-end qui échoue en CI parce que deux jobs parallèles ont choisi le même port par hasard : ce sont des frictions minuscules, mais elles s'accumulent. Avec la généralisation des git worktrees et des agents de codage IA qui lancent chacun leur propre serveur de développement, le nombre de process à faire cohabiter sur une seule machine a explosé. Le port devient une ressource rare qu'il faut gérer manuellement, alors qu'il ne devrait jamais avoir à l'être.

Comment fonctionne PORT=0 avec Port Zero

Le principe du port 0 n'est pas nouveau : demander au système d'exploitation un port éphémère libre plutôt qu'un numéro fixe est une pratique connue en réseau. Ce que Port Zero ajoute, c'est une couche qui transforme ce port éphémère et invisible en un domaine lisible et stable :

PZ_TUNNEL="web.myapp-feat-checkout-redesign.portzero.local" node app.ts

Le process démarre sur un port choisi automatiquement par le système, et Port Zero expose l'application sur l'URL web.myapp-feat-checkout-redesign.portzero.local. Ce domaine ne bouge plus : vous pouvez le mettre en favori, le partager avec un collègue sur le même réseau, ou le configurer dans vos scripts de test, sans jamais avoir à vérifier quel numéro de port a été attribué en coulisses.

L'outil est agnostique au langage : les exemples fournis couvrent C#, Node.js, TypeScript, Python, Rust et Docker, sans logique spécifique à un framework.

Une URL par branche, même en local

Le cas d'usage le plus parlant concerne les git worktrees. Si vous travaillez sur plusieurs branches en parallèle, chacune dans son propre worktree, chaque dev server obtient un domaine explicite qui porte le nom de la branche :

PZ_TUNNEL="web.myapp-feat-checkout-redesign.portzero.local" node app.ts
PZ_TUNNEL="web.myapp-feat-dark-mode.portzero.local" node app.ts

Les deux serveurs tournent en même temps, sur des ports attribués dynamiquement, sans collision et sans avoir à s'en soucier. C'est particulièrement pertinent pour les équipes qui font tourner plusieurs agents de codage IA en parallèle : chaque agent travaille dans son propre worktree, lance son propre serveur, et Port Zero annonce un serveur MCP dédié pour exposer l'état des tunnels et services comme des outils que l'agent peut appeler directement, ainsi qu'un skill capable d'extraire une topologie de production à partir d'un fichier compose.

Sortir de la machine : tunnels cloud et tests mobiles

Les domaines en *.portzero.local s'arrêtent à la machine locale. Pour tester une application sur un vrai téléphone, la partager avec un client ou recevoir un webhook externe, Port Zero propose des tunnels cloud qui exposent le même serveur local en HTTPS public, avec un domaine dédié par worktree si besoin :

PZ_TUNNEL="nodejs-typescript-process.acme.tunnel.portzero.cloud:80" node app.ts

Cette partie du produit est payante. La partie locale (tunnels *.portzero.local) reste gratuite et open source sous licence GNU GPL v3.0, sans compte requis. Les tunnels cloud démarrent avec l'offre Professional à 49 dollars par mois (ou 490 dollars par an), qui ajoute l'authentification des visiteurs, les commentaires de feedback sur les tunnels et une bande passante généreuse en fair use. L'offre Team, à 149 dollars par mois (ou 1490 dollars par an), ajoute la gestion d'équipe sans facturation par siège, les politiques d'accès et l'approbation des tunnels cloud. Une offre Enterprise avec journal d'audit est disponible sur devis.

Comment l'installer

Sur macOS, via Homebrew :

brew tap PortZeroNetwork/portzero && brew install portzero

Sur Linux, via le script d'installation officiel :

curl -fsSL https://portzero.net/install.sh | sh

Sur Windows, un installeur .msi est fourni directement sur le site officiel. Dans les trois cas, il ne reste plus qu'à régler le port de votre serveur habituel sur 0 et à définir la variable PZ_TUNNEL pour obtenir votre premier domaine stable.

Ce que ça change pour une équipe dev en France

Pour une PME ou une agence qui fait tourner plusieurs projets clients sur les mêmes postes de développement, le gain n'est pas spectaculaire mais il est réel : moins de temps perdu à déboguer un port déjà occupé, moins de configuration à documenter pour un nouvel arrivant, et une démonstration client sur mobile qui ne nécessite plus de déployer quoi que ce soit. Pour les équipes qui commencent à intégrer des agents de codage IA dans leur workflow, la promesse d'une URL stable par worktree, gérable via MCP, répond directement à un problème concret : plusieurs agents qui tournent en parallèle sur la même machine sans se marcher dessus.

Le tout reste à valider dans la durée : Port Zero est un outil jeune, et faire dépendre son workflow de dev d'un domaine externe (même local) mérite un test avant adoption large, en particulier sur des environnements CI où l'installation d'un binaire supplémentaire a un coût de maintenance.

Notre lecture chez CZSyn

Chez CZSyn, nous gérons au quotidien plusieurs stacks clients sur les mêmes machines, et la gestion manuelle des ports reste une source d'erreurs bête mais récurrente, surtout en période de forte charge sur plusieurs projets en parallèle. L'idée de Port Zero, transformer un détail réseau en confort de développement, s'inscrit dans une tendance plus large : l'outillage dev converge vers moins de configuration explicite et plus d'automatisation intelligente, du côté des ports comme du côté des agents IA qui pilotent de plus en plus ces environnements.

La partie locale gratuite suffit largement pour la majorité des équipes qui veulent simplement en finir avec les conflits de ports au quotidien. Les tunnels cloud deviennent intéressants dès que la démonstration client ou le test mobile fait partie du rythme de livraison. Dans les deux cas, l'adoption reste peu coûteuse à tester : un binaire à installer, une variable d'environnement à régler sur 0, et le reste suit.

Sources primaires

• Port Zero, page officielle du produit, portzero.net.
• Port Zero, script d'installation officiel Linux, portzero.net/install.sh.