Негізгі мазмұнға өту

Mudcat

Кіріспе​

Mudfish Networks ұсынатын HTTP/TCP/UDP порттарын бөлісу қызметі. https://ngrok.io қызметіне ұқсас мақсаттағы шешімді ұсынуды көздейді.

Осы қызметті пайдалану арқылы ішкі желідегі (local network) қызметтерді сыртқы желіге оңай бөлісуге болады. Қазіргі уақытта келесі хаттамаларға қолдау көрсетіледі:

  • HTTP

  • TCP

  • UDP

Бар болғаны 1 пәрмен арқылы оңай орнатып, пайдалануға болады.

Жүктеу​

Бағдарламаны https://www.mudcat.io/ сайтынан жүктеп алуға болады.

mudcat бағдарламасы пайдаланушы тұрғысынан 1 ғана орындалатын файлдан тұратындықтан, оны жүктеп алып іске қосу өте оңай.

mudcat іске қосу параметрлері​

mudcat бағдарламасын іске қосқан кезде келесідей экранды көресіз. Негізінен mudcat қолданылуы орындалатын пәрменге байланысты сәл өзгешеленеді:

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

Қазіргі уақытта қолдау көрсетілетін пәрмендер мыналар:

  • http

    HTTP портын қайта бағыттау (forwarding) қажет болғанда қолданылады.

  • node

    Қайта бағыттау үшін қолданылатын mudcat ретранслятор түйіндерінің ақпаратын көрсетеді.

  • tcp

    TCP портын қайта бағыттау қажет болғанда қолданылады.

  • udp

    UDP портын қайта бағыттау қажет болғанда қолданылады.

Әдетте ./mudcat <command> -h пәрменін орындау арқылы сол пәрменге қатысты қосымша анықтамалық ақпаратты көре аласыз.

mudcat http пәрмені​

Бұл пәрмен HTTP қайта бағыттау қызметін ұсыну үшін қолданылады. Әдетте ішкі желіде әзірленіп жатқан қызметті сыртқа уақытша көрсету қажет болған жағдайда қолданылатын пәрмен.

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

Қолдау көрсетілетін ішкі параметрлер мыналар:

  • --domain <domain>

    Бұл параметр көрсетілген жағдайда кездейсоқ домен мекенжайының (әдетте сандардан тұратын) орнына пайдаланушы өзі қалаған доменді көрсете алады. Мысалы, --domain abc деп көрсетілсе, берілетін домен мекенжайы abc.mudcat.io болады.

  • --local-addr <ip>

    HTTP қайта бағытталатын жергілікті мекенжайды (IPv4) көрсетеді. Әдепкі мәні: 127.0.0.1.

    Дегенмен, бұл мән міндетті түрде ішкі желі мекенжайы болуы шарт емес. Қашықтағы басқа Public IP-ді көрсеткіңіз келсе, сол IP мекенжайын көрсетуге болады.

  • --local-port <port>

    HTTP қайта бағытталатын жергілікті портты көрсетеді. Әдепкі мәні: 80.

  • --node-cc <cc>

    Пайдаланғыңыз келетін mudcat ретранслятор түйінінің ел кодын көрсетуге болады. Мысалы, ел кодын JP деп көрсетсеңіз, Жапонияда орналасқан mudcat ретранслятор түйіні автоматты түрде тағайындалады.

  • --node-id <nid>

    Пайдаланғыңыз келетін mudcat ретранслятор түйінінің бірегей ID-ін көрсетуге болады. Әрбір ретранслятор түйіннің бірегей ID-ін mudcat node пәрмені арқылы алуға болады.

mudcat node пәрмені​

Бұл пәрмен mudcat ретранслятор түйіндері туралы ақпаратты алу үшін қолданылады.

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

./mudcat node пәрменін орындаған кезде қазіргі уақытта жұмыс істеп тұрған mudcat ретранслятор түйіндерінің тізімін көре аласыз. Қолдау көрсетілетін ішкі параметр:

  • --json-raw

    Ретранслятор түйіндер тізімін JSON пішімінде шығарады.

mudcat tcp пәрмені​

Бұл пәрмен 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.

