Langkau ke kandungan utama

Mudcat (mudcat)

Pengenalan​

Perkhidmatan perkongsian port HTTP/TCP/UDP yang disediakan oleh Mudfish Networks. Ia bertujuan menyediakan perkhidmatan dengan kegunaan yang serupa dengan https://ngrok.io.

Perkhidmatan ini memudahkan anda berkongsi perkhidmatan dalam rangkaian dalaman dengan pihak luar. Protokol berikut disokong pada masa ini.

  • HTTP

  • TCP

  • UDP

Pemasangan dan penggunaan mudah dilakukan dengan satu arahan.

Muat turun​

Anda boleh memuat turun program daripada https://www.mudcat.io/.

Dari sudut pengguna, mudcat terdiri daripada satu fail boleh laku sahaja, jadi ia mudah dimuat turun dan dijalankan.

Pilihan pelaksanaan mudcat​

Apabila menjalankan mudcat, anda akan melihat skrin seperti di bawah. Cara menggunakan mudcat berbeza sedikit mengikut arahan.

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

Arahan berikut disokong pada masa ini.

  • http

    Digunakan untuk memajukan port HTTP.

  • node

    Memaparkan maklumat pelayan perantara mudcat yang digunakan untuk pemajuan.

  • tcp

    Digunakan untuk memajukan port TCP.

  • UDP

    Digunakan untuk memajukan port UDP.

Jalankan ./mudcat <command> -h untuk melihat maklumat bantuan tambahan yang disediakan oleh arahan tersebut.

Arahan mudcat http​

Arahan ini digunakan untuk menyediakan perkhidmatan pemajuan HTTP. Ia biasanya digunakan untuk mendedahkan perkhidmatan yang sedang dibangunkan secara dalaman kepada pihak luar dengan mudah.

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

Pilihan tambahan berikut disokong.

  • --domain <domain>

    Dengan pilihan ini, pengguna boleh menentukan domain sendiri menggantikan alamat domain rawak (biasanya terdiri daripada nombor). Contohnya, jika anda menetapkan --domain abc, alamat domain yang diperuntukkan ialah abc.mudcat.io.

  • --local-addr <ip>

    Pilihan ini menetapkan alamat tempatan (IPv4) untuk pemajuan HTTP. Nilai lalai ialah 127.0.0.1.

    Namun, nilai ini tidak semestinya merujuk kepada alamat rangkaian dalaman. Jika anda ingin menunjuk ke IP awam jauh yang lain, anda boleh menetapkan IP tersebut.

  • --local-port <port>

    Menetapkan port tempatan untuk pemajuan HTTP. Nilai lalai ialah 80.

  • --node-cc <cc>

    Anda boleh menetapkan kod negara pelayan perantara mudcat yang ingin digunakan. Contohnya, kod negara JP memperuntukkan pelayan perantara mudcat di Jepun secara automatik.

  • --node-id <nid>

    Anda boleh menetapkan ID unik pelayan perantara mudcat yang ingin digunakan. ID unik setiap pelayan boleh diperoleh melalui arahan mudcat node.

Arahan mudcat node​

Arahan ini mendapatkan maklumat pelayan perantara mudcat.

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

Gunakan arahan ./mudcat node untuk melihat senarai pelayan perantara mudcat yang sedang beroperasi. Pilihan tambahan berikut disokong.

  • --json-raw

    Memaparkan senarai pelayan perantara dalam format JSON.

Arahan mudcat tcp​

Arahan ini digunakan untuk menyediakan perkhidmatan pemajuan 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.

