Lumaktaw sa pangunahing nilalaman

Mudcat (mudcat)

Panimula​

Ito ay isang serbisyo sa pagbabahagi ng HTTP/TCP/UDP port na ibinibigay ng Mudfish Networks. Layunin nitong magbigay ng serbisyong may katulad na layunin sa https://ngrok.io.

Sa paggamit ng serbisyong ito, madali mong maibabahagi sa labas ang mga serbisyong nasa loob ng internal network. Kasalukuyan nitong sinusuportahan ang mga sumusunod na protocol:

  • HTTP

  • TCP

  • UDP

Madali itong mai-install at magamit sa pamamagitan lamang ng 1 command.

I-download​

Maaari mong i-download ang programa sa https://www.mudcat.io/.

Dahil ang programang mudcat ay binubuo lamang ng 1 executable file mula sa pananaw ng user, madali itong mai-download at mapatakbo.

Mga Opsyon sa Pagpapatakbo ng mudcat​

Kapag pinatakbo mo ang programang mudcat, makikita mo ang sumusunod na screen. Sa pangkalahatan, bahagyang nag-iiba ang paraan ng paggamit ng mudcat depende sa command.

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

Ang mga kasalukuyang sinusuportahang command ay ang mga sumusunod:

  • http

    Magagamit kapag gusto mong mag-forward ng HTTP port.

  • node

    Ipinapakita ang impormasyon ng mga mudcat relay server na gagamitin sa pag-forward.

  • tcp

    Magagamit kapag gusto mong mag-forward ng TCP port.

  • UDP

    Magagamit kapag gusto mong mag-forward ng UDP port.

Sa pangkalahatan, kapag pinatakbo ang ./mudcat <command> -h, maaari mong suriin ang karagdagang impormasyon ng tulong (help) na ibinibigay ng naturang command.

Command na mudcat http​

Magagamit ang command na ito kapag gusto mong magbigay ng serbisyo sa pag-forward ng HTTP. Karaniwan itong ginagamit kapag gusto mo lang ilantad sa labas ang isang serbisyong ginagawa mo nang internal.

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

Ang mga sinusuportahang sub-option ay ang mga sumusunod:

  • --domain <domain>

    Kapag tinukoy ang opsyong ito, maaaring direktang tukuyin ng user ang domain sa halip na isang random na domain address (karaniwang binubuo ng mga numero). Halimbawa, kung itatakda mo ang --domain abc, ang itatalagang domain address ay magiging abc.mudcat.io.

  • --local-addr <ip>

    Tinutukoy ng opsyong ito ang lokal na address (IPv4) para sa HTTP forwarding. Ang default na halaga ay 127.0.0.1.

    Gayunpaman, hindi kinakailangang tumukoy ang halagang ito sa isang internal network address. Kung gusto mong ituro ito sa ibang remote na Public IP, maaari mong tukuyin ang IP na iyon.

  • --local-port <port>

    Tinutukoy ang lokal na port na nais i-forward sa HTTP. Ang default na halaga ay 80.

  • --node-cc <cc>

    Maaari mong tukuyin ang country code ng mudcat relay server na gusto mong gamitin. Halimbawa, kung itatakda mo ang country code sa JP, awtomatikong itatalaga ang isang mudcat relay server na nasa Japan.

  • --node-id <nid>

    Maaari mong tukuyin ang unique ID ng mudcat relay server na gusto mong gamitin. Ang unique ID ng bawat relay server ay maaaring makuha sa pamamagitan ng command na mudcat node.

Command na mudcat node​

Ginagamit ang command na ito kapag kumukuha ng impormasyon ng mudcat relay server.

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

Kapag ginamit mo ang command na ./mudcat node, makikita mo ang listahan ng mga kasalukuyang gumaganang mudcat relay server. Ang sinusuportahang sub-option ay ang sumusunod:

  • --json-raw

    Inilalabas (print) ang listahan ng mga relay server sa JSON format.

Command na mudcat tcp​

Magagamit ang command na ito kapag gusto mong magbigay ng serbisyo sa pag-forward ng 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.

