مرجع سطر الأوامر

sqctl هو الطريقة التي تقود بها SecurQbit من الطرفية. يتحدث إلى الخدمة العاملة في الخلفية عبر مقبس محلي؛ لا يحتفظ ببيانات اعتماد ولا يحتاج إلى صلاحيات خاصة به. إن لم تكن قد ثبّته بعد، ابدأ من إعداد سطح المكتب والراوتر.

يقبل كل أمر الخيار --json، الذي يطبع المستند الخام بدل المخرجات المنسّقة. تلك هي الواجهة التي تُكتب لها السكربتات — أما التنسيق المقروء للبشر فقابل للتغيير.

نظرة سريعة

sqctl status                        هل الـ VPN يعمل، وبأي حساب
sqctl login                         تسجيل الدخول بالموافقة على رابط في المتصفح
sqctl logout
sqctl locations                     الدول المتاحة لهذه الخطة
sqctl connect [COUNTRY] [--fastest]
sqctl disconnect
sqctl set                           عرض التفضيلات
sqctl set country DE|any
sqctl set autoconnect on|off
sqctl set updates on|off
sqctl update [--check] [--yes]      تثبيت أحدث إصدار

sqctl status

يعرض ما إذا كنت محميًا، وبأي حساب.

$ sqctl status
 
  ● Connected      Germany
    Connected for  12m 40s
    Transferred    ↓ 148 MB   ↑ 22 MB
 
    Account        Alice  [email protected]
    Plan           Monthly
    Renews         1 September 2026

لا يعرض عن قصد أي شيء عن كيفية بناء النفق — لا عنوان خادم ولا معرّف جلسة. لا يمكنك التصرّف بناءً على أي منها، وعنوان الخادم بالذات ليس مما يُترك ليتسرّب في لقطة شاشة حين تطلب المساعدة.

إن لم تكن الخدمة تعمل، يخبرك sqctl بذلك ويطبع الأمر الذي يشغّلها على هذا الجهاز، أيًا كان نظام الإقلاع فيه.

sqctl login

يسجّل دخول هذا الحاسوب عبر الموافقة عليه في المتصفح.

$ sqctl login
 
Open this link to approve the sign-in:
 
    https://accounts.securqbit.com/device?code=BCDF-GHJK
 
Check the page shows this code:
 
    B C D F - G H J K
 
Waiting for approval — expires in 10 minutes, Ctrl-C to cancel

افتح الرابط — يحاول sqctl فتحه نيابة عنك، ويمنعه --no-browser من المحاولة — وسجّل الدخول إن لم تكن قد فعلت، وتحقّق من أن الرمز المعروض في الصفحة يطابق الذي في طرفيتك، ثم وافق. لا يُكتب أي شيء مجددًا في الطرفية.

هذه المقارنة هي كامل الأمان في هذه الآلية.

لا توافق إلا على طلب بدأته أنت. إن أرسل إليك أحدهم رابطًا كهذا ووافقت عليه، تكون قد أدخلت حاسوبه إلى حسابك. الرمز واسم الجهاز المعروضان في الصفحة موجودان لتتمكن من التمييز.

يتطلّب تسجيل الدخول حسابًا موجودًا مسبقًا. أنشئ واحدًا من تطبيق iOS أو Android — بما في ذلك حساب الضيف، الذي يدخل إلى accounts.securqbit.com برمز الاسترداد ويوافق من هناك مثل أي حساب آخر.

sqctl logout

يوقف الـ VPN ويسجّل خروج هذا الحاسوب. يُنزَل النفق أولاً، وذلك عن قصد: إبقاؤه قائمًا على بيانات اعتماد أُلغيت للتوّ يترك حركتك عالقة في جلسة يوشك الخادم على إزالتها.

يُطلب تأكيد أولاً في حالة حساب الضيف، لأنك بدون رمز الاسترداد لن تستطيع الدخول مجددًا. الخيار --force يتخطّى السؤال.

sqctl connect

sqctl connect            # تفضيلك المحفوظ
sqctl connect DE         # الظهور في ألمانيا
sqctl connect --fastest  # دع SecurQbit يختار

الدولة رمز من حرفين — شغّل sqctl locations لترى ما تسمح به خطتك. يستغرق الاتصال بضع ثوانٍ؛ وتتابع الطرفية الحالة الفعلية وهي تتغيّر بدل أن تصمت.

الخطط التجريبية لا تستطيع اختيار الدولة. مع خطة تجريبية استخدم --fastest. تسمية دولة يُرجع خطأً يوضّح أن الأمر يحتاج خطة مدفوعة، بدل أن يوصلك بهدوء إلى مكان آخر. راجع الحساب والفوترة.

sqctl disconnect

ينزل النفق ويعيد التوجيه وDNS إلى ما كانا عليه.

