ڈیوائس پیئر کریں

یہ گائیڈ دکھاتی ہے کہ فون کو Control Center کے ساتھ کیسے پیئر کریں، تاکہ آپ پیغامات اور ٹکٹس کہیں سے بھی پڑھ اور جواب دے سکیں۔ یہی فلو دوسرے براؤزر یا ڈیسک ٹاپ ایپ کو بھی پیئر کرتا ہے۔ لنک کیسے کام کرتا ہے اور اس کا سیکیورٹی ماڈل کیا ہے، یہ ریموٹ کنٹرول اور موبائل میں دیکھیں۔

پیشگی شرائط

آپ کے سرور سے منسلک ایک ڈیسک ٹاپ یا ویب کلائنٹ اور ایک سیٹ اپ ورک اسپیس۔ پیئرنگ کے عمل کے لیے مکمل کلائنٹ درکار ہوتا ہے، اس لیے پیئر شدہ فون کبھی کسی دوسری ڈیوائس کو پیئر — یا منسوخ — نہیں کر سکتا۔
سرور اُس ڈیوائس سے قابلِ رسائی ہو جسے آپ پیئر کر رہے ہیں۔ ایک ہی نیٹ ورک پر یہ خود بخود چل جاتا ہے؛ دور سے بروکرڈ ریلے ٹریفک لے جاتا ہے۔ اگر پینل QR یا اسناد کے بجائے پہنچ سے باہر دکھائے تو پہلے کوئی راستہ شائع کریں — ترتیبات → سرور → کنکشن اور اسٹیٹس پر ٹنل آپٹ اِن (یہ سرور شیئر کریں)، یا سرور کا --public-url (دیکھیں ہیڈلیس سرور چلائیں)۔
فون کے لیے: کچھ انسٹال کرنے کی ضرورت نہیں۔ QR Remote ویب ایپ کھولتا ہے (بطور ڈیفالٹ remote.usectrl.dev)۔

خود میزبانی۔ Remote اور ریلے بروکر اس ریپو میں اوپن سورس ہیں: فون ایپ (apps/cc_remote، ایک Flutter ویب PWA جسے آپ اپنے wrangler.jsonc کے ذریعے Cloudflare Pages پر، docker/cc_remote nginx ایمیج پر، یا HTTPS کے ساتھ کسی بھی اسٹیٹک ہوسٹ پر ڈیپلائے کر سکتے ہیں — سروس ورکرز اور IndexedDB سیکیور کانٹیکسٹ تک محدود ہیں) اور ریلے (apps/cc_signaling_server، ایک واحد اسٹیٹ لیس Dart بائنری جو کوئی ایپ ڈیٹا نہیں رکھتا اور پیئرنگ سیکرٹ کبھی نہیں دیکھتا — یہ صرف اینڈ ٹو اینڈ سیل شدہ فریمز فارورڈ کرتا ہے)۔ بلڈ اور رن کے مراحل کے لیے ان کے READMEs دیکھیں۔

مرحلہ 1: پیئرنگ پینل کھولیں

ترتیبات → آپ → آپ کی ڈیوائسز کھولیں۔ آپ کی ڈیوائسز سیکشن اس سرور پر آپ کے اکاؤنٹ سے پیئر شدہ کلائنٹس کی فہرست دکھاتا ہے۔ (سرور کا مالک سرور کی ہر ڈیوائس دیکھتا ہے؛ باقی سب صرف اپنی ڈیوائسز دیکھتے ہیں۔)

مرحلہ 2: نیا کلائنٹ پیئر کریں

صفحے کے ہیڈر میں نیا کلائنٹ پیئر کریں پر کلک کریں، اسے کوئی لیبل دیں (مثلاً “میرا فون”)، قسم منتخب کریں — ویب براؤزر، ڈیسک ٹاپ ایپ، یا فون — اور پیئر کریں پر کلک کریں۔

