bifrost-proxy/bifrostوكيل MITM عالي الأداء لـ HTTP/HTTPS/SOCKS5 مكتوب بلغة Rust مع اعتراض TLS، وإعادة كتابة الطلبات القائمة على القواعد، والتقاط حركة المرور، ونقاط التوقف، وصندوق رمل للسكربتات، وإعادة تشغيل الطلبات عبر واجهة الويب.
خادم وكيل HTTP/HTTPS/SOCKS5 عالي الأداء
اللغة: 中文 | English
Bifrost هو خادم وكيل عالي الأداء وصديق للذكاء الاصطناعي، مكتوب بلغة Rust، مستوحى من Whistle. يوفر اعتراض الطلبات، وتعديل القواعد، واعتراض TLS، وتوسيع السكربتات، وعرض حركة المرور، وإعادة تشغيل الطلبات، وقدرات إدارة واجهة الويب.
تثبيت CLI؛ وعلى macOS وWindows يتم تثبيت تطبيق سطح المكتب تلقائيًا أيضًا:
الطريقة الأولى: التثبيت باستخدام سكربت
macOS / Linux / Git Bash:
curl -fsSL https://raw.githubusercontent.com/bifrost-proxy/bifrost/main/install-binary.sh | bash
Windows PowerShell:
irm https://raw.githubusercontent.com/bifrost-proxy/bifrost/main/install-binary.ps1 | iex
يقوم هذا السكربت دائمًا بتثبيت CLI، ويقوم تلقائيًا بتثبيت تطبيق سطح المكتب من نفس الإصدار على macOS / Windows؛ أما المنصات التي لا توفر حزمة تثبيت لسطح المكتب مثل Linux فتبقى CLI-only. إذا كنت تحتاج CLI فقط، يمكنك استخدام --no-desktop (Bash / Git Bash) أو BIFROST_INSTALL_AUTO_DESKTOP=0 (Bash / PowerShell) لتخطي تطبيق سطح المكتب. بعد ذلك يقوم السكربت أيضًا بتثبيت شهادة CA والوثوق بها، وتثبيت جميع مهارات Bifrost AI، وتشغيل Bifrost كخدمة في الخلفية؛ بعد اكتمال التثبيت يمكنك الوصول مباشرة إلى لوحة الإدارة.
تقوم سكربتات التثبيت لكل من Bash وPowerShell بالكشف التلقائي عن الاتصال المباشر بـ GitHub ومصادر المرايا المدمجة، وتستخدم عنوان تنزيل الإصدار الأسرع المتاح بالأولوية؛ وفي الشبكات المقيّدة يمكن أيضًا تحديد المرآة المفضلة عبر BIFROST_GITHUB_MIRROR. يقوم سكربت Windows PowerShell بإضافة دليل التثبيت إلى الجلسة الحالية وإلى Path الخاص بمستخدم Windows؛ كما يقوم سكربت Git Bash على Windows بكتابة ذلك أيضًا إلى Path الخاص بمستخدم Windows، بحيث يمكن تنفيذ bifrost مباشرة في نافذة PowerShell/CMD جديدة.
تثبيت إصدار محدد
macOS / Linux / Git Bash:
curl -fsSL https://raw.githubusercontent.com/bifrost-proxy/bifrost/main/install-binary.sh | bash -s -- --version v0.0.96
Windows PowerShell:
$installer = irm https://raw.githubusercontent.com/bifrost-proxy/bifrost/main/install-binary.ps1
& ([scriptblock]::Create($installer)) -Version v0.0.96
الطريقة الثانية: التثبيت باستخدام npm
npm i -g @bifrost-proxy/bifrost
المزيد من طرق التثبيت: docs/getting-started.md
التحقق من الوكيل:
bifrost status
بعد التشغيل، يمكنك الوصول إلى لوحة الإدارة:
http://127.0.0.1:9900/_bifrost/
قبل إعداد الوكيل على الهاتف أو الجهاز اللوحي أو جهاز كمبيوتر آخر، افتح أولًا Settings -> Certificate -> Availability Check في واجهة الويب. بعد اختيار عنوان IP المحلي لجهاز الكمبيوتر الحالي، قم بإنشاء رمز QR أو رابط، ثم قم بالوصول إليه من الجهاز الهدف ليتم تلقائيًا فحص ثلاثة أمور:
بعد نجاح الفحص، ستعرض الصفحة عنوان الوكيل القابل للنقر والنسخ <عنوان IP المحلي>:<المنفذ>، ويمكنك أيضًا فتح رمز QR الخاص بالوكيل لمتابعة الإعداد. إذا فشل الفحص، ستعرض الصفحة الخطوة التالية وفقًا لنظام iOS/Android: تثبيت CA، أو على iOS الدخول إلى الإعدادات > عام > حول > إعدادات الثقة بالشهادات لتفعيل الثقة الكاملة، أو الموافقة على وصول الوكيل لهذا الجهاز من لوحة الإدارة.
bifrost install-skill -y
يدعم ASR Daily Agent تقسيم تقرير يومي واحد إلى عدة أسئلة بحثية مستقلة، ويقوم ChatGPT Web بإنشاء جلسات منفصلة لكل منها. يمكن اختياريًا تكوين chatgpt_project_url لتوزيع البحث؛ وبعد التكوين، سيتم أرشفة الجلسات الجديدة إلى ChatGPT Project المحدد، مع الاستمرار في فرض استخدام وضع Chat ونموذج Pro:
{
"max_questions": 8,
"chatgpt_interface_mode": "chat",
"chatgpt_model": "pro",
"chatgpt_project_url": "https://chatgpt.com/g/g-p-<project-id>/project"
}
لمعرفة مجموعة Agent الكاملة، وبيان البحث، وحدود الفشل، راجع design/asr-daily-agent-pipeline.md.
breakpoint://request / breakpoint://response مؤقتًا في واجهة الويب، وتحرير الرؤوس/المحتوى ثم المتابعة؛ راجع docs/breakpoint.md/_bifrost/api/system/memory استهلاك كاتبات ملفات body/ws وحالة التنبيه عند الاقتراب من حد المقابضreqScript وresScript وdecodeبعد استنساخ المستودع، قم بتنفيذ تهيئة Git hook مرة واحدة:
bash scripts/setup-git-hooks.sh
# أو
make setup
سيؤدي هذا إلى كتابة core.hooksPath=.githooks محليًا لهذا المستودع، وحتى إذا كان هناك hooksPath عام مُكوَّن على الجهاز، فإن git commit اللاحق سينفذ .githooks/pre-commit داخل المستودع بالأولوية. يقوم pre-commit الافتراضي بفحص تنسيق مساحة العمل، وتنسيق Tauri لتطبيق سطح المكتب، بالإضافة إلى cargo clippy --workspace --all-targets --all-features -- -D warnings.
تطبيق سطح المكتب مناسب لالتقاط الحزم اليومي، وعرض حركة المرور، وتحرير القواعد، وتحديث Bifrost، دون الحاجة إلى حفظ أوامر CLI أولًا:
Assets الخاصة بأحدث إصدار..dmg المطابق لشريحتك، فاختر aarch64-apple-darwin لأجهزة Apple Silicon، وx86_64-apple-darwin لأجهزة Intel Mac..msi، فاختر x86_64-pc-windows-msvc لأجهزة x64 العادية، وaarch64-pc-windows-msvc لأجهزة ARM..dmg ثم اسحب Bifrost.app إلى Applications، وعلى Windows انقر نقرًا مزدوجًا على .msi واتبع المعالج للتثبيت.إذا كنت ترغب في تثبيت قدرات سطر الأوامر أيضًا في تطبيق سطح المكتب، فافتح Settings في تطبيق سطح المكتب، وانقر على Install CLI & Skills ضمن Desktop Proxy Core. راجع البرنامج التعليمي المفصل في docs/desktop.md.
الأوامر الشائعة:
# عرض الحالة
bifrost status
# إيقاف الخدمة
bifrost stop
# الوصول عن بُعد إلى لوحة الإدارة والمصادقة (Web UI)
bifrost admin remote status
bifrost admin remote enable
bifrost admin passwd
bifrost admin revoke-all
# عرض حركة المرور
bifrost traffic list
bifrost traffic search "keyword" --method POST --host api.openai.com --path /v1/responses
bifrost search "keyword" --req-header
bifrost search "keyword" --res-body
# إضافة قاعدة
bifrost rule add local-dev --content "example.com host://127.0.0.1:3000"
# تحرير القاعدة الافتراضية العامة، وسيتم تطبيقها تلقائيًا على المنفذ الرئيسي وجميع المنافذ المؤقتة
bifrost rule update Default --content "internal.example.test dns://10.0.0.53"
ملاحظات إضافية حول أوامر البحث:
bifrost search مكافئ لـ bifrost traffic searchtraffic list والبحث افتراضيًا تنازليًا حسب وقت الطلب، وعند تساوي الطابع الزمني تنازليًا حسب الرقم التسلسلي؛ الأحدث المطابق له الأولوية، و--limit افتراضيًا 50، ويتجاوز --max-results في البحث --limit صراحةً--method و--host و--path و--status و--protocol؛ وpath هو سلسلة فرعية حرفية، ولا يُعامل % و_ كأحرف بدل--req-json/--res-json الجذر $، والمسارات النقطية، وفهارس المصفوفات و[*]؛ ويتم الإبلاغ عن خطأ مباشرة عند وجود مسار غير صالح أو تعبيرات قيم مثل الوقت أو الرؤوس أو أسماء include--latest 5m تعني آخر 5 دقائق، وليس جلب عنصر واحد فقط؛ ويمكن استخدام شروط التصفية مباشرةً في المخرجات المهيكلة بدون كلمات مفتاحية، دون الدخول إلى TUItraffic get --ids ID1,ID2 يكون افتراضيًا NDJSON؛ ويؤدي --format json-pretty الصريح إلى إرجاع {"results":[...]} منسّق--url و--req-header و--res-header و--req-body و--res-body--headers يبحث في رؤوس الطلب والاستجابة معًا، و--body يبحث في محتوى الطلب والاستجابة معًاأمثلة على القواعد:
example.com host://127.0.0.1:3000
api.example.com reqHeaders://x-debug=1&x-env=ppe&x-use-ppe=1
chatgpt.com http3://
internal-api.example.test https://10.37.102.138:8080 upstreamUnsafeSsl://true
يمكن فصل قيم reqHeaders:// وresHeaders:// المضمّنة في سطر واحد بـ & لعدة رؤوس؛ وإذا كانت قيمة الرأس نفسها تحتوي على & حرفي، فيرجى استخدام كائن JSON أو كتابة Values block برأس واحد في كل سطر.
Default هي القاعدة الافتراضية العامة التي ينشئها Bifrost تلقائيًا، وهي مفعّلة دائمًا ومثبتة في أعلى القائمة. لا يمكن حذفها أو تعطيلها أو إعادة تسميتها أو مزامنتها إلى الطرف البعيد، لكن يمكن تحرير محتواها؛ وهي مناسبة لوضع إعدادات DNS الموحدة، والرؤوس العامة، والاحتياطي لـ TLS، وغيرها من الإعدادات التي تحتاج جميع المنافذ إلى مشاركتها. راجع docs/rule.md.
docs/README.mddocs/overview.mddocs/getting-started.mddocs/cli.mddocs/desktop.mddocs/rule.mddocs/operation.mddocs/pattern.mddocs/rules/README.mddocs/scripts.mddocs/values.mddocs/replay.mddocs/breakpoint.mddocs/architecture.mddocs/agent-skill.md