دليل النشر

استضافة Karakeep على VPS: مدير إشارات مرجعية ذكي مع Ollama

انشر على VPS Cloud ←

دليل عملي

استضافة Karakeep على VPS: مدير إشارات مرجعية ذكي مع Ollama

الاستضافة الذاتية6 دقائق للقراءةعدد الخطوات: 7

كل مطور يتراكم لديه روابط ينوي قراءتها لاحقًا. معظمها ينتهي في قبر من تبويبات المتصفح أو خدمة مرجعية سحابية تُنمذِج عادات قراءتك. Karakeep يحل هذا: مدير إشارات مرجعية مستضاف ذاتيًا يزحف ويلتقط لقطات ويفهرس كل ما تحفظه — ويدع LLM محليًا يصنّف ويلخص تلقائيًا، حتى تجد ما حفظته قبل شهرين.

المحتويات· مشكلة مديري الإشارات السحابيين1/6
  1. 01مشكلة مديري الإشارات السحابيين
  2. 02ما يفعله Karakeep وما لا تفعله الخدمات السحابية
  3. 03المعمارية: ثلاث حاويات على VPS واحد
  4. 04استضافة Karakeep ذاتيًا على VPS: خطوة بخطوة
  5. 05اقرن Karakeep مع n8n للحفظ التلقائي
  6. 06Karakeep كقاعدة معرفة AI

مشكلة مديري الإشارات السحابيين

Pocket وRaindrop.io وInstapaper مريحة، لكن كل رابط تحفظه يُعلِّم شبكة إعلانات عن اهتماماتك. وإذا أُغلقت الخدمة، يذهب أرشيفك معها. ولا أيٌّ منها يمنحك بحثًا بالنص الكامل في محتوى الصفحة الفعلي.

Karakeep هو الحل المستضاف ذاتيًا: مفتوح المصدر تحت AGPL-3.0، 26 ألف نجمة+ على GitHub، قابل للنشر كثلاث حاويات Docker على VPS بـ 2 GB في أقل من عشر دقائق.

ما يفعله Karakeep وما لا تفعله الخدمات السحابية

  • يزحف ويؤرشف محتوى الصفحة الكامل عند الحفظ — ابحث في نص المقالة لا في عنوانها فقط، حتى بعد اختفاء الصفحة.
  • Chrome headless يلتقط لقطة شاشة لكل URL — أرشيف مرئي لما بدت عليه الصفحة عند حفظها.
  • تصنيف AI تلقائي عبر Ollama المحلي أو OpenAI — أضف رابطًا واحصل على تصنيفات تُولَّد تلقائيًا.
  • بحث بالنص الكامل عبر Meilisearch — استعلامات بالميلي ثانية عبر كل المحتوى المحفوظ.
  • PWA للجوال — أضف إشارات من قائمة المشاركة الأصلية لهاتفك مباشرة.
  • REST API — ادفع واسحب الإشارات برمجيًا؛ اربط n8n وامتدادات المتصفح.

المعمارية: ثلاث حاويات على VPS واحد

يعمل Karakeep بثلاث حاويات Docker:

1. تطبيق Karakeep (Node.js) — المنفذ 3000، ~300 MB ذاكرة في الخمول.
2. Meilisearch — محرك البحث بالنص الكامل، داخلي فقط (المنفذ 7700). ~200 MB.
3. Alpine Chrome (headless) — يزحف للصفحات ويلتقط لقطات، داخلي فقط (المنفذ 9222). ~300 MB.

المجموع في الخمول: 800 MB–1.2 GB. VPS بـ 2 GB مريح؛ بـ 4 GB موصى به مع Ollama على نفس الخادم.

