mnh

mnh

LEIA-ME | 中文文档

!!! Nota: mnh está atualmente em desenvolvimento, as APIs e command line options podem não ser compatíveis com versões anteriores!!!

Introdução

mnh é uma ferramenta que torna possível a exposição de uma porta atrás do NAT.

mnh produzirá um par ip:port para o seu servidor NAT que pode ser usado para acesso público.

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

Uso

Pré-solicitações

• O tipo de rede do seu servidor deve ser Full-cone NAT.

  Se você não sabe o que isso significa, não se preocupe, apenas continue.

• Se o seu servidor estiver protegido por um firewall ou roteador doméstico, você provavelmente precisará habilitar o UPnP ou encaminhar a porta para o seu servidor no roteador, pois eles podem bloquear todo o tráfego de entrada.

Configure um servidor de ajuda

Por favor, verifique mnh_server.

Atualmente, apenas o protocolo mnhv1 é suportado; mais protocolos serão adicionados no futuro, como o STUN.

Corra mnh

 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

Exemplo:

Execute um servidor Web para teste:

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

Execute um servidor UDP Echo para teste:

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

Exponha um servidor web local:

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

mnh tentará solicitar que o roteador faça o encaminhamento de porta com protocolo upnp por padrão.

Se falhar, será exibido um notice .

Você pode desabilitar essas duas funções set --routerForward none , certifique-se de ter configurado o encaminhamento de porta corretamente. (Ver pré-solicitações)

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