דילוג לתוכן הראשי

Mudcat

מבוא​

זהו שירות לשיתוף פורטי HTTP/TCP/UDP שמספקת Mudfish Networks. מטרתו לספק שירות בעל ייעוד דומה ל־ngrok.

באמצעות השירות אפשר לחשוף בקלות שירות שנמצא ברשת פנימית לגישה מבחוץ. הפרוטוקולים הנתמכים כעת הם:

  • HTTP
  • TCP
  • UDP

אפשר להתקין ולהשתמש בקלות באמצעות פקודה אחת.

הורדה​

אפשר להוריד את התוכנית מאתר mudcat.

מבחינת המשתמש, תוכנית mudcat מורכבת מקובץ הפעלה אחד, ולכן קל להוריד ולהפעיל אותה.

אפשרויות ההפעלה של 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>

    מציינת את כתובת ה־IPv4 המקומית שאליה תופנה תעבורת HTTP. ברירת המחדל היא 127.0.0.1.

    עם זאת, הכתובת אינה חייבת להיות כתובת ברשת פנימית. אפשר לציין כתובת IP ציבורית אחרת ומרוחקת אם ברצונכם להפנות אליה.

  • --local-port <port>

    מציינת את הפורט המקומי להפניית HTTP. ברירת המחדל היא 80.

  • --node-cc <cc>

    מאפשרת לציין את קוד המדינה של שרת הממסר של mudcat שבו רוצים להשתמש. לדוגמה, ציון קוד המדינה JP יקצה אוטומטית שרת ממסר של mudcat ביפן.

  • --node-id <nid>

    מאפשרת לציין את המזהה הייחודי של שרת הממסר של mudcat שבו רוצים להשתמש. אפשר לקבל את המזהה הייחודי של כל שרת ממסר באמצעות הפקודה 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 יקצה אוטומטית שרת ממסר של mudcat ביפן.

  • --node-id <nid>

    מאפשרת לציין את המזהה הייחודי של שרת הממסר של mudcat שבו רוצים להשתמש. אפשר לקבל את המזהה הייחודי של כל שרת ממסר באמצעות הפקודה 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 יקצה אוטומטית שרת ממסר של mudcat ביפן.

  • --node-id <nid>

    מאפשרת לציין את המזהה הייחודי של שרת הממסר של mudcat שבו רוצים להשתמש. אפשר לקבל את המזהה הייחודי של כל שרת ממסר באמצעות הפקודה mudcat node.

  • --remote-port <port>

    מציינת את פורט ה־UDP שעליו יאזין שרת הממסר של mudcat.

הערות גרסה​

אין במקור הערות גרסה מהתקופה שמ־2025-10-16 ואילך. להיסטוריה המלאה, כולל הגרסאות הישנות יותר, ראו את הערות הגרסה המלאות בקוריאנית.