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، بحيث يمكن لـ PowerShell/CMD المفتوح حديثًا تنفيذ bifrost مباشرة.

تثبيت إصدار محدد

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.
• ما إذا كان الجهاز قادراً على الوصول إلى منفذ التحقق (probe) الخاص بـ 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"
}

اطلع على design/asr-daily-agent-pipeline.md للاطلاع على مجموعة الوكيل الكاملة وبيان البحث وحدود الفشل.

وصف الميزات

• نواة وكيل عالية الأداء: مبنية على Tokio + Hyper، تدعم التزامن العالي وإعادة استخدام الاتصالات
• دعم بروتوكولات متعددة: HTTP/1.1 وHTTP/2 وHTTP/3 وHTTPS وSOCKS5 وWebSocket وSSE وgRPC
• قدرة اعتراض TLS: تدعم إنشاء شهادات CA، وإصدار الشهادات الديناميكي حسب النطاق، واختيار الاعتراض/التمرير وفق القواعد، ويمكن السماح صراحةً بالشهادات غير الآمنة لقاعدة HTTPS واحدة في المنبع
• محرك القواعد: يدعم التوجيه، وإعادة كتابة الطلب/الاستجابة، والحقن، والتأخير، وتحديد المعدل، وMock، والمعالجة بالسكربتات
• واجهة الإدارة: واجهة Web UI مدمجة، تدعم تحرير القواعد، وعرض حركة المرور، وإدارة السكربتات، وإعادة إرسال الطلبات
• إعادة اتصال حركة المرور: توفر الإحصاءات والاستعلامات التزايدية ورسائل الدفع حقل database_epoch اختياريًا، يُستخدم للتعرف على قاعدة البيانات بعد استبدالها وإعادة جلب حركة المرور؛ إعادة التشغيل العادية تحافظ على الهوية، ومتوافقة مع الرسائل القديمة. راجع design/traffic-db-startup-resequence.md
• استعادة حركة المرور وتنظيفها: عند تراجع أرقام الطلبات المؤكدة بسبب نسخة احتياطية قديمة، تعيد واجهة Web UI قراءة حركة المرور؛ وعند فشل تنظيف قاعدة البيانات، تُرجع API خطأً وتحتفظ بالبيانات المرتبطة وحالة الاتصال.
• Breakpoint: يدعم إيقاف طلبات/استجابات HTTP المطابقة لقواعد breakpoint://request / breakpoint://response مؤقتًا في واجهة Web UI، وتحرير الترويسات/المحتوى ثم المتابعة؛ راجع docs/breakpoint.md
• تنبيهات المخاطر على الموارد: تعرض صفحة Performance و/_bifrost/api/system/memory حالة التنبيه لاستهلاك كاتبات ملفات body/ws والاقتراب من الحد الأقصى للمقابض
• صندوق رمل السكربتات: مبني على QuickJS، يدعم reqScript وresScript وdecode

تهيئة التطوير