قطع الاتصال هو أيضًا ما يقول لـ SecurQbit أن يتوقّف. إن سقط النفق من تلقاء نفسه، تواصل الخدمة العمل على استعادته — وهو ما تريده في حاسوب محمول كان نائمًا أو راوتر تذبذبت وصلته. ولا يلغي هذه النيّة سوى sqctl disconnect أو تسجيل الخروج أو إيقاف الخدمة.

sqctl locations

يسرد بالاسم الدول المتاحة لخطتك.

$ sqctl locations
 
    DE             Germany
    FR             France
    NL             Netherlands
    SG             Singapore
    US             United States

sqctl set

يعرض تفضيلاتك أو يغيّرها. وهي ثلاثة، وهي الثلاثة التي يعود اختيارها إليك فعلاً.

sqctl set                    # عرض الثلاثة
sqctl set country DE         # ألمانيا افتراضيًا
sqctl set country any        # الأسرع افتراضيًا
sqctl set autoconnect on     # الاتصال فور إقلاع الجهاز
sqctl set updates off        # التوقّف عن البحث عن إصدارات جديدة

$ sqctl set
 
    Location       Germany (DE)
    Auto-connect   on
    Updates        on

كل ما عدا ذلك في النفق — كيف يُبنى، وما يستخدمه لـ DNS، وكيف يعيد المحاولة — مقرَّر نيابةً عنك وغير متاح من سطر الأوامر. فهذه ليست خيارات يتحسّن الـ VPN بعرضها.

updates إعداد لا ثابت، لأن التحقّق نداء دوري إلى شبكة توصيل المحتوى الخاصة بـ SecurQbit، ومن يشغّل VPN من حقه أن يرفضه.

sqctl update

يثبّت أحدث إصدار.

sqctl update            # يسأل، ثم يثبّت ويعيد التشغيل
sqctl update --check    # يخبرك فقط إن كان هناك إصدار
sqctl update --yes      # دون سؤال

$ sqctl update
 
  ! Update available
 
    Installed      v1.0.0
    Latest         v1.1.0
 
  SecurQbit restarts to finish, so the VPN disconnects for a moment.
 
Install it now? [y/N]

يُطابَق المُنزَّل مع المجاميع المنشورة قبل استبدال أي شيء، ثم تُعاد الخدمة على الإصدار الجديد. ينتظر sqctl عودتها ويقرأ منها الإصدار، فيخبرك بما يعمل فعلاً لا بما كُتب على القرص.

يتحقّق SecurQbit مرة يوميًا من تلقاء نفسه، ولا يفعل سوى إخبارك — بسطر تحت sqctl status:

    Update         v1.1.0 available — run: sqctl update

ولا يثبّت من تلقاء نفسه أبدًا. إتمام التحديث يعني إعادة التشغيل، وإعادة التشغيل تقطع أي نفق قائم؛ وفعل ذلك بأحدهم دون إنذار أسوأ من تركه متأخرًا بإصدار واحد.

إن كان SecurQbit مُثبَّتًا من مدير حزم توزيعتك، فإن sqctl update يرفض قبل تنزيل أي شيء ويطلب منك تحديثه بالطريقة نفسها التي ثبّته بها.

كتابة السكربتات

الخيار --json مع أي أمر يطبع مستند البروتوكول:

$ sqctl status --json | jq '.state, .country'
"connected"
"DE"

# اتصل ثم تحقّق من أنه نجح فعلاً
sqctl connect --fastest --json > /dev/null
test "$(sqctl status --json | jq -r .state)" = connected

رموز الخروج: 0 نجاح، 1 فشل الأمر، 2 تعذّر الوصول إلى خدمة SecurQbit.

حين يسوء شيء ما

يترجم sqctl الأعطال إلى ما يمكنك التصرّف بناءً عليه، ويُبقي التفاصيل الداخلية بعيدًا. وحين تحتاج تلك التفاصيل — لتقرير عن خلل — هناك أمر تشخيص مخفي:

sqctl debug          # الإصدارات، ومواضع الملفات، وأي مقبس استجاب،
                     # ومحرّك النفق، وآخر خطأ خام
sqctl debug probe DE # اختبار خادم من طرف إلى طرف دون الاتصال

sqctl debug probe هو الأنفع. يشغّل الوكيل تجاه خادم حقيقي، ويرسل عبره طلبًا واحدًا، ويبلّغ عن العنوان الذي رآه الطرف الآخر — لكنه لا ينشئ جهاز نفق ولا يغيّر أي مسار، فيخبرك إن كان الطريق يعمل دون أن يكلّفك اتصالك بالإنترنت إن لم يكن يعمل.

أرفق مخرجات sqctl debug عند الإبلاغ عن مشكلة. راجع استكشاف الأخطاء.

الخطوات التالية

• إعداد سطح المكتب والراوتر — التثبيت والتحديث والإزالة.
• الاتصال بخادم — كيف يجري اختيار الخادم.
• تجاوز الجدار الناري والتمويه — على شبكة مقيّدة.