استضافة Karakeep ذاتيًا على VPS: خطوة بخطوة

  1. اطلب VPS

    اختر VPS ServOrbit Cloud بذاكرة لا تقل عن 2 GB (Ubuntu 22.04). إذا كنت تخطط لتشغيل Ollama على نفس الخادم، VPS بـ 4 GB خيار أفضل.

  2. انشر من marketplace ServOrbit

    اختر Karakeep في قسم Collaboration والإنتاجية. يشغّل المُجهِّز الحاويات الثلاث، ويُولِّد NEXTAUTH_SECRET وMEILI_MASTER_KEY تلقائيًا، وتصبح واجهة الويب متاحة على المنفذ 3000. أول مستخدم يسجل = المشرف.

  3. إعداد النطاق + SSL

    وجّه نطاقاً فرعياً (مثل bookmarks.yourdomain.com) إلى عنوان خادمك لدى Cloudflare أو مزوّد الـ DNS. وكتلة الوكيل العكسي المعتادة في Nginx مع Let's Encrypt: server على listen 443 ssl، وserver_name bookmarks.yourdomain.com، وداخل location / توجيه proxy_pass http://127.0.0.1:3000; مع proxy_set_header Host $host; وproxy_set_header X-Real-IP $remote_addr;.

    وبعد تفعيل الشهادة، حدّث NEXTAUTH_URL=https://bookmarks.yourdomain.com في ملف docker-compose.yml ثم أعد تشغيل حاوية التطبيق بالأمر docker compose up -d. إذ يشترط NextAuth تطابق العنوان تماماً كي يعمل ملف تعريف الارتباط الخاص بالمصادقة.

  4. ربط Ollama للتصنيف AI المحلي (اختياري)

    إن كان Ollama يعمل على الخادم نفسه (وهو متاح في كتالوج ServOrbit)، فحرّر بيئة Karakeep في docker-compose.yml وأضف OLLAMA_BASE_URL: http://localhost:11434 وOLLAMA_KEEP_ALIVE: "10m".

    ومن واجهة Karakeep، انتقل إلى الإعدادات ← الذكاء الاصطناعي واختر نموذج Ollama (مثل phi3:mini للسرعة أو llama3.2 للجودة). احفظ رابطاً: خلال ثوانٍ تظهر الوسوم والملخّص. ومن دون Ollama أو مفتاح OpenAI يبقى Karakeep يعمل بالكامل، فالتصنيف التلقائي خيار لا شرط.

  5. تثبيت الامتداد والـ PWA

    ثبّت امتداد Karakeep (Chrome/Firefox). على الجوال افتح نسختك وأضفها للشاشة الرئيسية كـ PWA.

  6. استيراد الإشارات الموجودة

    اذهب لـ Settings → Import. التنسيقات المدعومة: Pocket JSON وNetscape bookmarks وتنسيق النسخ الاحتياطي لـ Karakeep.

  7. أول تسجيل دخول

    افتح الرابط ثم اضغط على «Sign up»: فأول حساب يُسجَّل على الإطلاق يصبح مدير النسخة. أنشئه فورًا.

اقرن Karakeep مع n8n للحفظ التلقائي

REST API لـ Karakeep يقبل POST /api/v1/bookmarks. في n8n استخدم عقدة HTTP Request لدفع روابط من موجزات RSS أو Slack أو أي webhook مباشرة لـ Karakeep.

Karakeep كقاعدة معرفة AI

Karakeep + Ollama على VPS واحد = قاعدة معرفة خاصة كاملة حيث LLM يقرأ ويصنّف كل ما تحفظه، والبحث بالنص الكامل يجده فورًا — بلا بيانات تغادر خادمك. كما يكشف Karakeep search API يمكن لعملاء n8n أو LLM الاستعلام منه.

إشاراتك، خادمك، ذكاؤك الاصطناعي

انشر Karakeep على VPS ServOrbit وامنح قاعدة معرفتك مسكنًا خاصًا — بحث بالنص الكامل، تصنيف AI تلقائي مع Ollama المحلي، وPWA للجوال، بلا حساب سحابي.

بحاجة إلى مساعدة؟

تصفّح مركز المساعدة والأسئلة الشائعة، أو تواصل مع فريقنا — معاودة اتصال أو WhatsApp أو بريد إلكتروني. الدعم بـالعربية والفرنسية والإنجليزية.

راسلنا على WhatsAppيُفتح في علامة تبويب جديدة