Networking information/fr: Difference between revisions

From Resonite Wiki
← Older edit
Visual
Created page with "Les variant d'assets sont stockés sur <code>variants.resonite.com</code> et <code>skyfrost-archive.resonite.com/variants</code>"
Updating to match new version of source page
 
(12 intermediate revisions by 2 users not shown)
Line 3: Line 3:
Resonite est un moteur de jeu puissant connecté a ses utilisateurs directement et aux services Cloud Resonite. Si vous êtes curieux ou avez un pare-feu que vous voulez configurer, les informations suivantes peuvent aider.
Resonite est un moteur de jeu puissant connecté a ses utilisateurs directement et aux services Cloud Resonite. Si vous êtes curieux ou avez un pare-feu que vous voulez configurer, les informations suivantes peuvent aider.


== Traffic HTTP et WebSocket == <!--T:2-->
== Traffic HTTP et WebSocket ==


<!--T:3-->
Les informations comme le profil et objets dans votre inventaire sont stockés dans le Cloud de Resonite. Votre client va utiliser HTTPS ou WebSocket pour obtenir ces informations.
Les informations comme le profil et objets dans votre inventaire sont stockés dans le Cloud de Resonite. Votre client va utiliser HTTPS ou WebSocket pour obtenir ces informations.  


Voici une liste de domaines sur lesquels vous verrez probablement des connexions:
Voici une liste de domaines sur lesquels vous verrez probablement des connexions:
Line 17: Line 16:
** Les vignettes sont stockées sur <code>thumbnails.resonite.com</code> et <code>skyfrost-archive.resonite.com/thumbnails</code>
** Les vignettes sont stockées sur <code>thumbnails.resonite.com</code> et <code>skyfrost-archive.resonite.com/thumbnails</code>


== Traffic de sessions == <!--T:5-->
== Traffic de sessions ==


<!--T:6-->
Quand vous vous connectez a une session Resonite, vous établissez une connexion vers l'hôte de la session. Généralement, cela est l'ordinateur de l'utilisateur mais dans certains cas, cela peut être un serveur qui pourrait être hébergé n'importe ou; les cas les plus communs étant un ordinateur additional ou un serveur loué en centre de données.
<span lang="en" dir="ltr" class="mw-content-ltr">When you connect to a Resonite session, you're starting a connection to the session's host. This is usually another user's computer but sometimes can be a headless session which could be hosted in a number of places - two of the most common ones being on someone's spare computer or on a computer rented in a data center.</span>


<span lang="en" dir="ltr" class="mw-content-ltr">Depending on your settings and the settings of the session host you'll connect with either one of the following protocols:</span>
Dépendant de vos options et les options de l'hôte, vous vous connecterez avec l'un des protocoles suivants:


