DeskVNCServer - गाइड

आरंभ करें

1. पासवर्ड सेट करें

Settings खोलें (गियर आइकन, निचला टूलबार) और भरें VNC पासवर्ड। मानक VNC क्लाइंट RFB DES चैलेंज का उपयोग करते हैं, जो केवल पहले 8 ASCII-संगत बाइट्स को मानता है — 8 वर्णों से अधिक लंबा पासवर्ड न चुनें।

2. सर्वर शुरू करें

1. मुख्य विंडो में, क्लिक करें Start। स्थिति संकेतक बदलकर चल रहा है.
2. चार लिस्नर एक साथ शुरू हो जाते हैं: VNC 5900, QREX नियंत्रण 5911, QREX मीडिया 4010, और फ़ाइल API 8766.
3. क्लिक करें Copy Info पर क्लिक करके होस्ट, पोर्ट और वर्तमान PIN वाली एक-पंक्ति जानकारी को अपने क्लिपबोर्ड में कॉपी करें।

3. क्लाइंट कनेक्ट करें

मानक VNC व्यूअर के लिए (macOS Screen Sharing, RealVNC, TightVNC, मोबाइल VNC ऐप्स):

1. व्यूअर खोलें और दर्ज करें vnc://<your-mac-ip>:5900 पते के रूप में
2. चरण 1 में सेट किया हुआ VNC पासवर्ड टाइप करें
3. अपने Mac को तुरंत नियंत्रित करें — RFB के माध्यम से कीबोर्ड, माउस, कॉपी/पेस्ट

QuickRemote ऐप के लिए:

1. फ़ोन या टैबलेट पर QuickRemote खोलें, चुनें Add Mac
2. DeskVNCServer में दिखाया गया 6-अंकों का पेयरिंग PIN दर्ज करें (या यदि आपका QuickRemote बिल्ड इसका समर्थन करता है तो QR कोड स्कैन करें)
3. QuickRemote लौटाया गया Bearer टोकन संग्रहीत करता है और विस्तारित सुविधाएँ अनलॉक करता है — IME, ऑडियो, क्लिपबोर्ड सिंक और फ़ाइल स्थानांतरण

इंटरफ़ेस अवलोकन

स्थिति पंक्ति

क्रिया बटन

• Start — सभी चार लिस्नर शुरू करें।
• Stop — प्रत्येक लिस्नर बंद करें और सक्रिय सत्र डिस्कनेक्ट करें।
• Copy Info — क्लाइंट के साथ आसानी से साझा करने के लिए एक संक्षिप्त कनेक्शन सारांश (होस्ट, VNC पोर्ट, नियंत्रण पोर्ट, PIN) क्लिपबोर्ड में कॉपी करें।

कनेक्शन पैनल

बाइंड होस्ट, पोर्ट, वर्तमान सर्वर ID और सक्रिय पेयरिंग PIN प्रदर्शित करता है। सेटिंग बदलने पर पाठ अपने-आप ताज़ा होता है।

QuickRemote API पैनल

सर्वर द्वारा उपयोग किए जाने वाले प्रोटोकॉल का त्वरित संदर्भ। समर्थित RFB संस्करण, QREX एंडपॉइंट स्वरूप और IME कमांड सेट सूचीबद्ध करता है, ताकि QuickRemote (या आपका अपना क्लाइंट) जान सके कि क्या उपलब्ध है।

प्रोटोकॉल और पोर्ट

प्रमाणीकरण

• VNC क्लाइंट — RFB DES पासवर्ड (कॉन्फ़िगर किए गए पासवर्ड के पहले 8 ASCII-संगत बाइट्स)।
• QREX क्लाइंट — प्रारंभिक 6-अंकों का PIN विनिमय यहाँ POST /qr/v1/pair Bearer टोकन लौटाता है। प्रत्येक बाद की QREX HTTP कॉल और WebSocket फ़्रेम में शामिल होना चाहिए 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 Screen Sharing

