Passer au contenu principal

Documentation Index

Fetch the complete documentation index at: https://docs.replit.com/llms.txt

Use this file to discover all available pages before exploring further.

Étant donné que Replit exécute vos projets dans un environnement cloud, les ports fonctionnent différemment sur Replit que sur votre ordinateur local. (Si vous avez besoin d’une explication plus basique sur ce que sont les ports TCP, commencez ici.) Sur un ordinateur, vous n’avez qu’une seule couche de gestion des ports : vos programmes définissent un port sur lequel ils écoutent, et lorsque du trafic arrive sur ce port depuis internet, il est acheminé vers le processus approprié.
ordinateur
La partie 0.0.0.0 est l’adresse, ou hôte. Si un processus écoute sur 0.0.0.0, cela signifie qu’il doit écouter sur chaque interface réseau — ce qui signifie que si un autre ordinateur (sur internet) envoie une requête à l’adresse IP de votre ordinateur, il la verra. Ainsi, écouter sur 0.0.0.0 signifie que ces processus sont accessibles à l’internet public (si votre ordinateur est connecté). La plupart des frameworks de programmation n’écoutent pas sur 0.0.0.0 lors du développement, car vous ne souhaitez pas nécessairement exposer votre travail au public pendant que vous y travaillez, pour des raisons de confidentialité et de sécurité. Au lieu de cela, ils écoutent sur une adresse différente — 127.0.0.1, autrement connue sous le nom de localhost. Cela signifie que seul cet ordinateur peut effectuer des requêtes sur ce port.
Les ports localhost ne sont visibles que sur l'ordinateur qui les héberge.
Sur Replit, pour qu’un processus que vous exécutez soit accessible dans la webview ou via une requête externe, il doit avoir un port externe défini. En effet, le « port interne » que les processus utilisent typiquement n’est visible que depuis l’intérieur de l’environnement cloud en bac à sable que Replit fournit. Ce port interne doit être connecté à un port accessible de l’extérieur pour envoyer le bon trafic à vos programmes. Même si votre processus écoute sur un port normalement disponible au public comme 0.0.0.0, il doit toujours être lié à un port externe.
Les ports externes redirigent le trafic vers les ports internes, sur lesquels les programmes écoutent.
Replit fait cela en liant les ports externes à des ports internes spécifiques — par exemple, dans le diagramme ci-dessus, le port externe :80 est lié au port interne :3000. Cela signifie que tout trafic que l’application Replit reçoit sur le port 80 ira au port interne 3000. Cette configuration est capturée dans la section [[ports]] du fichier de configuration .replit. Par défaut, Replit lie le premier port que vous ouvrez au port externe par défaut 80, ce qui permet à ce processus d’être disponible au domaine sans adresse de port (par exemple customdomain.com/ au lieu de customdomain.com:3000/). Les ports internes supplémentaires ouverts sont liés à d’autres ports externes disponibles (voir la liste complète ci-dessous).

​
Aperçu

Dans l’outil Aperçu, vous pouvez modifier quel port externe la webview affiche en cliquant sur le domaine et en sélectionnant un port différent. Vous pouvez également ouvrir l’outil réseau depuis l’icône « engrenage » pour plus de détails.
Cliquer sur le domaine dans la webview vous permettra de choisir quel port afficher.

​
Port par défaut

Le port :80 est le « port par défaut » pour le trafic http, donc le trafic http envoyé au domaine racine sera automatiquement acheminé vers le port 80. Le chemin du port n’est pas affiché dans l’URL pour le port 80 pour cette raison. Les ports autres que :80 apparaîtront dans le chemin du domaine (par exemple customdomain.com:4200/). (Replit fournit TLS par défaut, donc il sera techniquement sur le port 443, qui est le port par défaut pour https. À toutes fins pratiques, vous pouvez les traiter comme interchangeables.)

​
Outil réseau

Pour plus de détails sur la configuration des ports et la mise en réseau, vous pouvez ouvrir l’outil réseau. Il affiche l’état des ports ouverts dans votre application Replit, à quel port externe ils sont liés, et vous permet d’ajouter ou de supprimer une configuration.
L'outil réseau affiche votre configuration de ports.

​
Publication

