Ga naar hoofdinhoud

Mudcat

Inleiding​

Mudcat is een dienst van Mudfish Networks voor het delen van HTTP-, TCP- en UDP-poorten. Het doel is een dienst aan te bieden met een vergelijkbare toepassing als https://ngrok.io.

Hiermee kun je eenvoudig een dienst in je interne netwerk van buitenaf toegankelijk maken. Momenteel worden de volgende protocollen ondersteund:

  • HTTP
  • TCP
  • UDP

Je kunt het eenvoudig met één opdracht installeren en gebruiken.

Downloaden​

Je kunt het programma downloaden op https://www.mudcat.io/.

Voor de gebruiker bestaat mudcat uit één uitvoerbaar bestand, zodat downloaden en starten eenvoudig is.

Startopties van mudcat​

Wanneer je mudcat start, zie je de onderstaande uitvoer. De precieze bediening verschilt per opdracht.

$ ./mudcat 
Usage: mudcat [-vV] <command> [<args>]

Options:
    -v                           # Increase the verbose level.
    -V, --version                # Show the version.

Commands:
    http                         # Create a HTTP tunnel.
    node                         # Show the mudcat nodes.
    tcp                          # Create a TCP tunnel.
    udp                          # Create a UDP tunnel.

De volgende opdrachten zijn beschikbaar:

  • http

    HTTP-poorten doorsturen.

  • node

    Informatie tonen over de mudcat-knooppunten die voor het doorsturen beschikbaar zijn.

  • tcp

    TCP-poorten doorsturen.

  • UDP

    UDP-poorten doorsturen.

Met ./mudcat <command> -h kun je aanvullende hulp voor de betreffende opdracht bekijken.

De opdracht mudcat http​

Deze opdracht biedt HTTP-doorsturing. Je gebruikt haar doorgaans om een dienst die je intern ontwikkelt eenvoudig extern toegankelijk te maken.

$ ./mudcat http -h
Usage: mudcat http [options]
    --domain <domain>            # Specify the domain name to access.
    --local-addr <ip>            # Specify the local IP to connect. Default
                                 #   value is 127.0.0.1
    --local-port <port>          # Specify the local port. Default value is 80.
    --node-cc <cc>               # Specify the country code to hint the
                                 #   selection of mudcat nodes.
    --node-id <nid>              # Specify the unique ID of mudcat node.

De volgende opties zijn beschikbaar:

  • --domain <domain>

    Hiermee kies je zelf een domein in plaats van een willekeurig adres, dat doorgaans uit cijfers bestaat. Met --domain abc krijg je bijvoorbeeld abc.mudcat.io toegewezen.

  • --local-addr <ip>

    Het lokale IPv4-adres waarnaar HTTP wordt doorgestuurd. De standaardwaarde is 127.0.0.1.

    Dit hoeft geen intern netwerkadres te zijn. Je kunt ook een ander extern, publiek IP-adres opgeven.

  • --local-port <port>

    De lokale poort waarnaar HTTP wordt doorgestuurd. De standaardwaarde is 80.

  • --node-cc <cc>

    De landcode van het gewenste mudcat-knooppunt. Met JP wordt bijvoorbeeld automatisch een knooppunt in Japan toegewezen.

  • --node-id <nid>

    De unieke ID van het gewenste mudcat-knooppunt. Je kunt de unieke ID's opvragen met mudcat node.

De opdracht mudcat node​

Met deze opdracht haal je informatie over mudcat-knooppunten op.

$ ./mudcat node -h
Usage: mudcat node [--json-raw]
    --json-raw                   # Prints the raw JSON output.

Met ./mudcat node zie je de lijst met momenteel actieve mudcat-knooppunten. De volgende optie is beschikbaar:

  • --json-raw

    Geeft de knooppuntenlijst weer in JSON-formaat.

De opdracht mudcat tcp​

Deze opdracht biedt TCP-doorsturing.

$ ./mudcat tcp -h
Usage: mudcat tcp [options]
    --conn-uuid <uuid>           # Set the connection UUID to reuse.
    --domain <domain>            # Specify the domain name to access.
    --local-addr <ip>            # Specify the local IP to connect. Default
                                 #   value is 127.0.0.1
    --local-port <port>          # Specify the local port. If not specified,
                                 #   --remote-port value will be used.
    --node-cc <cc>               # Specify the country code to hint the
                                 #   selection of mudcat nodes.
    --node-id <nid>              # Specify the unique ID of mudcat node.
    --remote-port <port>         # Specify the remote port.

