Découvrez comment fonctionne Edgegap

Découvrez comment fonctionne Edgegap

Mappage de ports

Le mappage de ports expose le port interne d’un serveur de jeu sur l’adresse publique de son hôte afin que les joueurs puissent y accéder. Lorsque plusieurs serveurs partagent une même machine, chacun a besoin de son propre port externe. Le mappage est ce qui transforme « un conteneur est en cours d’exécution » en « un joueur peut s’y connecter ».

Aussi appelé

mappage de port de conteneur, publication de port

Par

Par

Par

Philip Coté

Philip Coté

Philip Coté

,

Directeur technique

Directeur technique

Directeur technique

Publié

Publié

Publié

À quoi sert le mappage de ports pour un serveur de jeu ?

Un serveur de jeu écoute sur un port à l'intérieur de son conteneur : un numéro défini dans son build ou ses arguments de lancement, comme le port 7777 par défaut d'Unreal Engine (Epic Games). Les joueurs ne peuvent généralement pas accéder directement à ce numéro. L'hôte auquel ils se connectent possède une adresse publique, généralement partagée par tous les serveurs qui s'y exécutent, et le mappage de ports est la règle qui achemine le trafic arrivant sur l'un des ports de l'hôte vers le port d'un conteneur.

À l'entrée, le paquet d'un joueur est traduit à au moins deux endroits :

  • Du côté du joueur : un routeur domestique, et souvent le fournisseur d'accès à Internet également, utilise la traduction d'adresses réseau (NAT) pour partager une seule adresse publique entre plusieurs appareils. Comme l'a expliqué Michal Buras de Highwire Games, « votre IP publique n'est pas votre propre IP publique » : les fournisseurs regroupent « plusieurs utilisateurs sous une seule IP », et le port qui les distingue est « temporairement assigné » (Live Service Game Summit, 2024). Tout cela échappe au contrôle du studio.

  • Au niveau de l'hôte du serveur de jeu : l'hôte mappe l'un de ses ports publics sur le port interne du conteneur. Il s'agit du mappage que le studio, ou son orchestrateur, contrôle.

Comme le joueur ouvre la connexion, son routeur autorise le retour des réponses, de sorte que rejoindre un serveur hébergé ne nécessite généralement aucune configuration du côté du joueur, même derrière une adresse partagée. Les adresses partagées posent principalement problème lorsqu'un joueur héberge (voir la FAQ ci-dessous).

Points clés de l'article

  1. Construisez et déployez votre code/jeu dans un package Container et poussez-le vers Edgegap en tant que nouvelle version d'application. C'est aussi simple que de créer un Dockerfile pour votre build et de laisser Edgegap s'occuper du reste.

  2. Testez en direct, pas en local ! Évitez le casse-tête du "çA mArChE sUr Ma MaChInE <insérer le mème de Bob l'éponge ici>" en déployant sur le réseau edge réel d'Edgegap en quelques secondes. Cette approche élimine la disparité entre votre environnement de développement et votre environnement de production, comme si vous disposiez d'un environnement de staging sans avoir à payer pour un second environnement. Vous saurez instantanément si votre application fonctionne correctement dans le monde réel sur plus de 615 emplacements mondiaux, détectant ainsi les problèmes que les tests locaux ne voient pas.

  3. Ajoutez vos outils de développement Déployez les outils de support dont vous avez besoin aux côtés de votre application - qu'il s'agisse d'utilitaires web, de balises réseau pour les tests, de services proxy, de bases de données ou de tout autre élément qui maintient votre flux de travail de développement fluide et efficace.

  4. Testez rapidement des composants individuels Déployez et testez des composants ou services spécifiques de manière isolée sans lancer de nouveaux clusters ni affecter votre pile de production. Parfait pour tester de nouvelles API avec des backends "fictifs", valider des microservices ou expérimenter des modifications de configuration dans un environnement edge en direct.


Pourquoi chaque serveur de jeu obtient-il un port public différent ?

De nombreux matchs peuvent partager un même hôte, et sur la même adresse, deux serveurs ne peuvent pas chacun écouter directement sur le même port public et le même protocole. Chaque serveur obtient donc son propre port externe, tandis que chaque conteneur continue d'écouter sur le même port interne. Le build reste identique ; seul le mappage diffère.

Certains orchestrateurs choisissent également un nouveau port externe pour chaque serveur qu'ils démarrent. Quoi qu'il en soit, le port public est une propriété d'un serveur en cours d'exécution, et non du jeu.

Un client qui se connecte systématiquement au port qu'il a utilisé lors des tests locaux fonctionne partout où le port public se trouve être égal à la valeur par défaut, et échoue partout où les deux diffèrent. La solution se trouve dans le client : récupérer le port à partir de ce qui lui indique où se déroule le match, plutôt qu'à partir d'une constante dans le code.

Comment les joueurs obtiennent-ils la bonne adresse et le bon port ?

Le port externe n'existe souvent qu'une fois le serveur démarré, il doit donc être transmis au joueur :

  1. L'orchestrateur démarre le serveur et enregistre son adresse publique ainsi que le port externe correspondant à chaque port interne.

  2. L'entité qui gère les connexions les lit : un matchmaker dans son attribution de partie, ou un navigateur de serveurs dans sa liste.

  3. Le client reçoit l'adresse et le port, puis se connecte.

Le serveur a parfois aussi besoin de ce mappage, par exemple pour s'enregistrer dans une liste de serveurs avec le port que les joueurs utiliseront réellement. Un serveur qui indique son port interne envoie les joueurs vers le mauvais port chaque fois que les deux diffèrent.

