p1sec/qcsuperQCSuper هي أداة تتواصل مع الهواتف وأجهزة المودم القائمة على معالجات Qualcomm، مما يتيح التقاط إطارات الراديو الخام لشبكات 2G/3G/4G، من بين أمور أخرى.
QCSuper هي أداة تتواصل مع الهواتف وأجهزة المودم القائمة على Qualcomm، وتسمح بـالتقاط إطارات الراديو الخام لشبكات 2G/3G/4G (وبالنسبة لبعض الطرازات 5G)، من بين أشياء أخرى.
ستتيح لك إنشاء ملفات PCAP لالتقاطها باستخدام هاتف Android بصلاحيات الروت، أو دونغل USB، أو ملف التقاط موجود بتنسيق آخر.
بعد تثبيته، يمكنك توصيل هاتفك المجذّر عبر USB واستخدامه مع جهاز متوافق بكل بساطة كما يلي:```bash qcsuper --adb --wireshark-live
أو، إذا قمت بتمكين كشف منفذ Diag يدويًا على هاتفك (قد يختلف الإجراء المقابل اعتمادًا على مودم هاتفك والشركة المصنعة، انظر أدناه لمزيد من التوضيحات)، أو إذا قمت بتوصيل دونغل نطاق عريض متنقل:```bash
qcsuper --usb-modem auto --wireshark-live
يستخدم بروتوكول Qualcomm Diag، المعروف أيضًا باسم QCDM أو DM (Diagnostic Monitor)، للتواصل مع النطاق الأساسي لهاتفك.
هل ترغب في الإبلاغ عما إذا كان جهازك يعمل أم لا؟ يمكنك فتح مشكلة على GitHub.
الملاحق:
تدوينة/عرض توضيحي: تقديم QCSuper: أداة لالتقاط حركة مرور 2G/3G/4G عبر الأثير على هواتف Qualcomm
مزيد من الوثائق:
تم اختبار QCSuper مؤخرًا وتطويره على Ubuntu LTS 22.04+ كما استُخدم أيضًا على Windows 11. يعتمد على عدد من وحدات Python. يُنصح باستخدام لينكس لتوافق أفضل.
لاستخدامه، يجب أن يكون هاتفك متجذرًا (Root) أو يعرض منفذ خدمة diag عبر USB. للتحقق من التوافق مع هاتفك، ابحث عن طراز الهاتف على موقع مثل GSMArena وتحقق مما إذا كان يحتوي على معالج Qualcomm.
لفتح ملفات PCAP التي ينتجها QCSuper، يمكنك استخدام أي إصدار من Wireshark 2.x - 4.x لإطارات 2G/3G، لكنك تحتاج إلى Wireshark 2.5.x على الأقل لإطارات 4G (وإصدار 2.6.x لرسائل NAS الفردية التي تم فك تشفيرها من إطارات 4G). يوفر Ubuntu حاليًا إصدارًا حديثًا بما يكفي لجميع الإصدارات.
تم اختبار فك تشفير إطارات 5G باستخدام Wireshark 3.6.x والإصدارات الأحدث، وسيتم ذلك من خلال التثبيت التلقائي لملحق Lua الخاص بـ Wireshark (في %APPDATA%\Wireshark\plugins على ويندوز أو في ~/.local/lib/wireshark/plugins على لينكس وmacOS)، ويمكن تجنب ذلك عن طريق تعيين متغير البيئة DONT_INSTALL_WIRESHARK_PLUGIN=1 إذا كنت ترغب في تجنبه.
لتثبيت الإصدار الثابت من QCSuper على مستوى النظام من PyPI، يمكنك تشغيل هذه الأوامر:```bash
sudo apt install python3-pip wireshark
sudo pip3 install --upgrade qcsuper --break-system-packages
بعد ذلك، يمكنك فقط كتابة `qcsuper` في الطرفية لتشغيل QCSuper.
لتثبيت نسخة التطوير في مجلد معين، افتح الطرفية واكتب ما يلي:```bash
# Download QCSuper
git clone https://github.com/P1sec/qcsuper
cd qcsuper
# Install dependencies
sudo apt install python3-pip wireshark
sudo pip3 install --upgrade . --break-system-packages
ثم، قم بتشغيل QCSuper من المجلد qcsuper/ باستخدام الأمر ./qcsuper.py في الطرفية.
في لينكس، يمكنك تثبيت QCSuper باستخدام مدير الحزم uv الذي يُعد بديلًا حديثًا لـ PIP.
أولًا، قم بتشغيل أحد هذه الأوامر في الطرفية لتثبيت uv:```bash
sudo snap install --classic astral-uv # On Ubuntu
sudo dnf install -y uv # On Fedora
sudo pacman -S uv # On Archlinux, Manjaro
curl -LsSf https://astral.sh/uv/install.sh | sh # On Debian and others
ثم، قم بتشغيل هذا لتثبيت أحدث إصدار مستقر:```bash
uv tool install qcsuper
بدلاً من ذلك، يمكنك تثبيت أحدث إصدار تطويري باستخدام هذا الأمر:```bash uv tool install git+https://github.com/P1sec/qcsuper
يمكنك بعد ذلك فقط كتابة هذا في الطرفية الخاصة بك:```bash
qcsuper
ومع ذلك، إذا كنت بحاجة إلى تشغيل qcsuper كـ root، على سبيل المثال لأنك تقرأ بيانات من جهاز مودم، فقد لا يكون qcsuper في $PATH عند استخدام uv مع sudo، لذلك قد يتطلب الأمر القيام بشيء مثل:```bash
sudo env "PATH=$PATH" qcsuper
إذا كنت ترغب في المشاركة في تطوير الأداة، يمكنك استخدام هذه الأوامر من أجل تنزيل المصدر، ثم إنشاء روابط رمزية إلى QCSuper في `~/.local/bin` نحو دليل المصدر:```bash
git clone https://github.com/P1sec/qcsuper
cd qcsuper
uv sync # Create .venv in the current directory
uv tool install -e . # Create symlinks into ~/.local/bin
يمكن تشغيل QCSuper على ويندوز، ولكن يجب عليك مسبقًا التأكد من أن موجه ADB الخاص بجوجل يعمل بشكل صحيح على جهازك مع جهازك، كما يجب عليك أيضًا إنشاء عوامل تصفية libusb-win32 يدويًا (من خلال الأداة المتاحة في قائمة ابدأ بعد تثبيتها) في حال احتياج جهازك إلى الاتصال المباشر بمنفذ Diag عبر USB شبه تسلسلي.
(يرجى ملاحظة أنه إذا قمت بتبديل وضع جهازك، فقد تتغير معرفات USB PID/VID المرتبطة، وقد يتطلب الأمر إعادة ربط برامج التشغيل في أداة إنشاء عوامل تصفية libusb-win32 - و/أو في إدارة الأجهزة الطرفية في ويندوز حسب الحالة)
على ويندوز، قد تحتاج (بالإضافة إلى برامج تشغيل نواة ADB الخاصة بجوجل) إلى تنزيل وتثبيت برامج تشغيل USB الخاصة بهاتفك وفقًا لطراز هاتفك (قد يشمل ذلك برامج تشغيل USB العامة من Qualcomm). يرجى البحث في جوجل عن طراز هاتفك + "USB driver" أو "ADB driver" للحصول على الإرشادات.
بعد ذلك، تحتاج إلى التأكد من أنك تستطيع الوصول إلى جهازك باستخدام adb. يمكنك العثور على برنامج تعليمي حول كيفية تنزيل adb وإعداده هنا. يجب أن يعرض أمر adb.exe shell (أو أي مسار تنفيذي تستخدمه، توجد نسخة من ملف ADB التنفيذي في مجلد qcsuper/inputs/external/adb الخاص بـ QCSuper) موجه أوامر للمتابعة.
ثم اتبع هذه الروابط (تم اختبار الأداة مؤخرًا على ويندوز 11 - وهي غير مضمونة للعمل على ويندوز 7) بالترتيب التالي:
%PATH%.لتثبيت وحدات Python المطلوبة، افتح موجه الأوامر واكتب:```bash pip3 install --upgrade pyserial pyusb crcmod pycrate https://github.com/pyocd/libusb-package/archive/master.zip
بينما لا تزال في موجه الأوامر، انتقل إلى المجلد الذي يحتوي على QCSuper باستخدام الأمر `cd`. يمكنك بعد ذلك تنفيذ الأوامر (التي يجب أن تبدأ بـ `py qcsuper.py` أو `py3 qcsuper.py` إذا قمت بتثبيت Python 3 من المثبّت عبر الإنترنت، أو `python3.exe .\qcsuper.py` إذا قمت بتثبيته من متجر Windows).