Ang mga sinusuportahang sub-option ay ang mga sumusunod:

  • --conn-uuid <uuid>

    Magagamit ang opsyong ito kapag gusto mong gamitin muli ang isang remote port na ginamit na dati.

    Karaniwan, kapag naputol ang koneksyon pagkatapos gamitin ang isang nakatalagang remote port, hindi na magagamit ang remote port na iyon hangga't hindi pa napapalaya ang resource nito.

    Gayunpaman, kung alam mo ang dating Connection UUID, maaari mong gamitin muli agad ang naturang remote port.

  • --domain <domain>

    Kapag tinukoy ang opsyong ito, maaaring direktang tukuyin ng user ang domain sa halip na isang random na domain address (karaniwang binubuo ng mga numero). Halimbawa, kung itatakda mo ang --domain abc, ang itatalagang domain address ay magiging abc.mudcat.io.

  • --local-addr <ip>

    Tinutukoy ng opsyong ito ang lokal na address (IPv4) para sa TCP forwarding. Ang default na halaga ay 127.0.0.1.

    Gayunpaman, hindi kinakailangang tumukoy ang halagang ito sa isang internal network address. Kung gusto mong ituro ito sa ibang remote na Public IP, maaari mong tukuyin ang IP na iyon.

  • --local-port <port>

    Tinutukoy ang lokal na port na nais i-forward sa TCP. Kung hindi tinukoy ang opsyong ito, ang halaga ng --remote-port <port> ang gagamitin bilang impormasyon ng port.

  • --node-cc <cc>

    Maaari mong tukuyin ang country code ng mudcat relay server na gusto mong gamitin. Halimbawa, kung itatakda mo ang country code sa JP, awtomatikong itatalaga ang isang mudcat relay server na nasa Japan.

  • --node-id <nid>

    Maaari mong tukuyin ang unique ID ng mudcat relay server na gusto mong gamitin. Ang unique ID ng bawat relay server ay maaaring makuha sa pamamagitan ng command na mudcat node.

  • --remote-port <port>

    Tinutukoy ang TCP port na makikinig (listening) sa mudcat relay server.

Command na mudcat udp​

Magagamit ang command na ito kapag gusto mong magbigay ng serbisyo sa pag-forward ng 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.

Ang mga sinusuportahang sub-option ay ang mga sumusunod:

  • --conn-uuid <uuid>

    Magagamit ang opsyong ito kapag gusto mong gamitin muli ang isang remote port na ginamit na dati.

    Karaniwan, kapag naputol ang koneksyon pagkatapos gamitin ang isang nakatalagang remote port, hindi na magagamit ang remote port na iyon hangga't hindi pa napapalaya ang resource nito.

    Gayunpaman, kung alam mo ang dating Connection UUID, maaari mong gamitin muli agad ang naturang remote port.

  • --domain <domain>

    Kapag tinukoy ang opsyong ito, maaaring direktang tukuyin ng user ang domain sa halip na isang random na domain address (karaniwang binubuo ng mga numero). Halimbawa, kung itatakda mo ang --domain abc, ang itatalagang domain address ay magiging abc.mudcat.io.

  • --local-addr <ip>

    Tinutukoy ng opsyong ito ang lokal na address (IPv4) para sa UDP forwarding. Ang default na halaga ay 127.0.0.1.

    Gayunpaman, hindi kinakailangang tumukoy ang halagang ito sa isang internal network address. Kung gusto mong ituro ito sa ibang remote na Public IP, maaari mong tukuyin ang IP na iyon.

  • --local-port <port>

    Tinutukoy ang lokal na port na nais i-forward sa UDP. Kung hindi tinukoy ang opsyong ito, ang halaga ng --remote-port <port> ang gagamitin bilang impormasyon ng port.

  • --node-cc <cc>

    Maaari mong tukuyin ang country code ng mudcat relay server na gusto mong gamitin. Halimbawa, kung itatakda mo ang country code sa JP, awtomatikong itatalaga ang isang mudcat relay server na nasa Japan.

  • --node-id <nid>

    Maaari mong tukuyin ang unique ID ng mudcat relay server na gusto mong gamitin. Ang unique ID ng bawat relay server ay maaaring makuha sa pamamagitan ng command na mudcat node.

  • --remote-port <port>

    Tinutukoy ang UDP port na makikinig (listening) sa mudcat relay server.

Mga Tala sa Paglabas (Release Notes)​

Walang kasaysayan ng paglabas sa panahon ng pagsasaling ito simula 2025-10-16. Maaaring tingnan ang nakaraang kasaysayan ng bersyon sa Buong Release Notes sa Korean.