Перейти до основного вмісту

Mudcat

Вступ​

Це сервіс спільного доступу до портів HTTP/TCP/UDP від Mudfish Networks. Його мета — надавати послуги, подібні за призначенням до https://ngrok.io.

За допомогою сервісу легко зробити внутрішню мережеву службу доступною ззовні. Наразі підтримуються такі протоколи:

  • HTTP

  • TCP

  • UDP

Встановлення й використання прості: достатньо 1 команди.

Завантаження​

Програму можна завантажити з https://www.mudcat.io/.

Для користувача mudcat складається лише з 1 виконуваного файлу, тому його легко завантажити й запустити.

Параметри запуску 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-порту.

  • 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>

    Задає локальну IPv4-адресу для переадресації HTTP. Типове значення — 127.0.0.1.

    Адреса не обов'язково має належати внутрішній мережі. Можна вказати й іншу віддалену публічну IP-адресу.

  • --local-port <port>

    Задає локальний порт для переадресації HTTP. Типове значення — 80.

  • --node-cc <cc>

    Задає код країни потрібного ретранслятора mudcat. Наприклад, JP автоматично призначає ретранслятор у Японії.

  • --node-id <nid>

    Задає унікальний ID потрібного ретранслятора mudcat. 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>

    Дає змогу повторно використати віддалений порт, що використовувався раніше.

    Зазвичай після розриву з'єднання призначений віддалений порт недоступний, доки його ресурси не буде звільнено.

    Проте, знаючи попередній Connection UUID, можна повторно використати цей порт одразу.

  • --domain <domain>

    Дає змогу задати власний домен замість довільної адреси, зазвичай числової. Наприклад, --domain abc призначає домен abc.mudcat.io.

  • --local-addr <ip>

    Задає локальну IPv4-адресу для переадресації TCP. Типове значення — 127.0.0.1.

    Адреса не обов'язково має належати внутрішній мережі. Можна вказати й іншу віддалену публічну IP-адресу.

  • --local-port <port>

    Задає локальний порт для переадресації TCP. Якщо не вказано, використовується значення --remote-port <port>.

  • --node-cc <cc>

    Задає код країни потрібного ретранслятора mudcat. Наприклад, JP автоматично призначає ретранслятор у Японії.

  • --node-id <nid>

    Задає унікальний ID потрібного ретранслятора mudcat. ID кожного ретранслятора можна отримати командою mudcat node.

  • --remote-port <port>

    Задає TCP-порт прослуховування на ретрансляторі mudcat.

Команда 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>

    Задає локальну IPv4-адресу для переадресації UDP. Типове значення — 127.0.0.1.

    Адреса не обов'язково має належати внутрішній мережі. Можна вказати й іншу віддалену публічну IP-адресу.

  • --local-port <port>

    Задає локальний порт для переадресації UDP. Якщо не вказано, використовується значення --remote-port <port>.

  • --node-cc <cc>

    Задає код країни потрібного ретранслятора mudcat. Наприклад, JP автоматично призначає ретранслятор у Японії.

  • --node-id <nid>

    Задає унікальний ID потрібного ретранслятора mudcat. ID кожного ретранслятора можна отримати командою mudcat node.

  • --remote-port <port>

    Задає UDP-порт прослуховування на ретрансляторі mudcat.

Примітки до випусків​

За період від 2025-10-16 включно записів про випуски немає. Старіші записи доступні в повній історії корейською.