Sur Edgegap, un déploiement obtient un port externe pour chaque port interne dès qu'il est prêt, et le serveur peut lire les deux à partir de variables d'environnement (ARBITRIUM_PORT_<NAME>_INTERNAL et ARBITRIUM_PORT_<NAME>_EXTERNAL). Les ports externes sont aléatoires pour chaque déploiement, par mesure de sécurité, et le mappage peut être modifié pour de nouveaux déploiements en modifiant la version de l'application, sans avoir à recompiler le serveur (documentation Edgegap).

Quels ports un serveur de jeu doit-il mapper ?

Un pour le gameplay, et souvent plus. Chaque port est mappé individuellement, et un port est un numéro associé à un protocole (voir UDP vs TCP), donc chaque mappage doit spécifier le protocole que le serveur utilise réellement. Un ensemble courant :

Port

Protocole

Ce qu'il transporte

Gameplay

Généralement UDP

Entrées et mises à jour d'état pendant la partie

Requête (Query)

Souvent UDP

Nom du serveur, carte et nombre de joueurs pour les listes de serveurs

Administration à distance (RCON)

Souvent TCP

Commandes des opérateurs de serveur

Connexion navigateur

Généralement TCP (WebSocket)

Gameplay pour les builds exécutés dans un navigateur web

Une discordance de protocole est facile à manquer : un mappage configuré pour TCP permet au serveur d'un jeu UDP de démarrer normalement, alors qu'aucun des paquets des joueurs ne l'atteint. Les outils de conteneur diffèrent dans leurs valeurs par défaut, vérifiez donc le protocole sur chaque mappage plutôt que de vous fier à une valeur par défaut (le cas de Docker est traité dans la FAQ ci-dessous).

Les builds pour navigateur ne peuvent pas ouvrir de sockets UDP bruts, ils se connectent donc généralement via WebSocket sur un port TCP. Un jeu proposant un build natif et un build pour navigateur peut nécessiter un mappage pour chacun.

Un mot de notre sponsor (nous-mêmes !)

Une région est une supposition quant à l'endroit où se trouveront vos joueurs. L'Edge Cloud d'Edgegap est un réseau distribué et multi-cloud de plus de 615 emplacements répartis sur plus de 17 fournisseurs, disponible sur demande. Chaque serveur se lance au meilleur emplacement disponible sur le réseau au début du match, et non dans la région la plus proche parmi une poignée d'options.

Pourquoi les joueurs ne peuvent-ils pas se connecter à mon serveur de jeu ?

Lorsqu'un premier déploiement démarre mais que personne ne peut le rejoindre, la cause est souvent l'une des suivantes, à peu près dans l'ordre où il convient de vérifier :

  • Le serveur n'est pas prêt : le client s'est connecté avant que le serveur n'ait fini de démarrer, ou le serveur s'est arrêté brutalement au démarrage. Consultez d'abord les journaux du serveur.

  • Le port interne ne correspond pas : le port défini dans les paramètres réseau du build ou dans les arguments de lancement diffère du port interne dans le mappage.

  • Le serveur écoute uniquement sur localhost : un serveur lié à 127.0.0.1 n'accepte le trafic que depuis son propre espace de noms réseau (son conteneur ou son pod Kubernetes). Il doit écouter sur toutes les interfaces (0.0.0.0).

  • Le protocole est incorrect : le mappage est en TCP et le jeu utilise UDP, ou inversement.

  • Le client a le port interne : le client, ou l'adresse annoncée par le serveur, utilise le port interne au lieu du port externe.

Sur les machines gérées par le studio lui-même, une règle de pare-feu sur l'hôte ou dans le réseau cloud peut également bloquer le port externe. Les builds pour navigateur nécessitent une vérification supplémentaire, détaillée ci-dessous.

L'avis d'Edgegap (ce n'est que notre opinion, à prendre avec des pincettes !)

Attribuez un port WebSocket sécurisé à votre version pour navigateur avant son premier test public

Une version pour navigateur permet aux joueurs de rejoindre une partie à partir d'un lien, sans rien avoir à installer. Elle introduit également un risque d'échec de connexion auquel les versions natives ne sont pas confrontées.

Une page de jeu diffusée via HTTPS ne peut généralement pas ouvrir une connexion ws:// simple : les navigateurs la bloquent en tant que contenu mixte (websocket.org). Le joueur ne voit aucun message ; le seul indice est une erreur dans la console du navigateur. Une version testée depuis une page locale en http:// peut réussir tous les tests et pourtant échouer pour tous les joueurs.

Une vérification utile avant le premier playtest public : ouvrez la version depuis l'adresse HTTPS que les joueurs utiliseront, rejoignez une partie et vérifiez dans la console du navigateur s'il y a un WebSocket bloqué ou en échec. Répétez l'opération à chaque modification de la page d'hébergement ou de l'adresse du serveur.

Sur Edgegap, un port WebSocket peut utiliser un certificat géré : configurez le port en WS avec la mise à niveau TLS activée, et demandez aux clients de se connecter avec wss:// à l'URL Edgegap du déploiement. Les studios disposant de leur propre domaine peuvent utiliser WSS avec leur propre certificat (documentation Edgegap). Pour en savoir plus sur les choix de transport pour les jeux sur navigateur, consultez UDP vs TCP.

-

-

-

Philip Coté

Philip Coté

Philip Coté

,

Directeur technique

Directeur technique

Directeur technique

Questions Fréquemment Posées

Quelle est la différence entre le mappage de ports et la redirection de ports ?

La redirection de ports en vaut-elle la peine pour les jeux vidéo ?

Quel jeu utilise le port 25565, et à quoi sert le port 3074 ?

Comment mapper un port UDP dans Docker ?

Intégrer Edgegap facilement en quelques minutes

Commencez l'intégration maintenant!

Mettez votre jeu en ligne facilement
& en quelques minutes