DeskVNCServer - מדריך

תחילת העבודה

1. הגדרת סיסמה

פתחו את ההגדרות (סמל גלגל השיניים, בסרגל הכלים התחתון) והזינו סיסמת VNC. לקוחות VNC רגילים משתמשים באתגר RFB DES, התומך רק ב-8 הבתים הראשונים התואמים ל-ASCII — בחרו סיסמה שאורכה אינו עולה על 8 תווים.

2. הפעלת השרת

1. בחלון הראשי, לחצו על התחל. מחוון המצב משתנה ל- פועל.
2. ארבעה מאזינים מופעלים בו-זמנית: VNC 5900, בקרת QREX 5911, מדיה של QREX 4010, ו-API הקבצים 8766.
3. לחצו על העתק פרטים כדי להעתיק ללוח שורה אחת עם המארח, היציאות וה-PIN הנוכחי.

3. חיבור לקוח

עבור מציג VNC רגיל (שיתוף מסך של macOS, ‏RealVNC, ‏TightVNC, אפליקציות VNC לנייד):

1. פתחו את המציג והזינו vnc://<your-mac-ip>:5900 ככתובת
2. הקלידו את סיסמת ה-VNC שהגדרתם בשלב 1
3. שלטו ב-Mac מיד — מקלדת, עכבר והעתקה/הדבקה באמצעות RFB

עבור אפליקציית QuickRemote:

1. פתחו את QuickRemote בטלפון או בטאבלט, ובחרו הוסף Mac
2. הזינו את PIN הצימוד בן 6 הספרות שמוצג ב-DeskVNCServer (או סרקו את קוד ה-QR אם גרסת QuickRemote שלכם תומכת בכך)
3. QuickRemote שומרת את אסימון ה-Bearer שהוחזר ופותחת את התכונות המורחבות — IME, שמע, סנכרון לוח והעברת קבצים

סקירת הממשק

שורת מצב

לחצני פעולה

• התחל — מפעיל את כל ארבעת המאזינים.
• עצור — סוגר כל מאזין ומנתק הפעלות פעילות.
• העתק פרטים — מעתיק ללוח סיכום חיבור קצר (מארח, יציאת VNC, יציאת בקרה, PIN) לשיתוף קל עם לקוח.

לוח החיבור

מציג את מארח הקישור, היציאות, מזהה השרת הנוכחי ו-PIN הצימוד הפעיל. הטקסט מתרענן אוטומטית כשההגדרות משתנות.

לוח API של QuickRemote

עזר מהיר לפרוטוקולים שבהם השרת תומך. מפרט את גרסאות RFB הנתמכות, את מבני נקודות הקצה של QREX ואת ערכת פקודות ה-IME, כדי ש-QuickRemote (או הלקוח שלכם) ידע מה זמין.

פרוטוקולים ויציאות

אימות

• לקוחות VNC — סיסמת RFB DES (8 הבתים הראשונים התואמים ל-ASCII של הסיסמה שהוגדרה).
• לקוחות QREX — החלפת PIN ראשונית בת 6 ספרות ב- POST /qr/v1/pair מחזירה אסימון Bearer. כל קריאת HTTP ומסגרת WebSocket של QREX לאחר מכן חייבות לכלול Authorization: Bearer <token>.
• אם סיסמת ה-VNC ריקה, השרת מפרסם מצב RFB רגיל ללא אימות. שימושי רק למקטעי LAN מהימנים.

עזר מהיר לנקודות קצה של QREX

GET  /qr/v1/capabilities    # ציבורי, מחזיר תכונות נתמכות
POST /qr/v1/pair            # ציבורי, החלפת PIN באסימון Bearer
GET  /qr/v1/ws              # WebSocket, נדרש אימות
POST /qr/v1/ime/get         # נדרש אימות, שאילתת IME פעיל
POST /qr/v1/ime/list        # נדרש אימות, רשימת IME זמינים
POST /qr/v1/ime/set         # נדרש אימות, החלפת IME
POST /qr/v1/ime/toggle      # נדרש אימות, הפעלה/כיבוי של IME
POST /qr/v1/ime/commit      # נדרש אימות, אישור מחרוזת טקסט

הגדרות

דוגמאות ללקוחות

שיתוף מסך של macOS

1. Finder → מעבר → התחברות לשרת
2. הקלידו vnc://<your-mac-ip>:5900
3. הזינו את סיסמת ה-VNC

