Passa al contenuto principale

Mudcat

Introduzione​

Mudcat è il servizio di condivisione delle porte HTTP/TCP/UDP offerto da Mudfish Networks. Il suo obiettivo è offrire un servizio con finalità simili a https://ngrok.io.

Permette di esporre facilmente all’esterno servizi che si trovano in una rete interna. Supporta attualmente:

  • HTTP
  • TCP
  • UDP

L’installazione e l’utilizzo sono semplici e richiedono un solo comando.

Download​

Scarica il programma da https://www.mudcat.io/.

Dal punto di vista dell’utente, Mudcat è costituito da un unico eseguibile, semplice da scaricare e avviare.

Opzioni di esecuzione​

Avviando Mudcat compare il seguente aiuto. L’utilizzo varia in base al comando.

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

I comandi disponibili sono:

  • http

    Inoltra una porta HTTP.

  • node

    Mostra le informazioni sui nodi Mudcat utilizzabili per l’inoltro.

  • tcp

    Inoltra una porta TCP.

  • UDP

    Inoltra una porta UDP.

Esegui ./mudcat <command> -h per visualizzare l’aiuto specifico di un comando.

Comando mudcat http​

Offre un servizio di inoltro HTTP. Normalmente viene utilizzato per esporre all’esterno un servizio sviluppato nella rete interna.

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

Le opzioni disponibili sono:

  • --domain <domain>

    Permette di scegliere il dominio anziché riceverne uno casuale, solitamente numerico. Ad esempio, con --domain abc viene assegnato abc.mudcat.io.

  • --local-addr <ip>

    Specifica l’indirizzo IPv4 locale verso cui inoltrare HTTP. Il valore predefinito è 127.0.0.1.

    Non deve necessariamente essere un indirizzo della rete interna: puoi indicare anche un IP pubblico remoto.

  • --local-port <port>

    Specifica la porta locale HTTP. Il valore predefinito è 80.

  • --node-cc <cc>

    Specifica il codice del paese del nodo Mudcat. Ad esempio, JP assegna automaticamente un nodo in Giappone.

  • --node-id <nid>

    Specifica l’ID univoco del nodo da utilizzare. Puoi ottenere gli ID con mudcat node.

Comando mudcat node​

Recupera le informazioni sui nodi Mudcat.

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

Esegui ./mudcat node per visualizzare l’elenco dei nodi attualmente operativi. È disponibile questa opzione:

  • --json-raw

    Mostra l’elenco in formato JSON.

Comando mudcat tcp​

Offre un servizio di inoltro 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.

Le opzioni disponibili sono:

  • --conn-uuid <uuid>

    Permette di riutilizzare una porta remota usata in precedenza.

    Normalmente, dopo la disconnessione, una porta remota assegnata non può essere riutilizzata finché la risorsa non viene rilasciata. Se conosci il precedente Connection UUID, puoi riutilizzarla immediatamente.

  • --domain <domain>

    Permette di scegliere il dominio anziché riceverne uno casuale, solitamente numerico. Ad esempio, con --domain abc viene assegnato abc.mudcat.io.

  • --local-addr <ip>

    Specifica l’indirizzo IPv4 locale verso cui inoltrare TCP. Il valore predefinito è 127.0.0.1.

    Non deve necessariamente essere un indirizzo interno: puoi indicare anche un IP pubblico remoto.

  • --local-port <port>

    Specifica la porta locale TCP. Se omessa, viene utilizzato il valore di --remote-port <port>.

  • --node-cc <cc>

    Specifica il codice del paese del nodo Mudcat. Ad esempio, JP assegna automaticamente un nodo in Giappone.

  • --node-id <nid>

    Specifica l’ID univoco del nodo da utilizzare. Puoi ottenere gli ID con mudcat node.

  • --remote-port <port>

    Specifica la porta TCP su cui il nodo Mudcat rimane in ascolto.

Comando mudcat udp​

Offre un servizio di inoltro 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.

Le opzioni disponibili sono:

  • --conn-uuid <uuid>

    Permette di riutilizzare una porta remota usata in precedenza.

    Normalmente, dopo la disconnessione, una porta remota assegnata non può essere riutilizzata finché la risorsa non viene rilasciata. Se conosci il precedente Connection UUID, puoi riutilizzarla immediatamente.

  • --domain <domain>

    Permette di scegliere il dominio anziché riceverne uno casuale, solitamente numerico. Ad esempio, con --domain abc viene assegnato abc.mudcat.io.

  • --local-addr <ip>

    Specifica l’indirizzo IPv4 locale verso cui inoltrare UDP. Il valore predefinito è 127.0.0.1.

    Non deve necessariamente essere un indirizzo interno: puoi indicare anche un IP pubblico remoto.

  • --local-port <port>

    Specifica la porta locale UDP. Se omessa, viene utilizzato il valore di --remote-port <port>.

  • --node-cc <cc>

    Specifica il codice del paese del nodo Mudcat. Ad esempio, JP assegna automaticamente un nodo in Giappone.

  • --node-id <nid>

    Specifica l’ID univoco del nodo da utilizzare. Puoi ottenere gli ID con mudcat node.

  • --remote-port <port>

    Specifica la porta UDP su cui il nodo Mudcat rimane in ascolto.

Note di rilascio​

La traduzione delle note di rilascio copre l’ultimo anno, dal 16 ottobre 2025. Il documento di origine non contiene voci in questo periodo. Consulta la cronologia completa in coreano per le versioni precedenti.