זוהי הפקודה websockify שניתן להפעיל בספק האירוח החינמי של OnWorks באמצעות אחת מתחנות העבודה המקוונות המרובות שלנו, כגון Ubuntu Online, Fedora Online, אמולטור מקוון של Windows או אמולטור מקוון של MAC OS
תָכְנִית:
שֵׁם
websockify - WebSockets ל-TCP socket bridge
תַקצִיר
websockify [אפשרויות] [source_addr:]source_port target_addr:target_port
websockify [אפשרויות] [source_addr:]source_port -- WRAP_COMMAND_LINE
אפשרויות
-h, - עזרה להציג את הודעת העזרה הזו ולצאת ממנה
-v, --הודעות מילוליות ותעבורה לכל מסגרת
--record=הקלטת הפעלות של FILE ל-FILE.[session_number]
-D, --daemon הופך לדמון (תהליך רקע)
--run-once לטפל בחיבור WebSocket יחיד ולצאת
--timeout=TIMEOUT לאחר TIMEOUT שניות יציאה כאשר לא מחובר
--cert=קובץ אישור SSL CERT
--key=KEY קובץ מפתח SSL (אם נפרד מאישור)
--ssl-only לא מאפשר חיבורים לא מוצפנים
--web=DIR הרץ שרת אינטרנט באותה יציאה. הגש קבצים מ-DIR.
--wrap-mode=פעולת MODE לנקוט כאשר התוכנית העטופה יוצאת או
דמוניזציה: יציאה (ברירת מחדל), התעלם, הפעלה מחדש
תיאור
ברמה הבסיסית ביותר, websockify פשוט מתרגם תעבורת WebSockets ל-TCP רגיל
תעבורת שקעים. Websockify מקבל את לחיצת היד של WebSockets, מנתח אותה ואז מתחיל
העברת תעבורה בין הלקוח למטרה בשני הכיוונים.
websockify נקרא בעבר wsproxy והיה חלק מפרויקט noVNC.
אורים
WebSockets בינרי נתונים
Websockify תומך בכל הגרסאות של פרוטוקול WebSockets (Hixie ו-HyBI). הזקן יותר
גרסאות Hixie של הפרוטוקול תומכות רק במטעני טקסט UTF-8. על מנת להוביל
נתונים בינאריים על UTF-8 יש להשתמש בקידוד כדי לכלול את הנתונים בתוך UTF-8.
Websockify משתמש ב-base64 כדי לקודד את כל התעבורה אל הלקוח וממנו. זה לא משפיע
הנתונים בין websockify לשרת.
מוצפן WebSocket חיבורים (wss://)
כדי להצפין את התעבורה באמצעות סכימת ה-URI של WebSocket 'wss://', עליך ליצור א
אישור לטעינת websockify. כברירת מחדל websockify טוען שם קובץ אישור
self.pem אבל האפשרות --cert=CERT יכולה לעקוף את שם הקובץ. אתה יכול ליצור עצמי
אישור חתום באמצעות openssl. כשתבקשו את השם הנפוץ, השתמשו בשם המארח של ה-
שרת שבו ה-proxy יפעל:
openssl req -new -x509 -ימים 365 -צמתים -out self.pem -keyout self.pem
Websock Javascript ספריה
הספריית websock.js (ראה https://github.com/kanaka/websockify) ספריית Javascript
מספק אובייקט Websock הדומה לאובייקט WebSocket הסטנדרטי אך Websock
מאפשר תקשורת עם שקעי TCP גולמיים (כלומר הזרם הבינארי) באמצעות websockify. זֶה
מתבצע על ידי קידוד base64 של זרם הנתונים בין Websock ו-websockify.
ל-Websock יש אחסון תור קבלה מובנה; אירוע ההודעה אינו מכיל בפועל
נתונים אלא פשוט הודעה על כך שיש נתונים חדשים זמינים. מספר שיטות rQ*
זמינים לקריאת נתונים בינאריים מחוץ לתור הקבלה.
ה-API של Websock מתועד בדף הוויקי של websock.js API:
https://github.com/kanaka/websockify/wiki/websock.js
עיין בסעיף "עטוף תוכנית" להלן לקבלת דוגמה לשימוש ב-Websock וב-websockify בתור א
לקוח Telnet של הדפדפן (wstelnet.html).
נוסף websockify מאפיינים
אלה אינם נחוצים עבור הפעולה הבסיסית.
* דמוניזציה: כאשר האפשרות -D מצוינת, websockify פועל ברקע כמו
תהליך דמון.
* SSL (ה-URI של wss:// WebSockets): זה מזוהה אוטומטית על ידי websockify על ידי
לרחרח את הביט הראשון שנשלח מהלקוח ואז לעטוף את השקע אם
הנתונים מתחילים ב-'\x16' או '\x80' (מציין SSL).
* מדיניות אבטחת פלאש: websockify מזהה בקשות למדיניות אבטחת פלאש (שוב על ידי
מרחרח את החבילה הראשונה) ועונה עם מדיניות אבטחת פלאש מתאימה
תגובה (ואז סוגר את היציאה). המשמעות היא שאין מדיניות אבטחת פלאש נפרדת
יש צורך בשרת לתמיכה באמולטור ה-Flash WebSockets fallback.
* הקלטת הפעלה: תכונה זו המאפשרת הקלטה של התעבורה שנשלחה ו
שהתקבל מהלקוח לקובץ באמצעות האפשרות --record.
* שרת מיני: websockify יכול לזהות ולהגיב לבקשות אינטרנט רגילות באתר
אותה יציאה כמו מדיניות האבטחה של WebSockets פרוקסי ו-Flash. פונקציונליות זו היא
הפעל עם האפשרות --web DIR כאשר DIR הוא השורש של ספריית האינטרנט אל
לְשָׁרֵת.
* עטוף תוכנית: עיין בסעיף "עטוף תוכנית" להלן.
עטוף a תָכְנִית
בנוסף ל-proxy מכתובת מקור לכתובת יעד (שעשויה להיות ב-a
מערכת שונה), ל-websockify יש את היכולת להפעיל תוכנית במערכת המקומית ו
פרוקסי WebSockets תעבורה ליציאת TCP רגילה בבעלות/כבולה של התוכנית.
השיטה מתבצעת באמצעות ספריית LD_PRELOAD קטנה (rebind.so) אשר מיירטת את bind()
קריאות מערכת על ידי התוכנית. היציאה שצוינה מועברת ל-localhost/loopback חדש בחינם
נמל גבוה. websockify ואז מגיש פרוקסי לתעבורת WebSockets המכוונת ליציאה המקורית ל-
יציאה חדשה (הועברה) של התוכנית.
מצב גלישת התוכנית מופעל על ידי החלפת היעד ב- ואחריו התוכנית
שורת פקודה לעטוף.
`./websockify 2023 -- PROGRAM ARGS`
ניתן להשתמש באפשרות --wrap-mode כדי לציין איזו פעולה לנקוט כאשר העטוף
התוכנית יוצאת או עושה דמוניזציה.
הנה דוגמה לשימוש ב-websockify כדי לעטוף את הפקודה vncserver (אשר רקעים
עצמו) לשימוש עם noVNC:
`./websockify 5901 --wrap-mode=ignore -- vncserver -geometry 1024x768 :1`
הנה דוגמה של גלישת telnetd (מ-krb5-telnetd).telnetd יוצא לאחר
החיבור נסגר כך שמצב הגלישה מוגדר להפעיל מחדש את הפקודה:
`sudo ./websockify 2023 --wrap-mode=respawn -- telnetd -debug 2023`
הדף wstelnet.html מדגים לקוח Telnet פשוט מבוסס WebSockets.
השתמש ב-websockify באינטרנט באמצעות שירותי onworks.net
