مرکزی مواد پر جائیں

mudcat (مڈ کیٹ)

تعارف​

یہ مڈفش نیٹ ورکس کی جانب سے فراہم کردہ ایک HTTP/TCP/UDP پورٹ شیئرنگ سروس ہے۔ اس کا مقصد https://ngrok.io جیسی سروس فراہم کرنا ہے۔

اس سروس کا استعمال کرتے ہوئے آپ اپنے اندرونی نیٹ ورک میں چلنے والی سروسز کو باآسانی بیرونی دنیا کے ساتھ شیئر کر سکتے ہیں۔ فی الحال یہ درج ذیل پروٹوکولز کو سپورٹ کرتی ہے:

  • 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 پورٹ فارورڈ کرنے کے لیے استعمال کی جا سکتی ہے۔

  • 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 ہے۔

    تاہم، اس ایڈریس کا لازمی طور پر اندرونی نیٹ ورک کا ہونا ضروری نہیں ہے۔ اگر آپ کسی دوسرے دور دراز پبلک IP کی طرف اشارہ کرنا چاہتے ہیں تو وہ IP بھی درج کر سکتے ہیں۔

  • --local-port <port>

    یہ HTTP فارورڈنگ کے لیے لوکل پورٹ متعین کرتا ہے۔ اس کی ڈیفالٹ ویلیو 80 ہے۔

  • --node-cc <cc>

    آپ مطلوبہ mudcat ریلے سرور کا ملکی کوڈ (Country Code) متعین کر سکتے ہیں۔ مثال کے طور پر، اگر آپ کنٹری کوڈ JP درج کرتے ہیں تو جاپان میں موجود mudcat ریلے سرور خودکار طور پر مختص ہو جائے گا۔

  • --node-id <nid>

    آپ مطلوبہ mudcat ریلے سرور کی منفرد شناختی ID (unique 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>

    یہ آپشن اس وقت استعمال کیا جا سکتا ہے جب آپ پہلے سے استعمال شدہ ریموٹ پورٹ کو دوبارہ استعمال کرنا چاہتے ہوں۔

    عام طور پر مختص کردہ ریموٹ پورٹ استعمال کرنے کے بعد جب کنکشن منقطع ہوتا ہے تو وہ ریموٹ پورٹ ریسورسز ریلیز ہونے تک دستیاب نہیں رہتی۔

    تاہم، اگر آپ کو پچھلا Connection UUID معلوم ہو تو آپ اس ریموٹ پورٹ کو فوری طور پر دوبارہ استعمال کر سکتے ہیں۔

  • --domain <domain>

    اس آپشن کے ذریعے آپ بے ترتیب ڈومین ایڈریس (جو عام طور پر ہندسوں پر مشتمل ہوتا ہے) کے بجائے اپنی مرضی کا ڈومین نام مخصوص کر سکتے ہیں۔ مثال کے طور پر، اگر آپ --domain abc لکھتے ہیں تو مختص کردہ ڈومین ایڈریس abc.mudcat.io ہوگا۔

  • --local-addr <ip>

    یہ آپشن TCP فارورڈنگ کے لیے لوکل ایڈریس (IPv4) متعین کرتا ہے۔ اس کی ڈیفالٹ ویلیو 127.0.0.1 ہے۔

    تاہم، اس ایڈریس کا لازمی طور پر اندرونی نیٹ ورک کا ہونا ضروری نہیں ہے۔ اگر آپ کسی دوسرے دور دراز پبلک IP کی طرف اشارہ کرنا چاہتے ہیں تو وہ IP بھی درج کر سکتے ہیں۔

  • --local-port <port>

    یہ TCP فارورڈنگ کے لیے لوکل پورٹ متعین کرتا ہے۔ اگر یہ آپشن نہ دیا جائے تو --remote-port <port> کی ویلیو کو پورٹ کے طور پر استعمال کیا جائے گا۔

  • --node-cc <cc>

    آپ مطلوبہ mudcat ریلے سرور کا ملکی کوڈ متعین کر سکتے ہیں۔ مثال کے طور پر، اگر آپ کنٹری کوڈ JP درج کرتے ہیں تو جاپان میں موجود mudcat ریلے سرور خودکار طور پر مختص ہو جائے گا۔

  • --node-id <nid>

    آپ مطلوبہ mudcat ریلے سرور کی منفرد شناختی ID (unique 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 ہے۔

    تاہم، اس ایڈریس کا لازمی طور پر اندرونی نیٹ ورک کا ہونا ضروری نہیں ہے۔ اگر آپ کسی دوسرے دور دراز پبلک IP کی طرف اشارہ کرنا چاہتے ہیں تو وہ IP بھی درج کر سکتے ہیں۔

  • --local-port <port>

    یہ UDP فارورڈنگ کے لیے لوکل پورٹ متعین کرتا ہے۔ اگر یہ آپشن نہ دیا جائے تو --remote-port <port> کی ویلیو کو پورٹ کے طور پر استعمال کیا جائے گا۔

  • --node-cc <cc>

    آپ مطلوبہ mudcat ریلے سرور کا ملکی کوڈ متعین کر سکتے ہیں۔ مثال کے طور پر، اگر آپ کنٹری کوڈ JP درج کرتے ہیں تو جاپان میں موجود mudcat ریلے سرور خودکار طور پر مختص ہو جائے گا۔

  • --node-id <nid>

    آپ مطلوبہ mudcat ریلے سرور کی منفرد شناختی ID (unique ID) متعین کر سکتے ہیں۔ ہر ریلے سرور کی منفرد ID آپ mudcat node کمانڈ چلا کر حاصل کر سکتے ہیں۔

  • --remote-port <port>

    یہ mudcat ریلے سرور پر سننے والی (listening) UDP پورٹ متعین کرتا ہے۔

ریلیز نوٹس​

اس مدت میں 2025-10-16 یا اس کے بعد کی کوئی ریلیز نوٹ موجود نہیں ہے۔

پچھلی تبدیلیوں کے لیے مکمل کوریائی تاریخ دیکھیں۔