* [https://github.com/RevenantX/LiteNetLib LNL (LiteNetLib)]
* [https://github.com/RevenantX/LiteNetLib LNL (LiteNetLib)]
* [https://partner.steamgames.com/doc/features/multiplayer/networking Steam Sockets]. <span lang="en" dir="ltr" class="mw-content-ltr">Sometimes called "Steam Networking Sockets", "Steam Network", "SNS" etc.</span>
* [https://partner.steamgames.com/doc/features/multiplayer/networking Steam Sockets]. Aussi appelé "Steam Networking Socket", "Steam Network", "SNS", etc.


=== LNL === <!--T:7-->
=== LNL ===


<!--T:8-->
* [https://github.com/RevenantX/LiteNetLib LNL] utilise UDP
* <span lang="en" dir="ltr" class="mw-content-ltr">[https://github.com/RevenantX/LiteNetLib LNL] uses UDP to connect.</span>
* Les ports utilisés varient et peuvent être n'importe quel port sur l'hôte tant que celui-ci est libre.
* <span lang="en" dir="ltr" class="mw-content-ltr">Ports will vary and can be any port depending on the host as it lets the host pick a free port</span>
* Dans d'autres cas, un relais sera utilisé.
* <span lang="en" dir="ltr" class="mw-content-ltr">In other cases a relay will be used.</span>
* Après un [https://en.wikipedia.org/wiki/Hole_punching_(networking) punch-through] ou relais, la connexion s'établira.
* <span lang="en" dir="ltr" class="mw-content-ltr">After [https://en.wikipedia.org/wiki/Hole_punching_(networking) punch-through] or relay, the actual connection to the user can be any IP or port.</span>


=== <span lang="en" dir="ltr" class="mw-content-ltr">Steam Sockets</span> === <!--T:9-->
=== <span class="mw-translate-fuzzy">Steam Sockets</span> ===
<span lang="en" dir="ltr" class="mw-content-ltr">Steam Sockets is a Valve created networking protocol. You can find information on it [https://github.com/ValveSoftware/GameNetworkingSockets here]</span>


== <span lang="en" dir="ltr" class="mw-content-ltr">Establishing Connections</span> ==
<div class="mw-translate-fuzzy">
<span lang="en" dir="ltr" class="mw-content-ltr">Resonite utilizes multiple methods to attempt to connect users to sessions on remote machines. This can be illustrated in the following flow chart.</span>
Steam Sockets est un protocole réseau créé par Valve. Vous pouvez trouver des informations sur celui-ci sur [https://github.com/ValveSoftware/GameNetworkingSockets leur site officiel].
</div>
 
== Établir des connections ==
 
Resonite utilise plusieurs méthodes pour tenter de se connecter a une session. Cela peut être illustré dans le graphique suivant.


{{Diagram:LNLConnectionOptions{{UseLangLink}}}}
{{Diagram:LNLConnectionOptions{{UseLangLink}}}}


<span lang="en" dir="ltr" class="mw-content-ltr">Resonite will attempt to directly connect users where it can, for example over a LAN. However, this is not always possible due to a variety of network security constraints.</span>
Resonite va tenter de se connecter directement quand il peut, par exemple sur un réseau local. Cela n'est cependant pas toujours possible dépendant sur le réseau et sa sécurité.
 
=== Connexion directe ===
 
En général, une connexion directe est le meilleur cas. Vous vous connectez directement quand Resonite sait exactement ou aller et comment y aller (généralement directement avec une adresse IP, nom de domaine et port ouvert).


=== <span lang="en" dir="ltr" class="mw-content-ltr">Direct IP</span> ===<!--T:30-->
Pour utiliser une connexion directe


<!--T:51-->
* <span class="mw-translate-fuzzy">Utilisez une node [[ProtoFlux]] [[ProtoFlux:OpenWorld | OpenWorld]] et ajoutez une URI avec l'adresse IP et port comme cela: <code>lnl://<adresse IP>:<Port>/</code></span>
<span lang="en" dir="ltr" class="mw-content-ltr">In general, direct IP is best. You’re connecting directly with the remote server and are telling Resonite exactly where to go and how to get there (you are connecting with a direct IP address or domain name).</span>  
** Pour IPv6, mettez l'adresse entre crochets: <code>lnl://[<adresse IPv6>]:<port>/</code>
** Vous pouvez aussi utiliser un domaine pour cela: <code>lnl://<domaine>:<port>/</code>
* Un port est demandé et fait partie de l'URI.
* Dans la plupart des cas, cela est utile pour se connecter a un serveur ayant une adresse IP statique et le port ouvert.


<!--T:52-->
Comme exemple, une session hébergée avec l'adresse IPv4 <code>203.0.113.7</code>, l'adresse IPv6 <code>2001:db8::7</code> et le domaine <code>seven.example.com</code> sur le port <code>12100</code>:
<span lang="en" dir="ltr" class="mw-content-ltr">To use direct IP</span>
* <span lang="en" dir="ltr" class="mw-content-ltr">Use an OpenWorld ProtoFlux node and add a Uri (purple input second from top) with the IP address and port like this: <code>lnl://<IPv4 address>:<Port>/</code></span>
** <span lang="en" dir="ltr" class="mw-content-ltr">For IPv6, wrap the address in brackets <code>lnl://[<IPv6 address>]:<port>/</code></span>
** <span lang="en" dir="ltr" class="mw-content-ltr">You can also use a DNS record for this - <code>lnl://<domain>:<port>/</code></span>
* <span lang="en" dir="ltr" class="mw-content-ltr">A port is currently required as part of the URL</span>
* <span lang="en" dir="ltr" class="mw-content-ltr">This is mostly applicable to headless sessions where the session has a static IP address and port. Keep an eye out for session owners providing items that include direct links for their worlds as that will be the most reliable and expedient way to connect to said world.</span>


<span lang="en" dir="ltr" class="mw-content-ltr">As an example for a session hosted with the IPv4 address <code>203.0.113.7</code>, IPv6 address <code>2001:db8::7</code>, the DNS record <code>seven.example.com</code> on port <code>12100</code>:</span>
* <code>lnl:///203.0.113.7:12100/</code>: Connexion IPv4 directe
* <code>lnl://[2001:db8::7]:12100/</code>: Connexion IPv6 directe
* <code>lnl://seven.example.com:12100/</code>: Connexion directe via un domaine


<code>lnl:///203.0.113.7:12100/</code>: <span lang="en" dir="ltr" class="mw-content-ltr">IPv4 direct connection</span>
=== Perforation UDP (NAT Punchthrough LNL) ===


<code>lnl://[2001:db8::7]:12100/</code>: <span lang="en" dir="ltr" class="mw-content-ltr">IPv6 direct connection</span>
La perforation UDP est utilisée par LNL dans Resonite pour établir une connexion bidirectionnelle entre l'utilisateur et l'hôte de session, quand l'un d'entre eux est derrière NAT.


<code>lnl://seven.example.com:12100/</code>: <span lang="en" dir="ltr" class="mw-content-ltr">DNS direct connection</span>
Cela est facilité grâce aux serveurs LNL Punchthrough de Resonite (les mêmes hôtes qui peuvent êtres vu sur [[#LNL Relay | relais LNL]]), ou l'utilisateur et l'hôte établissent une connexion pour en établir une pair-a-pair. Cela devrait être indistinguable d'une connexion directe.


=== <span lang="en" dir="ltr" class="mw-content-ltr">UDP Hole Punching (LNL NAT Punchthrough)</span> === <!--T:40-->
Si vous avez des problèmes avec le Punchthrough NAT, vous êtes probablement derrière un NAT Strict (aussi appelé de Type 3) ou la perforation ne fonctionne pas.


<!--T:54-->
Vous pouvez voir quel type de NAT vous avez en visitant https://networktest.razortune.com dans un navigateur web - c'est un outil hébergé par le membre de la communauté Rucio et est fait spécifiquement pour Resonite.
<span lang="en" dir="ltr" class="mw-content-ltr">UDP hole punching is used by LNL in Resonite in order to establish a bidirectional connection between you and a session host where Network Address Translation (NAT) is in play on one or both sides of a connection.</span>


<span lang="en" dir="ltr" class="mw-content-ltr">This is facilitated by one of Resonite's LNL punchthrough servers (the same hosts that can be seen in [[#LNL Relay]]), where both you and the host establish a connection in order to establish a peer to peer connection between you and the host that should be indistinguishable from directly connecting.</span>
Si votre NAT est strict, il y a deux causes communes:


<!--T:55-->
* Votre routeur peut avoir des options en place qui font que NAT soit en mode strict - vous voulez un NAT 1:1 ou statique (la terminologie diffère de routeurs en routeurs)
<span lang="en" dir="ltr" class="mw-content-ltr">If you encounter issues with NAT punchthrough, you may be behind a Strict (also known as Type 3) NAT, where the conditions of the NAT make it so hole punching doesn't work.</span>
* Votre FAI peut avoir CGNAT (example: free.fr) ce qui peut causer cela - vous pouvez voir si vous êtes derrière CGNAT en visitant un site comme https://ipinfo.io et voir sur votre routeur quelle est votre adresse IP. Si les deux addresses diffèrent, vous êtes probablement derrière CGNAT.


<span lang="en" dir="ltr" class="mw-content-ltr">You can check your NAT type by going to https://networktest.razortune.com/ in a web browser - this is a tool hosted by community member Rucio and is specific towards Resonite networking.</span>
Si c'est sur votre routeur:


<span lang="en" dir="ltr" class="mw-content-ltr">If your NAT type is Strict, there are two common causes for this:</span>
Regardez dans le options de votre routeur - une bonne manière est de chercher "<routeur> NAT ouvert" et voir quels sont les résultats


* <span lang="en" dir="ltr" class="mw-content-ltr">Your router could have settings in place for its NAT causing this to happen - what you want is a 1:1 NAT or a static NAT (terminology may differ depending on router)</span>
Si c'est votre FAI:
* <span lang="en" dir="ltr" class="mw-content-ltr">Your ISP could be doing CGNAT in a way that causes this - you can see if you're behind CGNAT by checking what your router reports your WAN address as being and what a site like https://ipinfo.io says; if these two addresses differ, you're likely behind CGNAT.</span>


<span lang="en" dir="ltr" class="mw-content-ltr">If it's your router:</span>
Vous pouvez contactez votre FAI pour leur demander soit une adresse IPv4 dédiée publique ou de vous bouger hors de CGNAT. Cela peut parfois venir a un coût additionnel.


<span lang="en" dir="ltr" class="mw-content-ltr">Check your router settings - a good way to start is by searching "<router> Open NAT" and seeing what comes up setting wise.</span>


<span lang="en" dir="ltr" class="mw-content-ltr">If it's your ISP:</span>
Si vous ne pouvez pas résoudre votre situation, il est recommandé d'utiliser une connexion [[#Direct IP | directe]] suivi par l'utilisation d'un [[#LNL Relay | relais LNL]] pour se connecter aux sessions.


<span lang="en" dir="ltr" class="mw-content-ltr">You may be able to contact your ISP to get them to either take you out from behind CGNAT or give you a static, public IPv4 address. This may come at a cost for something like a static IP.</span>


=== Bugs possibles ===


<span lang="en" dir="ltr" class="mw-content-ltr">If you're unable to resolve being in a strict NAT situation, it is recommended to use [[#Direct IP]] connections followed by using the [[#LNL Relay]] to connect to sessions.</span>
* Un bug connu fait que Resonite va tenter la perforation UDP, ne va pas attendre assez longtemps pour la réponse et va directement essayer d'autres méthodes de connexion.
* Le serveur LNL ne supporte pas IPv6, utilisant a la place IPv4 seulement. Certains FAIs, comme au Japon, utilisent uniquement IPv6. Les utilisateurs sur ces réseaux ne pourront pas utiliser la perforation LNL. [https://github.com/Yellow-Dog-Man/Resonite-Issues/issues/143 (Github Issue #143)]


=== Relais LNL ===


<!--T:56-->=== <span lang="en" dir="ltr" class="mw-content-ltr">Possible Bugs</span> ===
Cette méthode implique des pertes de performance. Les relais agissent come un intermédiaire entre les deux clients et tout le traffic est routé par le relais. La latence est généralement plus haute (mais pas toujours). Si le relais a des problèmes, l'utilisateur l'utilisant souffrira des mêmes problèmes.


* <span lang="en" dir="ltr" class="mw-content-ltr">One current issue seems to be that the NAT punchthrough server occasionally does not respond very quickly, and the client does not always wait for a response and tries the next protocol on it’s internal list to attempt.</span>
Nous avons les relais suivants


* <span lang="en" dir="ltr" class="mw-content-ltr">The punchthrough server does not support IPv6, instead only supporting IPv4. Some ISPs in some parts of the world, such as Japan, use exclusively IPv6. Users in these networks may not be able to use NAT punchthrough (this gets very complicated very quickly, results will vary). [https://github.com/Yellow-Dog-Man/Resonite-Issues/issues/143 (Github Issue #143)]</span>
* <code>uswest1.resonite.com</code> - Ouest USA (Hillsboro, Oregon)
* <code>au1.resonite.com</code> - Océanie (Sydney, Australie)
* <code>japan1.resonite.com</code> - Asie Pacifique (Tokyo, Japon)
* <code>europe.resonite.com</code> - Europe (Helsinki, Finlande)


=== <span lang="en" dir="ltr" class="mw-content-ltr">LNL Relay</span> === <!--T:50-->
Vous pouvez voir le status de ces relais sur https://status.yellowdogman.com ou dans un formas brut a https://api.resonite.com/networknodes


<!--T:58-->
==== Comment les relais fonctionnent ====
<span lang="en" dir="ltr" class="mw-content-ltr">This can come with performance implications. The relay acts as a third point between both clients, and all traffic is routed through it. Ping will likely be worse here (but not always). If the relay has issues or is overloaded, you may also get service issues.</span>


* <span lang="en" dir="ltr" class="mw-content-ltr">We have the following LNL Relays</span>
Quand un relais est requis, le client envoie une requête a https://api.resonite.com/networknodes pour recevoir la liste des relais disponibles. Le client ensuit détermine basé sur quelques facteurs quel relais est le meilleur. Ces critères sont par example: la capacité du relais et sa latence. Les ports pour le relais sont déterminés par celui-ci. N'assumez jamais qu'un relais soit constant.
** uswest1.resonite.com - <span lang="en" dir="ltr" class="mw-content-ltr">US West (Hillsboro, OR)</span>
** au1.resonite.com - <span lang="en" dir="ltr" class="mw-content-ltr">Oceania (Sydney, Australia)</span>
** japan1.resonite.com - <span lang="en" dir="ltr" class="mw-content-ltr">Asia Pacific (Tokyo, Japan)</span>
** europe.resonite.com - <span lang="en" dir="ltr" class="mw-content-ltr">Europe (Helsinki, Finland)</span>


<span lang="en" dir="ltr" class="mw-content-ltr">You can see the status of these relays at https://status.yellowdogman.com or in a raw format at https://api.resonite.com/networknodes</span>
Voici un diagramme illustrant une connexion a un relais:


==== <span lang="en" dir="ltr" class="mw-content-ltr">How LNL Relays Work</span> ====
{{Diagram:LNLRelayConnection{{UseLangLink}}}}
<span lang="en" dir="ltr" class="mw-content-ltr">When a relay is required, the client sends a request to https://api.resonite.com/networknodes to retrieve the currently available relays.  From there, the client makes a determination based upon multiple factors which relay is the best one for it to utilize.  For example, the relay's currently available capacity, and its ping.  The ports for the relay are determined by the relay server's operating system and port availability.  Do not assume any consistency for the relays.</span>


<span lang="en" dir="ltr" class="mw-content-ltr">Here's a diagram illustrating the relay connection flow:</span>
Pour l'instant, nous ne supportons pas la connexion a un relais spécifique.


== Recommandations pour les serveurs == <!--T:21-->


{{Diagram:LNLRelayConnection{{UseLangLink}}}}
Pour supporter la connexion directe, il est préféré d'utiliser et de supporter IPv6.
 
Si vous avez une IPv4 publique, vous pouvez ouvrir le port de la session. Pour cela, mettez le port en question dans la configuration <code>forcePort</code> pour le monde.
 
Si vous avez IPv6, utilisez <code>forcePort</code> dès que possible comme pour IPv4. Voir [[#Direct IP | IP directe]] pour comment se connecter directement a une session.
 
Dans certains cas, vous ne pouvez pas ouvrir un port, par exemple quand vous utilisez un routeurs qui ne vous permet pas cela ou quand vous êtes derrière CGNAT.
 
Si vous êtes derrière CGNAT, essayez de vous en séparer - dépendant de votre FAI et type de connexion, cela peut finir en des coûts additionnels.
 
Si vous avez des utilisateurs ayant des problèmes pour se connecter grâce a un perforage LNL, demandez leur de se connecter directement a votre session. Vous pouvez créer un objet a presser qui rendrais la tâche plus facile.


== Configuration recommandée de routeur == <!--T:10-->


<span lang="en" dir="ltr" class="mw-content-ltr">At this time, we do not support the ability to pick a specific relay.</span>
Beaucoup de routeurs sont déjà configurés pour offrir la meilleur expérience avec Resonite en routant le traffic avec une manière permettant les utilisateurs d'établir une connexion directe. Certains routeurs emploient un type de NAT ou les ports ne sont pas préservés a la connexion. Ce type de NAT est appelé Strict ou "Type 3". Comme le nom implique, la nature stricte de ce type de NAT ne permet pas d'établir une connexion avec les autres utilisateurs.


== <span lang="en" dir="ltr" class="mw-content-ltr">Recommendations for Headless Servers</span> == <!--T:21-->
Pour la meilleure expérience, il est recommandé de configurer son routeur pour permettre un NAT modéré ou Type 2 depuis l'ordinateur exécutant Resonite. Chaque constricteur implémente cette configuration différemment et la terminologie n'est parfois pas la même. Veuillez référer a la documentation pour votre routeur ou postez une demande d'aide dans le canal #questions-help dans le [https://discord.gg/resonite Discord de Resonite].


<!--T:59-->
=== <span lang="en" dir="ltr" class="mw-content-ltr">pfSense/OPNsense configuration</span> ===
<span lang="en" dir="ltr" class="mw-content-ltr">To better support direct connection conditions it is suggested server hosts try to promote direct IP connections and IPv6 support.</span>


<span lang="en" dir="ltr" class="mw-content-ltr">If you have a public IPv4 address that you can use, you can port forward the session's port. To do this, set the <code>forcePort</code> option for the world in your headless config file & forward the port through your router. You can find out how to do this by searching "<Router Model> port forward" - for most routers, you'll be able to find an example somewhere on the internet.</span>
<div lang="en" dir="ltr" class="mw-content-ltr">
If you are behind a [https://www.pfsense.org/ pfSense] or an [https://opnsense.org/ OPNsense] router, their default outbound NAT configurations will prevent Resonite from connecting to sessions using [[Networking Information#UDP Hole Punching (LNL NAT Punchthrough)|LNL NAT Punchthrough]]. While Resonite will fall back to using the [[Networking Information#LNL Relay Support for Strict NAT|LNL Relay]] in this case, it introduces overhead that can be avoided by configuring your router to allow these connections.
</div>


<span lang="en" dir="ltr" class="mw-content-ltr">If you have IPv6 support, use it when possible by setting <code>forcePort</code> as in the IPv4 example, allowing the session's port through your firewall & direct connecting (See [[#Direct IP]] for how to directly connect to a session)</span>
[[<span lang="en" dir="ltr" class="mw-content-ltr">File:PfSense NAT Configuration.png</span>|alt=<span lang="en" dir="ltr" class="mw-content-ltr">Screenshot showing how pfSense's Outbound NAT must be configured to allow Resonite's LNL NAT Punchthrough to work.</span>|thumb|<span lang="en" dir="ltr" class="mw-content-ltr">pfSense router configured to allow Resonite to perform LNL NAT Punchthrough successfully</span>]]


<span lang="en" dir="ltr" class="mw-content-ltr">You may not be to port forward in all situations, such as if you're using a router that doesn't let you port forward or if you're behind CGNAT.</span>
==== pfSense ====


<span lang="en" dir="ltr" class="mw-content-ltr">If you are behind CGNAT (Carrier Grade NAT), see if you can get off it - depending on your ISP and the type of your internet connection, you may get varying results. Some will take you off CGNAT if you ask, some will get you to pay for a static IP address and some may not allow you to get off CGNAT at all.</span>
# <span lang="en" dir="ltr" class="mw-content-ltr">Log into your '''pfSense''' web interface.</span>
# <span lang="en" dir="ltr" class="mw-content-ltr">In the navigation bar, click on '''Firewall''' and then '''NAT'''.</span>
# <span lang="en" dir="ltr" class="mw-content-ltr">Click on the '''Outbound''' tab.</span>
# <span lang="en" dir="ltr" class="mw-content-ltr">Under '''Outbound NAT Mode''', select ''Hybrid Outbound NAT rule generation.'' and click '''Save'''.</span>
# <span lang="en" dir="ltr" class="mw-content-ltr">Next, click the first '''Add''' button underneath the '''Mappings''' section.</span>
# <span lang="en" dir="ltr" class="mw-content-ltr">Next to '''Source''', change the ''Type'' dropdown from "Network" to "Any".</span>
# <span lang="en" dir="ltr" class="mw-content-ltr">Scroll down and check the checkbox labelled '''Static Port'''.</span>
# <span lang="en" dir="ltr" class="mw-content-ltr">Click '''Save''' at the bottom of the page.</span>
# <span lang="en" dir="ltr" class="mw-content-ltr">Click the '''Apply Changes''' button at the top of the page.</span>


<span lang="en" dir="ltr" class="mw-content-ltr">If you're having users with issues connecting via LNL punchthrough, direct them to directly connecting to your session. Making an object that connects them - such as a button that they can press and just connect makes doing this quite easy.</span>
[<span lang="en" dir="ltr" class="mw-content-ltr">[File:OPNsense NAT Configuration.png</span>|alt=<span lang="en" dir="ltr" class="mw-content-ltr">Screenshot showing how OPNsense's Outbound NAT must be configured to allow Resonite's LNL NAT Punchthrough to work.</span>|thumb|<span lang="en" dir="ltr" class="mw-content-ltr">OPNsense router configured to allow Resonite to perform LNL NAT Punchthrough successfully</span>]]


== <span lang="en" dir="ltr" class="mw-content-ltr">Recommended Router Configuration</span> == <!--T:10-->
==== OPNsense ====


<!--T:11-->
# <span lang="en" dir="ltr" class="mw-content-ltr">Log into your '''OPNsense''' web interface.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">Many consumer routers are configured by default to provide optimal connectivity for Resonite by routing traffic in such a way which permits the ability for users to directly establish a connection to other users on the Internet. However, some advanced routers employ a type of NAT (Network Address Translation) where port numbers are not preserved when communicating with other hosts on the internet. This type of NAT is often referred to as strict, or “Type-3”. As the name implies, the strict nature of this type of NAT does not permit the ability to establish connections with other users.</span>
# <span lang="en" dir="ltr" class="mw-content-ltr">In the left sidebar, click '''Firewall''', '''NAT''', and then '''Outbound'''.</span>
# <span lang="en" dir="ltr" class="mw-content-ltr">Under '''Mode''', select ''Hybrid Outbound NAT rule generation'' and click '''Save'''.</span>
# <span lang="en" dir="ltr" class="mw-content-ltr">The '''Manual rules''' section will appear. Click the '''+''' icon on the far right side.</span>
# <span lang="en" dir="ltr" class="mw-content-ltr">Scroll down and check the checkbox labelled '''Static-port'''.</span>
# <span lang="en" dir="ltr" class="mw-content-ltr">Click '''Save''' at the bottom of the page.</span>
# <span lang="en" dir="ltr" class="mw-content-ltr">Click the '''Apply changes''' button at the top of the page.</span>


<!--T:12-->
=== Support du relais pour NAT strict ===
<span lang="en" dir="ltr" class="mw-content-ltr">For the best Resonite experience, it is recommended to configure your router in such a way to permit a moderate or Type-2 NAT from the computer running Resonite. Each manufacturer implements this configuration differently and the terminology is not often the same between brands. Please refer to the documentation for your particular router or ask for assistance in the #questions-help forum in the Resonite [https://discord.gg/resonite Discord] server.</span>


=== <span lang="en" dir="ltr" class="mw-content-ltr">LNL Relay Support for Strict NAT</span> === <!--T:13-->
Resonite permet aux utilisateurs derrière un NAT strict a se connecter a d'autre utilisateurs en utilisant un relais. Cette méthode fonctionne bien pour un usage occasionnel mais ne permet pas une performance optimale dépendant de la localisation géographique et du status du relais.
<span lang="en" dir="ltr" class="mw-content-ltr">Resonite provides a method for users who are using a router with strict NAT to connect to other users by using an intermediary server known as the Resonite LNL Relay. Although this solution will work for occasional use, it may not provide the best performance depending on geographic location and network load/congestion.</span>


<!--T:14-->
Vous pouvez voir si vous vous connectez depuis un relais par la présence du texte "Relais LNL" apparaissant sous le message "Chargement..." en vous connectant a un monde. La présence du texte "Relais LNL" en rejoignant un monde dit que Resonite n'a pas pu se connecter directement au monde et qu'un relais a été utilisé.
<span lang="en" dir="ltr" class="mw-content-ltr">You can determine if you are connecting through an LNL Relay by the presence of the “LNL Relay” text appearing under the “Loading…” message while joining a world. The presence of the “LNL Relay” text when joining a world means that Resonite was unable to connect to the host user directly and the Resonite LNL Relay server was used.</span>


<!--T:15-->
La présence de ce texte indique que soit vous, soit l'hôte du monde (ou les deux) soit derrière un NAT strict. Si vous voyez ce message a chaque fois, il y a de bonnes chances que ce soit vous.
<span lang="en" dir="ltr" class="mw-content-ltr">The presence of the “LNL Relay” text typically indicates that either you, the host user, or both users may be behind a strict / Type-3 NAT. If you see this message each time you connect to a world, there is a good chance that you are behind a router that is configured for strict / Type-3 NAT.</span>


<!--T:16-->
Il est recommandé d'utiliser un NAT modéré/de type 2 pour éviter d'avoir a dépendre sur un relais. Voir [[Networking Information#Recommended Router Configuration|configuration du routeur]] pour plus d'informations.
<span lang="en" dir="ltr" class="mw-content-ltr">It is recommended to use a moderate or Type-2 NAT to avoid the dependency on using the LNL Relay. See the [[Networking Information#Recommended Router Configuration|Router Configuration]] section above for more information.</span>


=== <span lang="en" dir="ltr" class="mw-content-ltr">uPNP/NAT-PMP and Port Forwarding</span> === <!--T:17-->
=== uPNP/NAT-PMP et ouverture de ports === <!--T:17-->


<!--T:18-->
Resonite ne supporte pas l'ouverture de port via uPNP/NAT-PMP.
<span lang="en" dir="ltr" class="mw-content-ltr">Resonite does not currently offer support for port forwarding or uPNP/NAT-PMP.</span>

Latest revision as of 07:50, 12 August 2025

Other languages:

Resonite est un moteur de jeu puissant connecté a ses utilisateurs directement et aux services Cloud Resonite. Si vous êtes curieux ou avez un pare-feu que vous voulez configurer, les informations suivantes peuvent aider.

Traffic HTTP et WebSocket

Les informations comme le profil et objets dans votre inventaire sont stockés dans le Cloud de Resonite. Votre client va utiliser HTTPS ou WebSocket pour obtenir ces informations.

Voici une liste de domaines sur lesquels vous verrez probablement des connexions:

  • La plupart du traffic HTTPS est vers api.resonite.com
  • SignalR (mises à jour en temps réel) créé une connexion WebSocket vers un service sur api.resonite.com
  • Les Assets (avatars, modèles, textures, etc) et autres binaires sont stockés sur une variétés d'hôtes:
    • Les variant d'assets sont stockés sur variants.resonite.com et skyfrost-archive.resonite.com/variants
    • Les assets sont stockés sur assets.resonite.com et skyfrost-archive.resonite.com/assets
    • Les vignettes sont stockées sur thumbnails.resonite.com et skyfrost-archive.resonite.com/thumbnails

Traffic de sessions

Quand vous vous connectez a une session Resonite, vous établissez une connexion vers l'hôte de la session. Généralement, cela est l'ordinateur de l'utilisateur mais dans certains cas, cela peut être un serveur qui pourrait être hébergé n'importe ou; les cas les plus communs étant un ordinateur additional ou un serveur loué en centre de données.

Dépendant de vos options et les options de l'hôte, vous vous connecterez avec l'un des protocoles suivants:

LNL

  • LNL utilise UDP
  • Les ports utilisés varient et peuvent être n'importe quel port sur l'hôte tant que celui-ci est libre.
  • Dans d'autres cas, un relais sera utilisé.
  • Après un punch-through ou relais, la connexion s'établira.

Steam Sockets

Steam Sockets est un protocole réseau créé par Valve. Vous pouvez trouver des informations sur celui-ci sur leur site officiel.

Établir des connections

Resonite utilise plusieurs méthodes pour tenter de se connecter a une session. Cela peut être illustré dans le graphique suivant.


Non
Oui
Oui
Non
Début
Est-ce qu'on peut se connecter directement?
Est-ce qu'on peut faire un NAT PunchThrough?
Connecté
Utiliser un relais LNL?
Utiliser un pont LNL pour faire le NAT PunchThrough?

Resonite va tenter de se connecter directement quand il peut, par exemple sur un réseau local. Cela n'est cependant pas toujours possible dépendant sur le réseau et sa sécurité.

Connexion directe

En général, une connexion directe est le meilleur cas. Vous vous connectez directement quand Resonite sait exactement ou aller et comment y aller (généralement directement avec une adresse IP, nom de domaine et port ouvert).

Pour utiliser une connexion directe

  • Utilisez une node ProtoFlux OpenWorld et ajoutez une URI avec l'adresse IP et port comme cela: lnl://<adresse IP>:<Port>/
    • Pour IPv6, mettez l'adresse entre crochets: lnl://[<adresse IPv6>]:<port>/
    • Vous pouvez aussi utiliser un domaine pour cela: lnl://<domaine>:<port>/
  • Un port est demandé et fait partie de l'URI.
  • Dans la plupart des cas, cela est utile pour se connecter a un serveur ayant une adresse IP statique et le port ouvert.

Comme exemple, une session hébergée avec l'adresse IPv4 203.0.113.7, l'adresse IPv6 2001:db8::7 et le domaine seven.example.com sur le port 12100:

  • lnl:///203.0.113.7:12100/: Connexion IPv4 directe
  • lnl://[2001:db8::7]:12100/: Connexion IPv6 directe
  • lnl://seven.example.com:12100/: Connexion directe via un domaine

Perforation UDP (NAT Punchthrough LNL)

La perforation UDP est utilisée par LNL dans Resonite pour établir une connexion bidirectionnelle entre l'utilisateur et l'hôte de session, quand l'un d'entre eux est derrière NAT.

Cela est facilité grâce aux serveurs LNL Punchthrough de Resonite (les mêmes hôtes qui peuvent êtres vu sur relais LNL), ou l'utilisateur et l'hôte établissent une connexion pour en établir une pair-a-pair. Cela devrait être indistinguable d'une connexion directe.

Si vous avez des problèmes avec le Punchthrough NAT, vous êtes probablement derrière un NAT Strict (aussi appelé de Type 3) ou la perforation ne fonctionne pas.

Vous pouvez voir quel type de NAT vous avez en visitant https://networktest.razortune.com dans un navigateur web - c'est un outil hébergé par le membre de la communauté Rucio et est fait spécifiquement pour Resonite.

Si votre NAT est strict, il y a deux causes communes:

  • Votre routeur peut avoir des options en place qui font que NAT soit en mode strict - vous voulez un NAT 1:1 ou statique (la terminologie diffère de routeurs en routeurs)
  • Votre FAI peut avoir CGNAT (example: free.fr) ce qui peut causer cela - vous pouvez voir si vous êtes derrière CGNAT en visitant un site comme https://ipinfo.io et voir sur votre routeur quelle est votre adresse IP. Si les deux addresses diffèrent, vous êtes probablement derrière CGNAT.

Si c'est sur votre routeur:

Regardez dans le options de votre routeur - une bonne manière est de chercher "<routeur> NAT ouvert" et voir quels sont les résultats

Si c'est votre FAI:

Vous pouvez contactez votre FAI pour leur demander soit une adresse IPv4 dédiée publique ou de vous bouger hors de CGNAT. Cela peut parfois venir a un coût additionnel.


Si vous ne pouvez pas résoudre votre situation, il est recommandé d'utiliser une connexion directe suivi par l'utilisation d'un relais LNL pour se connecter aux sessions.


Bugs possibles

  • Un bug connu fait que Resonite va tenter la perforation UDP, ne va pas attendre assez longtemps pour la réponse et va directement essayer d'autres méthodes de connexion.
  • Le serveur LNL ne supporte pas IPv6, utilisant a la place IPv4 seulement. Certains FAIs, comme au Japon, utilisent uniquement IPv6. Les utilisateurs sur ces réseaux ne pourront pas utiliser la perforation LNL. (Github Issue #143)

Relais LNL

Cette méthode implique des pertes de performance. Les relais agissent come un intermédiaire entre les deux clients et tout le traffic est routé par le relais. La latence est généralement plus haute (mais pas toujours). Si le relais a des problèmes, l'utilisateur l'utilisant souffrira des mêmes problèmes.

Nous avons les relais suivants

  • uswest1.resonite.com - Ouest USA (Hillsboro, Oregon)
  • au1.resonite.com - Océanie (Sydney, Australie)
  • japan1.resonite.com - Asie Pacifique (Tokyo, Japon)
  • europe.resonite.com - Europe (Helsinki, Finlande)

Vous pouvez voir le status de ces relais sur https://status.yellowdogman.com ou dans un formas brut a https://api.resonite.com/networknodes

Comment les relais fonctionnent

Quand un relais est requis, le client envoie une requête a https://api.resonite.com/networknodes pour recevoir la liste des relais disponibles. Le client ensuit détermine basé sur quelques facteurs quel relais est le meilleur. Ces critères sont par example: la capacité du relais et sa latence. Les ports pour le relais sont déterminés par celui-ci. N'assumez jamais qu'un relais soit constant.

Voici un diagramme illustrant une connexion a un relais:


Hôte de la sessionRelaisAPIClientHôte de la sessionRelaisAPIClientMessages LNL relayés asynchroneQuels relais sont disponibles? (api.resonite.com/networknodes)1Voici une liste des relais2Sélectionne le meilleur relais basé sur la latence et autres statistiques3Connecte au meilleur relais4Connecte a l'hôte de la session5Traffic LNLTraffic LNL

Pour l'instant, nous ne supportons pas la connexion a un relais spécifique.

Recommandations pour les serveurs

Pour supporter la connexion directe, il est préféré d'utiliser et de supporter IPv6.

Si vous avez une IPv4 publique, vous pouvez ouvrir le port de la session. Pour cela, mettez le port en question dans la configuration forcePort pour le monde.

Si vous avez IPv6, utilisez forcePort dès que possible comme pour IPv4. Voir IP directe pour comment se connecter directement a une session.

Dans certains cas, vous ne pouvez pas ouvrir un port, par exemple quand vous utilisez un routeurs qui ne vous permet pas cela ou quand vous êtes derrière CGNAT.

Si vous êtes derrière CGNAT, essayez de vous en séparer - dépendant de votre FAI et type de connexion, cela peut finir en des coûts additionnels.

Si vous avez des utilisateurs ayant des problèmes pour se connecter grâce a un perforage LNL, demandez leur de se connecter directement a votre session. Vous pouvez créer un objet a presser qui rendrais la tâche plus facile.

Configuration recommandée de routeur

Beaucoup de routeurs sont déjà configurés pour offrir la meilleur expérience avec Resonite en routant le traffic avec une manière permettant les utilisateurs d'établir une connexion directe. Certains routeurs emploient un type de NAT ou les ports ne sont pas préservés a la connexion. Ce type de NAT est appelé Strict ou "Type 3". Comme le nom implique, la nature stricte de ce type de NAT ne permet pas d'établir une connexion avec les autres utilisateurs.

Pour la meilleure expérience, il est recommandé de configurer son routeur pour permettre un NAT modéré ou Type 2 depuis l'ordinateur exécutant Resonite. Chaque constricteur implémente cette configuration différemment et la terminologie n'est parfois pas la même. Veuillez référer a la documentation pour votre routeur ou postez une demande d'aide dans le canal #questions-help dans le Discord de Resonite.

pfSense/OPNsense configuration

If you are behind a pfSense or an OPNsense router, their default outbound NAT configurations will prevent Resonite from connecting to sessions using LNL NAT Punchthrough. While Resonite will fall back to using the LNL Relay in this case, it introduces overhead that can be avoided by configuring your router to allow these connections.

[[File:PfSense NAT Configuration.png|alt=Screenshot showing how pfSense's Outbound NAT must be configured to allow Resonite's LNL NAT Punchthrough to work.|thumb|pfSense router configured to allow Resonite to perform LNL NAT Punchthrough successfully]]

pfSense

  1. Log into your pfSense web interface.
  2. In the navigation bar, click on Firewall and then NAT.
  3. Click on the Outbound tab.
  4. Under Outbound NAT Mode, select Hybrid Outbound NAT rule generation. and click Save.
  5. Next, click the first Add button underneath the Mappings section.
  6. Next to Source, change the Type dropdown from "Network" to "Any".
  7. Scroll down and check the checkbox labelled Static Port.
  8. Click Save at the bottom of the page.
  9. Click the Apply Changes button at the top of the page.

[[File:OPNsense NAT Configuration.png|alt=Screenshot showing how OPNsense's Outbound NAT must be configured to allow Resonite's LNL NAT Punchthrough to work.|thumb|OPNsense router configured to allow Resonite to perform LNL NAT Punchthrough successfully]]

OPNsense

  1. Log into your OPNsense web interface.
  2. In the left sidebar, click Firewall, NAT, and then Outbound.
  3. Under Mode, select Hybrid Outbound NAT rule generation and click Save.
  4. The Manual rules section will appear. Click the + icon on the far right side.
  5. Scroll down and check the checkbox labelled Static-port.
  6. Click Save at the bottom of the page.
  7. Click the Apply changes button at the top of the page.

Support du relais pour NAT strict

Resonite permet aux utilisateurs derrière un NAT strict a se connecter a d'autre utilisateurs en utilisant un relais. Cette méthode fonctionne bien pour un usage occasionnel mais ne permet pas une performance optimale dépendant de la localisation géographique et du status du relais.

Vous pouvez voir si vous vous connectez depuis un relais par la présence du texte "Relais LNL" apparaissant sous le message "Chargement..." en vous connectant a un monde. La présence du texte "Relais LNL" en rejoignant un monde dit que Resonite n'a pas pu se connecter directement au monde et qu'un relais a été utilisé.

La présence de ce texte indique que soit vous, soit l'hôte du monde (ou les deux) soit derrière un NAT strict. Si vous voyez ce message a chaque fois, il y a de bonnes chances que ce soit vous.

Il est recommandé d'utiliser un NAT modéré/de type 2 pour éviter d'avoir a dépendre sur un relais. Voir configuration du routeur pour plus d'informations.

uPNP/NAT-PMP et ouverture de ports

Resonite ne supporte pas l'ouverture de port via uPNP/NAT-PMP.

Retrieved from "https://wiki.resonite.com/index.php?title=Networking_information/fr&oldid=108507"
Last modified
This page was last edited on 12 August 2025, at 07:50.