mnh

mhh

LISEZMOI | 中文文档

!!! Remarque : mnh est actuellement en développement, les APIs et command line options peuvent ne pas être rétrocompatibles !!!

Introduction

mnh est un outil qui permet d'exposer un port derrière NAT.

mnh produira une paire ip:port pour votre serveur NAT qui pourra être utilisée pour l'accès public.

 --------------------------------
| Help Server (NOT behind NAT) |  <------(query for ip:port pair)-------------
--------------------------------                                             |
        ^                                                                    |
        |                                                                    |
        |       ---------(Use some way to send ip:port pair)-------------    |
        |       |                                                       | or |
        |       |                                                       ↓    |
------------------------                  ~~~~~~~~~~~~                ----------
| Service (behind NAT) |    <--------     { Internet }   <----------  | Guests |
------------------------                  ~~~~~~~~~~~~                ----------

Usage

Pré-demandes

• Le type de réseau de votre serveur doit être NAT à cône complet.

  Si vous ne savez pas ce que cela signifie, ne vous inquiétez pas, continuez.

• Si votre serveur est derrière un pare-feu ou un routeur domestique, vous devrez probablement activer UPnP ou effectuer une redirection de port vers votre serveur sur votre routeur, car ils peuvent bloquer tout le trafic entrant.

Configurer un serveur d'aide

Veuillez vérifier mnh_server.

Seul le protocole mnhv1 est actuellement pris en charge, d'autres protocoles seront ajoutés à l'avenir, tels que STUN.

Cours mhn

 Usage:
  mnh {tcp|udp} --server <server> [flags]

Flags:
  -s, --server string    Help server address(Example: "server.com", "server.com:6641")
                           If only specify hostname, it will try SRV resolve.
                           If SRV failed, it will use default port(6641).
  -i, --id string        A unique id to identify your machine

  -m, --mode string      Run mode.
                           TCP support: demoWeb proxy (default "demoWeb")
                           UDP support: demoEcho proxy (default "demoEcho")
  -p, --port int         The local hole port which incoming traffics access to
  -t, --service string   Target service address. Only need in proxy mode (default "127.0.0.1:80")

  -r, --routerForward    A comma-split list which will be used sequentially to request router to do port forwarding (default: "upnp,notice")
                           upnp: UPnP protocol
                           notice: Will notice you to do port forwarding manually
                           none: Do port forwarding manually

  -x, --event-hook       Execute command when event triggered:
                           escape:
                             %%: percent sign
                             %e: Event: connecting fail success disconnected
                             %m: Error message
                             %p: Local hole port
                             %a: Hole addr

  -h, --help             help for mnh

Exemple:

Exécutez un serveur Web pour le test :

 ./mnh tcp --server server.com --id test

Exécutez un serveur UDP Echo pour le test :

 ./mnh udp --server server.com --id udpEcho --mode demoEcho

Exposez un serveur Web local :

 ./mnh tcp --server server.com --id web --mode proxy --service 127.0.0.1:80

mnh tentera de demander au routeur d'effectuer la redirection de port avec le protocole upnp par défaut.

En cas d'échec, un notice s'affichera.

Vous pouvez désactiver ces deux fonctions en set --routerForward none , assurez-vous d'avoir correctement configuré la redirection de port. (Voir Pré-demandes)

 ./mnh tcp --server server.com --id web --mode proxy --service 127.0.0.1:80 --port 8888 --routerForward none