De volgende opties zijn beschikbaar:

  • --conn-uuid <uuid>

    Hiermee kun je een eerder gebruikte externe poort opnieuw gebruiken.

    Als je een toegewezen externe poort gebruikt en daarna de verbinding verbreekt, kun je die poort normaal gesproken niet opnieuw gebruiken totdat de bijbehorende middelen zijn vrijgegeven.

    Als je de vorige Connection UUID kent, kun je die externe poort echter direct opnieuw gebruiken.

  • --domain <domain>

    Hiermee kies je zelf een domein in plaats van een willekeurig adres, dat doorgaans uit cijfers bestaat. Met --domain abc krijg je bijvoorbeeld abc.mudcat.io toegewezen.

  • --local-addr <ip>

    Het lokale IPv4-adres waarnaar TCP wordt doorgestuurd. De standaardwaarde is 127.0.0.1.

    Dit hoeft geen intern netwerkadres te zijn. Je kunt ook een ander extern, publiek IP-adres opgeven.

  • --local-port <port>

    De lokale poort waarnaar TCP wordt doorgestuurd. Als je deze optie niet opgeeft, wordt de waarde van --remote-port <port> gebruikt.

  • --node-cc <cc>

    De landcode van het gewenste mudcat-knooppunt. Met JP wordt bijvoorbeeld automatisch een knooppunt in Japan toegewezen.

  • --node-id <nid>

    De unieke ID van het gewenste mudcat-knooppunt. Je kunt de unieke ID's opvragen met mudcat node.

  • --remote-port <port>

    De TCP-poort waarop het mudcat-knooppunt luistert.

De opdracht mudcat udp​

Deze opdracht biedt UDP-doorsturing.

$ ./mudcat udp -h
Usage: mudcat udp [options]
    --conn-uuid <uuid>           # Set the connection UUID to reuse.
    --domain <domain>            # Specify the domain name to access.
    --local-addr <ip>            # Specify the local IP to connect. Default
                                 #   value is 127.0.0.1
    --local-port <port>          # Specify the local port. If not specified,
                                 #   --remote-port value will be used.
    --node-cc <cc>               # Specify the country code to hint the
                                 #   selection of mudcat nodes.
    --node-id <nid>              # Specify the unique ID of mudcat node.
    --remote-port <port>         # Specify the remote port.

De volgende opties zijn beschikbaar:

  • --conn-uuid <uuid>

    Hiermee kun je een eerder gebruikte externe poort opnieuw gebruiken.

    Als je een toegewezen externe poort gebruikt en daarna de verbinding verbreekt, kun je die poort normaal gesproken niet opnieuw gebruiken totdat de bijbehorende middelen zijn vrijgegeven.

    Als je de vorige Connection UUID kent, kun je die externe poort echter direct opnieuw gebruiken.

  • --domain <domain>

    Hiermee kies je zelf een domein in plaats van een willekeurig adres, dat doorgaans uit cijfers bestaat. Met --domain abc krijg je bijvoorbeeld abc.mudcat.io toegewezen.

  • --local-addr <ip>

    Het lokale IPv4-adres waarnaar UDP wordt doorgestuurd. De standaardwaarde is 127.0.0.1.

    Dit hoeft geen intern netwerkadres te zijn. Je kunt ook een ander extern, publiek IP-adres opgeven.

  • --local-port <port>

    De lokale poort waarnaar UDP wordt doorgestuurd. Als je deze optie niet opgeeft, wordt de waarde van --remote-port <port> gebruikt.

  • --node-cc <cc>

    De landcode van het gewenste mudcat-knooppunt. Met JP wordt bijvoorbeeld automatisch een knooppunt in Japan toegewezen.

  • --node-id <nid>

    De unieke ID van het gewenste mudcat-knooppunt. Je kunt de unieke ID's opvragen met mudcat node.

  • --remote-port <port>

    De UDP-poort waarop het mudcat-knooppunt luistert.

Releaseopmerkingen​

Er zijn geen releasevermeldingen vanaf 2025-10-16 in de brondocumentatie. Bekijk de volledige Koreaanse releasegeschiedenis voor oudere versies.