فون کے لیے ایک QR کوڈ ظاہر ہوتا ہے۔ اسے فون کے کیمرے سے اسکین کریں، یا لنک کاپی کر کے کسی بھی براؤزر میں کھولیں۔ یہ Remote ایپ کو آپ کے سرور کی طرف اشارہ کرتا ہے اور اسناد ساتھ لے جاتا ہے۔
براؤزر یا ڈیسک ٹاپ کے لیے، دکھایا گیا لنک (یا ڈیوائس ID اور پیئرنگ کلید) نئے کلائنٹ میں کاپی کریں۔ ایک ٹیپ والا لنک صرف اُس وقت ملتا ہے جب آپ ویب کلائنٹ سے پیئر کر رہے ہوں، کیونکہ ڈیسک ٹاپ بائنری کے پاس ایسا لنک بنانے کے لیے کوئی ویب اوریجن نہیں ہوتا۔

فون کا QR اور وہ لنک جو CLI پر cc_server pair --client-url پرنٹ کرتا ہے، مختلف پے لوڈز ہیں اور ایک دوسرے کے متبادل نہیں: CLI والا لنک ویب کلائنٹ کے کنیکٹ فارم کو بھرتا ہے، جبکہ یہ QR Remote PWA کے لیے سرور کا مکمل کنکشن ڈسکرپٹر اور شناخت کی فنگر پرنٹ ساتھ لے جاتا ہے۔

فون کی طرف، پیئرنگ لنک کھولنے سے خاموشی سے پیئرنگ نہیں ہوتی۔ Remote سرور کا اشتہار کردہ نام دکھاتا ہے اور کچھ بھی محفوظ کرنے سے پہلے آپ سے تصدیق مانگتا ہے، اس لیے جعلی لنک ایپ کو کسی اور کے سرور پر ہائی جیک نہیں کر سکتا۔

پیئر شدہ ڈیوائسز منظم کریں

ترتیبات → آپ → آپ کی ڈیوائسز سے آپ یہ کر سکتے ہیں:

کسی ڈیوائس کا نام بدلیں
کسی ایسی ڈیوائس کو منسوخ کریں جس پر آپ کو مزید بھروسا نہیں۔ منسوخی اس کی اسناد تباہ کر دیتی ہے اور اس کا لائیو سیشن چند سیکنڈ میں ختم کر دیتی ہے، چنانچہ دوبارہ کنیکٹ کرنے پر رسائی خود بخود مسترد ہو جاتی ہے

گمشدہ یا تبدیل شدہ فون کے لیے منسوخی ہی درست اقدام ہے۔ ڈیوائس کی نظر سے یہ فوری اور ناقابلِ واپسی ہے۔

اس پینل سے جاری کردہ اسناد وقت تک محدود ہیں: یہ جاری ہونے کے 30 دن بعد ختم ہو جاتی ہیں اور اس کے بعد کنیکٹ گیٹ انہیں مسترد کر دیتا ہے۔ کمانڈ لائن پر cc_server pair سے جاری کردہ اسناد کی کوئی میعاد ایکسپائری نہیں ہوتی — جس مشین کے لیے یہ بنی تھی وہ ریٹائر ہونے پر اسے خود ہاتھ سے منسوخ کر دیں۔

فون سے ورک اسپیسز تبدیل کریں

پیئر شدہ فون ڈیسک ٹاپ سے آزادانہ طور پر ورک اسپیسز کے درمیان تبدیل ہو سکتا ہے۔ فون ہر کال کے ساتھ ورک اسپیس بھیجتا ہے اور سرور ہر کال پر اُس ورک اسپیس میں آپ کی رکنیت اور کردار چیک کرتا ہے — لہٰذا فون صرف انہی ورک اسپیسز تک پہنچتا ہے جن کے آپ رکن ہیں اور وہاں تبدیلی کرنے سے ڈیسک ٹاپ پر دکھائی دینے والی چیزوں پر کوئی فرق نہیں پڑتا۔

فون سیشن مزید ایک چھوٹی سی اجازت یافتہ فہرست تک محدود ہے جس میں زیادہ تر پڑھنے والے ٹولز شامل ہیں: یہ ٹکٹس، ایجنٹس، اسپیسز، پیغامات اور فیڈ مضامین کی فہرست اور مطالعہ کر سکتا ہے اور کسی ٹکٹ کو اپ ڈیٹ یا تفویض کر سکتا ہے، کسی اسپیس میں پیغام بھیج سکتا ہے اور کسی مضمون کو پڑھا ہوا یا محفوظ شدہ نشان زد کر سکتا ہے۔ اس فہرست سے باہر کی کوئی بھی چیز سرور کے ڈسپیچر تک پہنچنے سے پہلے مسترد کر دی جاتی ہے۔