دليل تركيب وتشغيل 9Router: موجه API مجاني لمطوري الذكاء الاصطناعي
بواسطةمَداد
MAP
خريطة الصفحة
اختر القسم الذي تحتاجه الآن
- ما هو 9Router؟
- من يحتاج 9Router؟
- المميزات الرئيسية
- المتطلبات الأساسية
- تركيب 9Router خطوة بخطوة
- شرح ملف .env
- أخطاء شائعة وحلولها
- استخدامات عملية
- هل يستحق 9Router التجربة؟
- بدائل مشابهة
- الأسئلة الشائعة
- خلاصة
!
قبل أن تطبق
الفكرة التي تمنع التسرع
يعتقد معظم المطورين أن الحصول على مفاتيح API مجانية وغير محدودة لأدوات AI هو حلم بعيد المنال، لكن 9Router يثبت العكس تماماً.
Q
أسئلة التشخيص السريع
قبل أن تطبق، اعرف أين تقف بالضبط
- هل تستخدم أدوات AI مثل Claude Code أو Cursor بشكل يومي؟
- هل تواجه مشكلة في حدود المفاتيح المجانية أو تكاليف API؟
- هل تريد تجربة نماذج AI متعددة دون تغيير الإعدادات يدوياً؟
- هل لديك خبرة في استخدام terminal و npm؟
نظام التشغيل: Input → Process → Output
INPUT
أدوات AI (Claude Code, Cursor, Copilot, Codex, Cline, Antigravity) ترسل طلبات API إلى 9Router.
PROCESS
9Router يستقبل الطلب، يختار أفضل مزود متاح (بناءً على التكلفة والتوفر)، يطبق تقنية RTK لتقليل التوكنز، ويرسل الطلب إلى المزود.
OUTPUT
يتم إرجاع الرد من مزود AI إلى الأداة الأصلية، مع توفير في التوكنز ووقت الاستجابة.
Decision Layer
يقرر 9Router أي مزود يستخدم بناءً على قواعد مسبقة: الأولوية للمجاني، ثم الأرخص، ثم الأسرع. إذا فشل مزود، يتحول تلقائياً إلى التالي.
Memory Layer
يحفظ 9Router إعدادات المستخدم في ملف .env، بما في ذلك مفاتيح API المفضلة والمزودين المفضلين.
Feedback Loop
عند تحديث README أو ظهور مشاكل جديدة، يتم تحديث الدليل بناءً على ملاحظات المستخدمين والتغييرات في المشروع.
M
لوحة قياس النجاح
لا تعتمد على الانطباع؛ اختر مؤشراً تراجعه
إذا كنت مطوراً تستخدم أدوات AI مثل Claude Code أو Cursor أو Copilot، فأنت تعلم أن حدود المفاتيح المجانية والتكاليف الباهظة تشكل عائقاً كبيراً. 9Router هو حل مفتوح المصدر يمنحك وصولاً غير محدود إلى أكثر من 40 مزود نماذج AI، مع ميزة التبديل التلقائي عند فشل أحد المزودين، وتوفير يصل إلى 40% من التوكنز. في هذا الدليل، سنأخذك خطوة بخطوة لتثبيت 9Router محلياً على جهازك وتشغيله في دقائق.
ما هو 9Router؟
9Router هو موجه API مجاني ومفتوح المصدر (رخصة MIT) يسمح لك بربط أدوات AI المفضلة لديك بأكثر من 40 مزود نماذج AI، بما في ذلك Claude وGPT وGemini وغيرها. المشروع حصل على أكثر من 10,000 نجمة على GitHub وهو محدث باستمرار.
من يحتاج 9Router؟
إعلان
- المطورون الذين يستخدمون أدوات AI بشكل يومي ويريدون تقليل التكاليف.
- أصحاب المشاريع الصغيرة الذين يحتاجون إلى حل AI مرن وغير مكلف.
- صانعو المحتوى التقني الذين يجرون تجارب على نماذج متعددة.
- أي شخص يريد تجربة نماذج AI مختلفة دون التقيد بمزود واحد.
المميزات الرئيسية
المتطلبات الأساسية
- Node.js (الإصدار 18 أو أحدث)
- npm (مدير حزم Node)
- Git (لتنزيل المشروع من GitHub)
- اتصال بالإنترنت
تركيب 9Router خطوة بخطوة
الخطوة 1: تثبيت 9Router عبر npm
افتح terminal واكتب الأمر التالي:
npm install -g 9routerهذا الأمر سيثبت 9Router بشكل عام على نظامك.
الخطوة 2: إنشاء نسخة من ملف البيئة
بعد التثبيت، انتقل إلى المجلد الذي تريد تشغيل 9Router منه، ثم انسخ ملف .env.example:
cp .env.example .envالخطوة 3: تثبيت الاعتماديات
في نفس المجلد، شغّل الأمر:
npm installهذا سيقوم بتثبيت جميع المكتبات المطلوبة.
الخطوة 4: تشغيل الخادم
شغّل الأمر التالي لبدء الخادم:
PORT=20128 NEXT_PUBLIC_BASE_URL=http://localhost:20128 npm run devالآن، 9Router يعمل على المنفذ 20128. يمكنك الوصول إليه عبر http://localhost:20128.
شرح ملف .env
ملف .env يحتوي على إعدادات التهيئة. إليك أهم المتغيرات:
PORT: المنفذ الذي يعمل عليه الخادم (افتراضي 20128).NEXT_PUBLIC_BASE_URL: الرابط الأساسي للتطبيق.API_KEYS: يمكنك إضافة مفاتيح API للمزودين المفضلين لديك (اختياري).
ملاحظة: إذا لم تقم بإضافة مفاتيح، سيستخدم 9Router المزودين المجانيين المتاحين.
أخطاء شائعة وحلولها
استخدامات عملية
- ربط Claude Code بـ 9Router: قم بتعيين متغير البيئة ANTHROPIC_BASE_URL إلى http://localhost:20128/v1.
- استخدام Cursor مع 9Router: في إعدادات Cursor، اختر مزود API مخصص وأدخل رابط 9Router.
- تجربة نماذج متعددة: يمكنك التبديل بين Claude وGPT وGemini بسهولة.
هل يستحق 9Router التجربة؟
نعم، خاصة إذا كنت تستخدم أدوات AI بشكل متكرر وتبحث عن حل مجاني ومرن. المشروع نشط ومحدث، والمجتمع كبير. لكن إذا كنت تحتاج إلى دعم فني مضمون، قد تفضل الخدمات المدفوعة.
بدائل مشابهة
- OpenRouter: خدمة مدفوعة مع دعم واسع.
- LiteLLM: مكتبة مفتوحة المصدر تدعم مزودين متعددين.
- LocalAI: تشغيل نماذج محلياً دون الحاجة إلى API.
الأسئلة الشائعة
هل 9Router آمن؟
نعم، المشروع مفتوح المصدر ولا يخزن بياناتك. لكن تأكد من تشغيله في بيئة آمنة.
هل يمكن استخدام 9Router في الإنتاج؟
نعم، لكن يُنصح بمراقبة الأداء وإضافة مفاتيح API خاصة للمزودين المهمين.
ماذا لو واجهت مشكلة في التركيب؟
تفقد صفحة GitHub Issues أو ابحث في المجتمع.
خلاصة
9Router أداة قوية ومجانية تفتح آفاقاً جديدة لمطوري AI. باتباع هذا الدليل، يمكنك تثبيته وتشغيله في دقائق. جربه اليوم وشارك تجربتك مع المجتمع.
DO
Playbook التطبيق
خطوات عملية مرتبة من التشخيص إلى النتيجة
خطوة 1
تثبيت Node.js و npm
لماذا؟ 9Router يعمل على Node.js، لذا يجب تثبيته أولاً.
كيف؟ حمّل Node.js من الموقع الرسمي واتبع تعليمات التثبيت.
الناتج: Node.js و npm مثبتان على جهازك.
خطوة 2
تثبيت 9Router عبر npm
لماذا؟ الأمر npm install -g 9router يثبت الحزمة بشكل عام.
كيف؟ شغّل الأمر في terminal.
الناتج: 9Router مثبت.
خطوة 3
إعداد ملف .env
لماذا؟ ملف .env يحتوي على إعدادات التهيئة.
كيف؟ انسخ .env.example إلى .env وعدّل المتغيرات حسب الحاجة.
الناتج: ملف .env جاهز.
خطوة 4
تثبيت الاعتماديات
لماذا؟ npm install يقوم بتثبيت المكتبات المطلوبة.
كيف؟ شغّل الأمر في مجلد المشروع.
الناتج: جميع الاعتماديات مثبتة.
خطوة 5
تشغيل الخادم
لماذا؟ الأمر npm run dev يبدأ الخادم.
كيف؟ شغّل الأمر مع تحديد PORT و NEXT_PUBLIC_BASE_URL.
الناتج: الخادم يعمل على http://localhost:20128.
خطوة 6
ربط أدوات AI بـ 9Router
لماذا؟ لتوجيه طلبات API عبر 9Router.
كيف؟ في إعدادات الأداة، غيّر base URL إلى http://localhost:20128/v1.
الناتج: الأداة تستخدم 9Router.
TMP
قوالب جاهزة للنسخ
حوّل القراءة إلى تنفيذ سريع
إعدادات Claude Code مع 9Router
export ANTHROPIC_BASE_URL=http://localhost:20128/v1
إعدادات Cursor مع 9Router
في الإعدادات: API Provider -> Custom -> Base URL: http://localhost:20128/v1
ERR
مصفوفة الأخطاء
اعرف أين يتعثر الناس وكيف تتجنب ذلك
IF
شجرة القرار
ماذا تفعل حسب حالتك؟
إذا: إذا كنت تستخدم أدوات AI يومياً وتريد تقليل التكاليف
إذن: 9Router مناسب لك.
إذا: إذا كنت تبحث عن دعم فني مضمون
إذن: قد تفضل خدمة مدفوعة مثل OpenRouter.
إذا: إذا كنت تريد تشغيل نماذج محلياً
إذن: جرب LocalAI بدلاً من ذلك.
7D
خطة تطبيق 7 أيام
جدول صغير يمنع التسويف
- اليوم 1: تثبيت 9Router وتشغيله.
- اليوم 2: ربط أداة AI واحدة (مثل Claude Code).
- اليوم 3: تجربة Auto-fallback بإيقاف مزود.
- اليوم 4: إضافة مفاتيح API لمزودين مفضلين.
- اليوم 5: اختبار RTK ومقارنة استهلاك التوكنز.
- اليوم 6: ربط أداة ثانية (مثل Cursor).
- اليوم 7: مشاركة التجربة مع المجتمع.
FACT
حقائق سريعة تحفظها
نقاط مختصرة ترجع لها لاحقاً
1. 9Router مجاني تماماً ومفتوح المصدر.
2. يدعم أكثر من 40 مزود نماذج AI.
3. يقلل استهلاك التوكنز بنسبة 20-40%.
4. حصل على أكثر من 10,000 نجمة على GitHub.
FAQ
أسئلة شائعة
إجابات مباشرة على ما يبحث عنه الزائر
ABC
مصطلحات سريعة
تعريفات مختصرة تمنع الالتباس
API Router
موجه API يوزع الطلبات على مزودين متعددين.
Auto-fallback
التبديل التلقائي إلى مزود آخر عند فشل الأول.
RTK
تقنية لتقليل استهلاك التوكنز.
Q+
أسئلة مرتبطة يبحث عنها الناس
استخدمها كمسارات متابعة داخل نفس الموضوع
كيفية ربط Claude Code بـ 9Routerأفضل بدائل OpenRouter المجانيةتثبيت 9Router على Windowsشرح ملف .env في 9Router
لماذا هذا المرجع يتجاوز الموضوع نفسه؟
تحول القارئ: من مطور يعاني من حدود المفاتيح المجانية وتكاليف API إلى مطور يمتلك حلاً مجانياً ومرناً لربط أدوات AI بـ 40+ مزود.
- مشاريع AI مفتوحة المصدر مشابهة: LocalAI, LiteLLM
- أدوات AI تدعم API مخصص: Claude Code, Cursor, Copilot
SAVE
كيف تستخدم هذا المرجع لاحقاً؟
القيمة الحقيقية تظهر عند العودة والتطبيق
لا تتعامل معه كمقال يُقرأ مرة واحدة. استخدمه كلوحة تشغيل: ارجع للتشخيص عند ظهور المشكلة، وللقوالب عند التطبيق، ولمؤشرات القياس عند المراجعة.
9Router أداة قوية ومجانية تفتح آفاقاً جديدة لمطوري AI. باتباع هذا الدليل، يمكنك تثبيته وتشغيله في دقائق. جربه اليوم وشارك تجربتك مع المجتمع.
UPD
خطة تحديث هذا الدليل
حتى يبقى المرجع صالحاً مع الوقت
- تحديث الدليل عند إصدار إصدار جديد من 9Router.
- إضافة خطوات تركيب جديدة إذا تغيرت المتطلبات.
- تحديث قائمة المزودين المدعومين.
- إضافة حلول لأخطاء جديدة تظهر في Issues.
مقالات ذات صلة
دليل تركيب ClawMetry: لوحة مراقبة وكلاء OpenClaw AI في الوقت الفعلي
{"@context":"https://schema.org","@type":"Article","headline":"دليل تركيب ClawMe...
نظام تشغيل مشاريع GitHub: دليل عملي لتركيب واستخدام RamiKrispin/pydata-ny-ga-workshop
{"@context":"https://schema.org","@type":"Article","headline":"نظام تشغيل مشاريع...
دليل عملي: شرح مشروع free-llm-api-keys على GitHub – مفاتيح API مجانية لـ GPT وClaude وGemini
{"@context":"https://schema.org","@type":"Article","headline":"دليل عملي: شرح مش...