mnh

明尼苏达州

自述文件 | 中文文档

！！！注意： mnh目前正在开发中， APIs和command line options可能不向后兼容！

介绍

mnh是一个可以暴露 NAT 后面的端口的工具。

mnh将为您的 NATed 服务器生成一个ip:port对，可用于公共访问。

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

用法

预先要求

• 您的服务器的网络类型应该是 Full-cone NAT。

  如果您不知道这意味着什么，不用担心，请继续。

• 如果您的服务器位于防火墙或家用路由器后面，您可能需要启用 UPnP 或在路由器上对服务器进行端口转发，因为它们可能会阻止所有传入流量。

设置帮助服务器

请检查 mnh_server。

目前仅支持mnhv1协议，将来会添加更多协议，例如 STUN。

运行百万小时

 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

例子：

运行Web服务器进行测试：

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

运行 UDP Echo 服务器进行测试：

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

公开本地网络服务器：

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

默认情况下， mnh将尝试请求路由器使用upnp协议进行端口转发。

如果失败，会显示一条notice 。

您可以通过 set --routerForward none禁用这两个功能，确保您已正确设置端口转发。 （参见预先请求）

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