Les déploiements Autoscale et Reserved VM ne prennent en charge qu’un seul port externe exposé, et le port interne correspondant ne doit pas utiliser localhost. Si vous exposez plus de ports, ou exposez un seul port sur localhost, votre application publiée échouera. Un moyen facile de s’assurer que vos déploiements Autoscale fonctionnent comme prévu est de supprimer toutes les entrées externalPort pour les ports dans votre configuration sauf le port pour le service avec lequel vous souhaitez interagir depuis internet.

​
Débogage

Une raison courante pour laquelle quelque chose pourrait ne pas fonctionner comme prévu est que, bien que votre configuration de port semble correcte, votre programme écoute en réalité sur un port différent. Par exemple, si votre configuration est : 
[[ports]]
internalPort = 3000
externalPort = 80
Alors le trafic internet vers le port 80 ira au port interne 3000. Cependant, si votre programme n’écoute pas sur le port 3000, mais sur autre chose (comme 8080), il semblera qu’aucun trafic ne passe. Cela peut se produire si vous changez le port dans votre code sans changer le port correspondant dans votre configuration, ou si vous copiez-collez une configuration d’un projet à un autre.
Les programmes peuvent changer les ports sur lesquels ils écoutent.
Chaque framework a des ports par défaut différents sur lesquels il écoute — par exemple, Flask utilise le 5000, react le 3000 et laravel le 8000. Assurez-vous que le bon port est configuré !

​
Préférences

Replit lie automatiquement les ports ouverts dans votre application Replit aux ports externes disponibles lorsqu’ils sont ouverts, et enregistre cette liaison dans le fichier de configuration .replit. Cependant, cela ne se produit pas par défaut pour les ports internes qui s’ouvrent sur localhost, car les services qui s’exécutent habituellement sur localhost supposent généralement qu’ils ne seront accessibles que sur le même ordinateur que le processus en cours d’exécution (les ports localhost ne sont visibles que pour le même ordinateur exécutant le processus). Cela signifie que ces services sont souvent moins sécurisés que les services conçus en supposant qu’ils seront disponibles sur l’internet public. Vous pouvez toujours remplacer cela en définissant l’option de configuration exposeLocalhost à true pour le port que vous souhaitez exposer. Si vous souhaitez toujours exposer les ports localhost par défaut, vous pouvez définir votre paramètre « transfert automatique de port » dans l’outil Paramètres utilisateur sur « Tous les ports ». Si vous souhaitez ne jamais créer de configuration pour les ports ouverts, et contrôler manuellement la configuration des ports pour toutes vos applications Replit, vous pouvez définir cela sur « jamais ».

​
Ports pris en charge

L’application Replit définira le port 80 comme port externe par défaut lorsque le premier port s’ouvre. Une application Replit peut exposer 3000, 3001, 3002, 3003, 4200, 5000, 5173, 6000, 6800, 8000, 8008, 8080, 8081 comme ports externes supplémentaires. Les ports 22 et 8283 ne sont pas transférables, car ils sont utilisés en interne.

​
Configuration .replit [[ports]]

Type : {localPort, externalPort, exposeLocalhost} La configuration [[ports]] vous permet de configurer quel port HTTP exposer pour votre sortie web. Par défaut, tout port HTTP exposé avec l’hôte 0.0.0.0 sera exposé comme sortie web de votre application Replit. Des ports supplémentaires peuvent être servis sans remplacer le port par défaut en ajoutant une nouvelle entrée [[ports]] à votre fichier .replit. Vous devez spécifier à la fois une entrée localPort et externalPort. Vous pouvez ajouter plusieurs ports supplémentaires en ajoutant plusieurs entrées [[ports]] à votre fichier .replit comme défini ci-dessous.

​
localPort

Détermine quel port Replit liera à un port externe.

​
externalPort

Détermine quel port doit être exposé comme port accessible publiquement pour ce port local. 
[[ports]]
localPort = 3000
externalPort = 80
Si vous souhaitez ne jamais exposer un port particulier, vous pouvez conserver la configuration localPort mais simplement ne pas ajouter d’externalPort : 
[[ports]]
localPort = 3000

​
exposeLocalhost

Détermine si un port interne utilisant localhost peut être lié à un port externe. Peut être true, false, ou null. 
[[ports]]
localPort = 3000
externalPort = 80
exposeLocalhost = true