1. Finder → Go → Connect to Server
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 बिना सूचना के फिर से कनेक्ट हो जाता है।
• उपयोग करें Copy Info चैट या ईमेल पर कनेक्शन विवरण भेजने के त्वरित तरीके के रूप में — इसमें क्लाइंट की आवश्यकता की हर चीज़ शामिल है।
• रखें फ़ाइल परिवर्तन सक्षम करें जब तक आपको वास्तव में अपलोड की आवश्यकता न हो, इसे बंद रखें। स्क्रीनशॉट, नोट या डाउनलोड ब्राउज़ करने के लिए केवल-पढ़ने का मोड पर्याप्त है।
• जब उपयोग में न हो तो ऑडियो API अक्षम करें। निष्क्रिय कोडेक भी एन्कोड पथ पर थोड़ा CPU उपयोग करते हैं।

समस्या निवारण

सर्वर शुरू नहीं होगा

• कोई अन्य VNC सर्वर (जैसे macOS Screen Sharing) शायद पहले से पोर्ट 5900 पर है। इसे System Settings → General → Sharing से बंद करें या DeskVNCServer की सेटिंग में पोर्ट बदलें।
• पोर्ट 5911 / 4010 / 8766 सभी खाली होने चाहिए। जाँचें lsof -i :5911 और समान कमांड से।

VNC क्लाइंट प्रमाणित नहीं हो पाते

• सुनिश्चित करें कि पासवर्ड अधिकतम 8 ASCII-संगत बाइट्स का हो। RFB DES प्रमाणीकरण बहु-बाइट वर्णों या लंबी स्ट्रिंग को चुपचाप काट देता है।
• यदि आप जानबूझकर कोई पासवर्ड नहीं चाहते, तो फ़ील्ड खाली छोड़ें और ऐसे व्यूअर से कनेक्ट करें जो VNC बिना-प्रमाणीकरण का समर्थन करता हो।

QuickRemote पेयर नहीं कर सकता

• पुष्टि करें कि फ़ोन या टैबलेट Mac के उसी Wi-Fi पर है।
• कनेक्शन पैनल खोलें और PIN फिर से देखें। PIN को Settings से पुनः जनरेट किया जा सकता है।
• macOS फ़ायरवॉल सेटिंग जाँचें — QREX पोर्ट पर आने वाले कनेक्शन की अनुमति होनी चाहिए।

रिमोट नियंत्रण धीमा लगता है

• Settings में फ़्रेम दर और अधिकतम फ़्रेम आयाम कम करें।
• CPU मुक्त करने के लिए जिन सुविधाओं का उपयोग नहीं कर रहे हैं उन्हें अक्षम करें (ऑडियो, क्लिपबोर्ड, IME)।

फ़ाइलें स्थानांतरित नहीं होतीं

• पुष्टि करें फ़ाइल स्थानांतरण सक्षम करें चालू है। केवल-पढ़ने की सूचियाँ बिना इसके भी काम करती हैं फ़ाइल परिवर्तन सक्षम करें.
• यदि अपलोड विफल हों, तो इसे भी सक्षम करें फ़ाइल परिवर्तन सक्षम करें। अन्यथा फ़ाइल API केवल पढ़ने के अनुरोधों का उत्तर देता है।

गोपनीयता

• सभी सत्र क्लाइंट और आपके Mac के बीच सीधे चलते हैं। कोई क्लाउड रिले, टेलीमेट्री या एनालिटिक्स नहीं है।
• VNC पासवर्ड, QREX Bearer टोकन, पेयरिंग PIN और स्थिर सर्वर ID केवल स्थानीय ऐप सेटिंग में संग्रहीत होते हैं।
• फ़ाइल परिवर्तन डिफ़ॉल्ट रूप से बंद हैं। जब तक आप स्पष्ट रूप से लिखने की अनुमति नहीं देते, रिमोट क्लाइंट केवल पढ़ सकते हैं।
• किसी भी क्षमता को तुरंत रद्द करने के लिए किसी भी समय कोई भी एक्सटेंशन (ऑडियो, क्लिपबोर्ड, फ़ाइल स्थानांतरण, IME, रिमोट इनपुट) अक्षम करें।
• यदि आप सर्वर को अपने Mac तक स्थानीय रखना चाहते हैं, तो बाइंड होस्ट को सेट करें 127.0.0.1.