Қолдау көрсетілетін ішкі параметрлер мыналар:

  • --conn-uuid <uuid>

    Бұл параметр бұрын қолданылған қашықтағы портты (remote port) қайта пайдалану қажет болған жағдайда қолданылады.

    Әдетте тағайындалған қашықтағы портты пайдаланып болған соң қосылым ажыратылса, сол қашықтағы порт ресурстары босатылғанша оны қайта қолдану мүмкін болмайды.

    Дегенмен, алдыңғы Connection UUID мәнін білсеңіз, сол қашықтағы портты дереу қайта пайдалануға болады.

  • --domain <domain>

    Бұл параметр көрсетілген жағдайда кездейсоқ домен мекенжайының орнына пайдаланушы өзі тікелей домен көрсете алады. Мысалы, --domain abc деп көрсетілсе, берілетін домен abc.mudcat.io болады.

  • --local-addr <ip>

    TCP қайта бағытталатын жергілікті мекенжайды (IPv4) көрсетеді. Әдепкі мәні: 127.0.0.1.

    Дегенмен, бұл мән міндетті түрде ішкі желі мекенжайы болуы шарт емес. Қашықтағы басқа Public IP-ді көрсеткіңіз келсе, сол IP мекенжайын көрсетуге болады.

  • --local-port <port>

    TCP қайта бағытталатын жергілікті портты көрсетеді. Егер бұл параметр көрсетілмесе, --remote-port <port> мәні жергілікті порт ретінде де қолданылады.

  • --node-cc <cc>

    Пайдаланғыңыз келетін mudcat ретранслятор түйінінің ел кодын көрсетуге болады. Мысалы, ел кодын JP деп көрсетсеңіз, Жапониядағы mudcat ретранслятор түйіні автоматты түрде тағайындалады.

  • --node-id <nid>

    Пайдаланғыңыз келетін mudcat ретранслятор түйінінің бірегей ID-ін көрсете аласыз. Әрбір түйіннің бірегей ID-ін mudcat node пәрмені арқылы көруге болады.

  • --remote-port <port>

    mudcat ретранслятор серверінде тыңдалатын (listening) қашықтағы TCP портын көрсетеді.

mudcat udp пәрмені​

Бұл пәрмен 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.

Қолдау көрсетілетін ішкі параметрлер мыналар:

  • --conn-uuid <uuid>

    Бұл параметр бұрын қолданылған қашықтағы портты қайта пайдалану қажет болған жағдайда қолданылады.

    Әдетте тағайындалған қашықтағы портты пайдаланып байланыс ажыратылса, сол қашықтағы порт ресурстары босатылғанша оны қайта қолдану мүмкін болмайды.

    Бірақ алдыңғы Connection UUID мәні белгілі болса, сол қашықтағы портты бірден қайта пайдалануға болады.

  • --domain <domain>

    Бұл параметр көрсетілген кезде кездейсоқ домен мекенжайының орнына пайдаланушы өзі тікелей домен көрсете алады. Мысалы, --domain abc деп көрсетілгенде, берілетін домен abc.mudcat.io болады.

  • --local-addr <ip>

    UDP қайта бағытталатын жергілікті мекенжайды (IPv4) көрсетеді. Әдепкі мәні: 127.0.0.1.

    Бұл мәннің міндетті түрде ішкі желі мекенжайы болуы шарт емес. Қашықтағы басқа Public IP-ді көрсеткіңіз келсе, сол IP мекенжайын көрсетуге болады.

  • --local-port <port>

    UDP қайта бағытталатын жергілікті портты көрсетеді. Егер бұл параметр көрсетілмесе, --remote-port <port> мәні қолданылады.

  • --node-cc <cc>

    Пайдаланғыңыз келетін mudcat ретранслятор түйінінің ел кодын көрсетуге болады. Мысалы, ел кодын JP деп көрсетсеңіз, Жапонияда орналасқан mudcat түйіні автоматты түрде тағайындалады.

  • --node-id <nid>

    Пайдаланғыңыз келетін mudcat ретранслятор түйінінің бірегей ID-ін көрсетуге болады. Әр түйіннің бірегей ID-ін mudcat node пәрмені арқылы анықтауға болады.

  • --remote-port <port>

    mudcat ретранслятор серверінде тыңдалатын қашықтағы UDP портын көрсетеді.

Шығарылым жазбалары​

2025-10-16 күнінен басталатын осы аударма кезеңінде шығарылымдар болған жоқ. Алдыңғы нұсқалар тарихын толық кәрісше шығарылым жазбаларынан көре аласыз.