Pilihan tambahan berikut disokong.

  • --conn-uuid <uuid>

    Pilihan ini digunakan untuk menggunakan semula port jauh yang pernah digunakan.

    Biasanya, selepas port jauh yang diperuntukkan digunakan dan sambungan diputuskan, port tersebut tidak boleh digunakan sehingga sumbernya dibebaskan.

    Namun, jika anda mengetahui Connection UUID terdahulu, port jauh tersebut boleh digunakan semula serta-merta.

  • --domain <domain>

    Dengan pilihan ini, pengguna boleh menentukan domain sendiri menggantikan alamat domain rawak (biasanya terdiri daripada nombor). Contohnya, jika anda menetapkan --domain abc, alamat domain yang diperuntukkan ialah abc.mudcat.io.

  • --local-addr <ip>

    Pilihan ini menetapkan alamat tempatan (IPv4) untuk pemajuan TCP. Nilai lalai ialah 127.0.0.1.

    Namun, nilai ini tidak semestinya merujuk kepada alamat rangkaian dalaman. Jika anda ingin menunjuk ke IP awam jauh yang lain, anda boleh menetapkan IP tersebut.

  • --local-port <port>

    Menetapkan port tempatan untuk pemajuan TCP. Jika pilihan ini tidak ditentukan, nilai --remote-port <port> digunakan sebagai nombor port.

  • --node-cc <cc>

    Anda boleh menetapkan kod negara pelayan perantara mudcat yang ingin digunakan. Contohnya, kod negara JP memperuntukkan pelayan perantara mudcat di Jepun secara automatik.

  • --node-id <nid>

    Anda boleh menetapkan ID unik pelayan perantara mudcat yang ingin digunakan. ID unik setiap pelayan boleh diperoleh melalui arahan mudcat node.

  • --remote-port <port>

    Menetapkan port TCP yang didengar oleh pelayan perantara mudcat.

Arahan mudcat udp​

Arahan ini digunakan untuk menyediakan perkhidmatan pemajuan 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.

Pilihan tambahan berikut disokong.

  • --conn-uuid <uuid>

    Pilihan ini digunakan untuk menggunakan semula port jauh yang pernah digunakan.

    Biasanya, selepas port jauh yang diperuntukkan digunakan dan sambungan diputuskan, port tersebut tidak boleh digunakan sehingga sumbernya dibebaskan.

    Namun, jika anda mengetahui Connection UUID terdahulu, port jauh tersebut boleh digunakan semula serta-merta.

  • --domain <domain>

    Dengan pilihan ini, pengguna boleh menentukan domain sendiri menggantikan alamat domain rawak (biasanya terdiri daripada nombor). Contohnya, jika anda menetapkan --domain abc, alamat domain yang diperuntukkan ialah abc.mudcat.io.

  • --local-addr <ip>

    Pilihan ini menetapkan alamat tempatan (IPv4) untuk pemajuan UDP. Nilai lalai ialah 127.0.0.1.

    Namun, nilai ini tidak semestinya merujuk kepada alamat rangkaian dalaman. Jika anda ingin menunjuk ke IP awam jauh yang lain, anda boleh menetapkan IP tersebut.

  • --local-port <port>

    Menetapkan port tempatan untuk pemajuan UDP. Jika pilihan ini tidak ditentukan, nilai --remote-port <port> digunakan sebagai nombor port.

  • --node-cc <cc>

    Anda boleh menetapkan kod negara pelayan perantara mudcat yang ingin digunakan. Contohnya, kod negara JP memperuntukkan pelayan perantara mudcat di Jepun secara automatik.

  • --node-id <nid>

    Anda boleh menetapkan ID unik pelayan perantara mudcat yang ingin digunakan. ID unik setiap pelayan boleh diperoleh melalui arahan mudcat node.

  • --remote-port <port>

    Menetapkan port UDP yang didengar oleh pelayan perantara mudcat.

Nota keluaran​

0.0.3 (2023-01-21)​

  • Pilihan baharu berikut telah ditambah.

    • --domain
    • --node-id

0.0.2 (2023-01-20)​

  • Masalah program tidak berfungsi dengan betul pada Windows telah diselesaikan.

0.0.1 (2023-01-18)​

  • Ini ialah keluaran pertama. Walaupun pelaksanaan asas telah dibuat, kami menjangkakan masih banyak perkara yang boleh diperbaiki dan pepijat yang mungkin wujud. Kami akan terus menambah baik program ini secara beransur-ansur.