cURL — גילוי יכולות

curl http://<your-mac-ip>:5911/qr/v1/capabilities

cURL — צימוד וקריאה לגישור IME

# 1. החליפו את ה-PIN באסימון Bearer
TOKEN=$(curl -s http://<your-mac-ip>:5911/qr/v1/pair \
  -H "Content-Type: application/json" \
  -d '{"pin":"123456"}' | jq -r .token)

# 2. הזינו טקסט באמצעות גישור IME
curl http://<your-mac-ip>:5911/qr/v1/ime/commit \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"text":"hello from remote"}'

טיפים

• הפחיתו את קצב המסגרות ואת ממדי המסגרת המרביים כשאתם בחיבור Wi-Fi איטי או מנתבים את החיבור דרך VPN.
• צמדו כל מכשיר פעם אחת. לאחר החלפת ה-PIN הראשונית אסימון ה-Bearer נשמר גם לאחר אתחול, ולכן QuickRemote מתחברת מחדש בשקט.
• השתמשו ב- העתק פרטים כדרך מהירה לשלוח פרטי חיבור בצ'אט או בדוא"ל — הוא כולל את כל מה שלקוח זקוק לו.
• השאירו את הפעל פעולות שינוי בקבצים כבוי, אלא אם אתם באמת זקוקים להעלאות. מצב קריאה בלבד מספיק לעיון בצילומי מסך, הערות או הורדות.
• השביתו את API השמע כשאינכם משתמשים בו. רכיבי קודק במצב סרק עדיין צורכים מעט CPU בנתיב הקידוד.

פתרון בעיות

השרת לא מופעל

• ייתכן ששרת VNC אחר (למשל שיתוף המסך של macOS) כבר משתמש ביציאה 5900. עצרו אותו דרך הגדרות המערכת → כללי → שיתוף, או שנו את היציאה בהגדרות DeskVNCServer.
• היציאות 5911 / 4010 / 8766 חייבות כולן להיות פנויות. בדקו באמצעות lsof -i :5911 ופקודות דומות.

לקוחות VNC אינם מצליחים לבצע אימות

• ודאו שהסיסמה היא לכל היותר 8 בתים התואמים ל-ASCII. תווים מרובי-בתים או מחרוזות ארוכות יותר נחתכים בשקט על ידי אימות RFB DES.
• אם אתם מעוניינים בכוונה ללא סיסמה, השאירו את השדה ריק והתחברו באמצעות מציג שתומך ב-VNC ללא אימות.

QuickRemote אינה מצליחה לבצע צימוד

• ודאו שהטלפון או הטאבלט מחובר לאותו Wi-Fi כמו ה-Mac.
• פתחו את לוח החיבור וקראו שוב את ה-PIN. ניתן ליצור מחדש את ה-PIN מההגדרות.
• בדקו את הגדרות חומת האש של macOS — יש לאפשר חיבורים נכנסים ביציאות QREX.

השליטה מרחוק מרגישה איטית

• הפחיתו בהגדרות את קצב המסגרות ואת ממדי המסגרת המרביים.
• השביתו תכונות שאינכם משתמשים בהן (שמע, לוח, IME) כדי לפנות CPU.

הקבצים אינם מועברים

• ודאו ש- הפעל העברת קבצים מופעל. רשימות קריאה בלבד פועלות ללא הפעל פעולות שינוי בקבצים.
• אם העלאות נכשלות, הפעילו גם את הפעל פעולות שינוי בקבצים. אחרת API הקבצים מגיב רק לבקשות קריאה.

פרטיות

• כל ההפעלות פועלות ישירות בין הלקוח ל-Mac שלכם. אין ממסר ענן, טלמטריה או ניתוח נתונים.
• סיסמת ה-VNC, אסימון ה-Bearer של QREX, PIN הצימוד ומזהה השרת הקבוע נשמרים רק בהגדרות המקומיות של האפליקציה.
• פעולות שינוי בקבצים כבויות כברירת מחדל. לקוחות מרוחקים יכולים רק לקרוא עד שתעניקו במפורש גישת כתיבה.
• השביתו בכל עת כל הרחבה (שמע, לוח, העברת קבצים, IME, קלט מרחוק) כדי לבטל מיד יכולת זו.
• אם ברצונכם לשמור את השרת מקומי ל-Mac שלכם, הגדירו את מארח הקישור ל- 127.0.0.1.