Bifrost

خادم وكيل 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 أو رابط، ثم قم بالوصول إليه من الجهاز الهدف ليتم تلقائيًا فحص ثلاثة أمور:

ما إذا كان هذا الجهاز مسموحًا له بالوصول عبر التحكم في الوصول لوكيل Bifrost.
ما إذا كان الجهاز قادرًا على الوصول إلى منفذ الفحص الخاص بـ Bifrost.
ما إذا كان المتصفح الحالي يثق بالفعل بشهادة HTTPS الصادرة عن Bifrost CA.

بعد نجاح الفحص، ستعرض الصفحة عنوان الوكيل القابل للنقر والنسخ <عنوان 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.

وصف الميزات

نواة وكيل عالية الأداء: مبنية على Tokio + Hyper، وتدعم التزامن العالي وإعادة استخدام الاتصالات
دعم بروتوكولات متعددة: HTTP/1.1 وHTTP/2 وHTTP/3 وHTTPS وSOCKS5 وWebSocket وSSE وgRPC
قدرة اعتراض TLS: تدعم إنشاء شهادة CA، وإصدار الشهادات ديناميكيًا حسب النطاق، واختيار الاعتراض/التمرير حسب القواعد، ويمكن السماح صراحةً بالشهادات غير الآمنة لقاعدة HTTPS واحدة في المنبع
محرك القواعد: يدعم التوجيه، وإعادة كتابة الطلب/الاستجابة، والحقن، والتأخير، وتحديد السرعة، وMock، ومعالجة السكربتات
واجهة الإدارة: واجهة ويب مدمجة تدعم تحرير القواعد، وعرض حركة المرور، وإدارة السكربتات، وإعادة تشغيل الطلبات
Breakpoint: يدعم إيقاف طلبات/استجابات HTTP التي تطابق قواعد breakpoint://request / breakpoint://response مؤقتًا في واجهة الويب، وتحرير الرؤوس/المحتوى ثم المتابعة؛ راجع docs/breakpoint.md
تنبيهات مخاطر الموارد: تعرض صفحة Performance و/_bifrost/api/system/memory استهلاك كاتبات ملفات body/ws وحالة التنبيه عند الاقتراب من حد المقابض
صندوق رمل للسكربتات: مبني على QuickJS، ويدعم 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

الأكثر شعبية