Aller au contenu principal

Mudcat

Présentation​

Mudcat est un service de partage de ports HTTP/TCP/UDP fourni par Mudfish Networks. Il vise un usage similaire à https://ngrok.io.

Il permet de rendre facilement accessible depuis l’extérieur un service situé sur un réseau privé. Les protocoles actuellement pris en charge sont :

  • HTTP
  • TCP
  • UDP

Une seule commande suffit pour l’installer et l’utiliser facilement.

Téléchargement​

Téléchargez le programme sur https://www.mudcat.io/.

Pour l’utilisateur, mudcat se compose d’un unique exécutable, facile à télécharger et à lancer.

Options de lancement de mudcat​

Au lancement, l’écran suivant apparaît. L’utilisation varie légèrement selon la commande choisie.

$ ./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.

Les commandes disponibles sont :

  • http : rediriger un port HTTP.
  • node : afficher les informations des nœuds mudcat utilisables pour la redirection.
  • tcp : rediriger un port TCP.
  • UDP : rediriger un port UDP.

Exécutez ./mudcat <command> -h pour consulter l’aide propre à chaque commande.

Commande mudcat http​

Cette commande fournit une redirection HTTP. Elle sert généralement à exposer simplement à l’extérieur un service développé en interne.

$ ./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.

Options disponibles :

  • --domain <domain>

    Choisissez le domaine au lieu de recevoir une adresse aléatoire, généralement numérique. Par exemple, --domain abc attribue abc.mudcat.io.

  • --local-addr <ip>

    Définit l’adresse IPv4 locale vers laquelle rediriger HTTP. La valeur par défaut est 127.0.0.1.

    Cette adresse ne doit pas obligatoirement appartenir au réseau privé : vous pouvez aussi indiquer une adresse IP publique distante.

  • --local-port <port>

    Définit le port local HTTP. La valeur par défaut est 80.

  • --node-cc <cc>

    Définit le code pays du nœud mudcat souhaité. Par exemple, JP attribue automatiquement un nœud au Japon.

  • --node-id <nid>

    Définit l’identifiant unique du nœud souhaité. Obtenez ces identifiants avec mudcat node.

Commande mudcat node​

Cette commande récupère les informations des nœuds mudcat.

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

./mudcat node affiche les nœuds actuellement en service. Option disponible :

  • --json-raw

    Affiche la liste au format JSON.

Commande mudcat tcp​

Cette commande fournit une redirection TCP.

$ ./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.

Options disponibles :

  • --conn-uuid <uuid>

    Réutilise un port distant utilisé précédemment.

    Après la fermeture d’une connexion, le port distant attribué reste normalement indisponible jusqu’à la libération des ressources.

    Si vous connaissez le Connection UUID précédent, vous pouvez réutiliser ce port immédiatement.

  • --domain <domain>

    Choisissez le domaine au lieu de recevoir une adresse aléatoire, généralement numérique. Par exemple, --domain abc attribue abc.mudcat.io.

  • --local-addr <ip>

    Définit l’adresse IPv4 locale vers laquelle rediriger TCP. La valeur par défaut est 127.0.0.1.

    Cette adresse ne doit pas obligatoirement appartenir au réseau privé : vous pouvez aussi indiquer une adresse IP publique distante.

  • --local-port <port>

    Définit le port local TCP. Si cette option est absente, la valeur de --remote-port <port> est utilisée.

  • --node-cc <cc>

    Définit le code pays du nœud souhaité. Par exemple, JP attribue automatiquement un nœud au Japon.

  • --node-id <nid>

    Définit l’identifiant unique du nœud souhaité. Obtenez ces identifiants avec mudcat node.

  • --remote-port <port>

    Définit le port TCP d’écoute sur le nœud mudcat.

Commande mudcat udp​

Cette commande fournit une redirection UDP.

$ ./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.

Options disponibles :

  • --conn-uuid <uuid>

    Réutilise un port distant utilisé précédemment.

    Après la fermeture d’une connexion, le port distant attribué reste normalement indisponible jusqu’à la libération des ressources.

    Si vous connaissez le Connection UUID précédent, vous pouvez réutiliser ce port immédiatement.

  • --domain <domain>

    Choisissez le domaine au lieu de recevoir une adresse aléatoire, généralement numérique. Par exemple, --domain abc attribue abc.mudcat.io.

  • --local-addr <ip>

    Définit l’adresse IPv4 locale vers laquelle rediriger UDP. La valeur par défaut est 127.0.0.1.

    Cette adresse ne doit pas obligatoirement appartenir au réseau privé : vous pouvez aussi indiquer une adresse IP publique distante.

  • --local-port <port>

    Définit le port local UDP. Si cette option est absente, la valeur de --remote-port <port> est utilisée.

  • --node-cc <cc>

    Définit le code pays du nœud souhaité. Par exemple, JP attribue automatiquement un nœud au Japon.

  • --node-id <nid>

    Définit l’identifiant unique du nœud souhaité. Obtenez ces identifiants avec mudcat node.

  • --remote-port <port>

    Définit le port UDP d’écoute sur le nœud mudcat.

Notes de version​

Cette section couvre uniquement la dernière année, à partir du 16 octobre 2025. Le document source ne contient aucune version publiée pendant cette période. Consultez l’historique complet en coréen pour les versions antérieures.