🔖 تثبيت Linkwarden — مدير إشارات مرجعية وأرشفة ذاتي الاستضافة

انشر Linkwarden على Ubuntu بواسطة Docker — مدير إشارات مرجعية تعاوني ذاتي الاستضافة يؤرشف الصفحات كاملة ولقطات الشاشة وملفات PDF حتى لا تختفي روابطك أبداً.

⚠️ راجع أي سكريبت دائمًا قبل تشغيله على سيرفرك، واختبره في بيئة تجريبية أولاً.

📦 الملفات والأكواد المطلوبة

قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.

سكريبت تثبيت آلي — Linkwarden وقاعدة بيانات PostgreSQL الخاصة به جاهزان بأمر واحد.
عرض على GitHub

التثبيت السريع:

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/Tools/linkwarden/linkwarden-ubuntu.sh
chmod +x linkwarden-ubuntu.sh
sudo bash linkwarden-ubuntu.sh

خطوات التنفيذ

1 تحميل السكريبت

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/Tools/linkwarden/linkwarden-ubuntu.sh

2 منحه صلاحية التنفيذ

chmod +x linkwarden-ubuntu.sh

3 تشغيل المثبّت

يثبّت السكريبت Docker إذا لزم الأمر، ثم يشغّل حاوية Linkwarden مع قاعدة بيانات PostgreSQL، مع حفظ كل البيانات في أحجام تخزين محلية.

sudo bash linkwarden-ubuntu.sh

4 الدخول إلى واجهة الويب

افتح المتصفح وانتقل إلى صفحة إعداد Linkwarden لإنشاء حساب المشرف:

http://<your-server-ip>:3000

المنافذ المستخدمة

المنفذالغرض
3000Linkwarden Web UI (HTTP)
5432PostgreSQL database (internal)

نظرة عامة

Linkwarden هو مدير إشارات مرجعية مجاني ومفتوح المصدر وذاتي الاستضافة يتجاوز مجرد حفظ رابط. كل رابط تحفظه يُؤرشف تلقائياً كلقطة شاشة وملف PDF ونسخة HTML بملف واحد ونسخة نص قابل للقراءة، فيبقى المحتوى متاحاً حتى لو تغيّرت الصفحة الأصلية أو اختفت. مبني بـ Next.js وPostgreSQL، يدعم المجموعات والوسوم والبحث الشامل بالنص الكامل والتعاون الفوري، ما يجعله بديلاً خاصاً تملكه بنفسك لخدمات حفظ الإشارات وخدمات القراءة لاحقاً السحابية.

لماذا تستخدمه

الإشارات المرجعية المحفوظة في المتصفح مرتبطة بجهاز واحد، لا تقدم أرشفة، وتختفي فور تعطل الموقع أو حجبه خلف اشتراك مدفوع أو تعديل الصفحة — مشكلة تُعرف غالباً بـ link rot أو تعفن الروابط. يحل Linkwarden هذه المشكلة بالتقاط نسخة دائمة من كل صفحة تحفظها (لقطة شاشة، PDF، HTML، ونص قابل للقراءة) لحظة حفظها، فتبقى مادتك المرجعية موجودة حتى لو اختفى المصدر. وبما أنه ذاتي الاستضافة، تبقى قائمة قراءتك وأبحاثك ومقالاتك المحفوظة خاصة وتحت سيطرتك، بدون حدود حساب أو اشتراك، مع بحث شامل بالنص الكامل عبر كل ما حفظته على الإطلاق.

متى تحتاجه

  • إشاراتك المرجعية في المتصفح متناثرة عبر أجهزة متعددة وغالباً ما تقود لروابط ميتة عند العودة إليها
  • تعمل في البحث أو الصحافة أو المراجع وتحتاج إثباتاً لما كانت تقوله صفحة ما وقت حفظها
  • تريد التعاون مع فريق على مجموعة روابط مُنسّقة مشتركة بصلاحيات دقيقة
  • مستخدم متقدم لخدمات القراءة لاحقاً وتريد نسخاً مؤرشفة وقابلة للقراءة بدلاً من مجرد عناوين URL خام
  • تريد بحثاً شاملاً بالنص الكامل عبر كل ما حفظته من إشارات مرجعية، وليس فقط العناوين والوسوم
  • تريد وسماً تلقائياً بمساعدة الذكاء الاصطناعي للحفاظ على تنظيم مجموعة إشارات مرجعية كبيرة دون جهد يدوي

حالات الاستخدام الشائعة

  • بناء قاعدة معرفة شخصية مؤرشفة بشكل دائم للمقالات البحثية والمراجع
  • مشاركة مجموعة روابط مُنسّقة وتعاونية مع فريق، بصلاحيات تحرير لكل عضو
  • أرشفة المقالات الإخبارية والتدوينات قبل أن تُحجب خلف اشتراك مدفوع أو تُحذف
  • استبدال شريط الإشارات المرجعية بالمتصفح بمدير إشارات قابل للبحث والوسم عبر الأجهزة
  • حفظ روابط التوثيق والدروس التعليمية وملفات PDF في مجموعات منظمة لمشروع ما
  • توثيق محتوى صفحات الويب لأغراض البحث أو الصحافة أو النزاعات

الميزات الرئيسية

  • أرشفة تلقائية لكل رابط محفوظ كلقطة شاشة وPDF ونسخة HTML بملف واحد ونسخة نص قابل للقراءة
  • مجموعات بتنظيم هرمي وتعاون قابل للمشاركة مبني على الصلاحيات
  • وسم يدوي وآخر مدعوم بالذكاء الاصطناعي، مع دعم نموذج ذكاء اصطناعي محلي لوسم الصفحات تلقائياً
  • بحث شامل بالنص الكامل مدعوم بـ MeiliSearch عبر العناوين والوسوم والمجموعات ومحتوى الصفحات المؤرشفة
  • إضافات متصفح لـ Chrome وBrave وEdge وFirefox للحفظ بنقرة واحدة
  • تطبيقات جوال أصلية لـ iOS وAndroid
  • استيراد وتصدير الإشارات المرجعية، بما في ذلك الترحيل من خدمات حفظ إشارات أخرى
  • دعم حفظ ملفات PDF والصور كإشارات مرجعية بالإضافة لروابط الويب العادية

كيفية الاستخدام بعد التثبيت

  • افتح http://your-server-ip:3000 وسجّل أول حساب — يصبح هذا حساب مشرف Linkwarden
  • ثبّت إضافة المتصفح لـ Chrome أو Firefox أو Edge لحفظ الصفحات بنقرة واحدة أثناء التصفح
  • أنشئ مجموعات لتنظيم الإشارات المرجعية حسب الموضوع أو المشروع أو الفريق، واضبط صلاحيات المشاركة عند التعاون
  • احفظ رابطاً وتأكد من اكتمال مهمة الأرشفة — تحقق أن لقطة الشاشة وPDF والعرض القابل للقراءة تم توليدها بشكل صحيح
  • أضف وسوماً لروابطك المحفوظة، أو فعّل الوسم التلقائي بالذكاء الاصطناعي في الإعدادات إذا أعددت نموذج ذكاء اصطناعي محلي
  • ثبّت تطبيق الجوال على iOS أو Android وسجّل الدخول لحفظ الروابط أثناء التنقل
  • استورد إشاراتك المرجعية الحالية من المتصفح أو خدمة حفظ إشارات أخرى من Settings → Import
  • أعدّ وكيلاً عكسياً بـ HTTPS إذا كنت تخطط للوصول لـ Linkwarden أو استخدام إضافة المتصفح خارج شبكتك المحلية

أفضل ممارسات الأمان

  • غيّر قيمة NEXTAUTH_SECRET من القيمة الافتراضية في السكريبت إلى سلسلة عشوائية طويلة قبل كشف التثبيت للعموم
  • ضع Linkwarden خلف وكيل عكسي بـ HTTPS — تنقل إضافة المتصفح وتطبيق الجوال بيانات تسجيل الدخول
  • عطّل التسجيل العام بعد إنشاء حساباتك، إلا إذا كنت تنوي عمداً جعل Linkwarden خدمة متعددة المستخدمين
  • عيّن كلمات مرور قوية وفريدة لكل حساب مستخدم، خاصة أي حساب بصلاحيات مشرف أو مالك مجموعة
  • راجع صلاحيات مشاركة المجموعات بانتظام — يمكن منح المتعاونين حقوق تحرير أو حذف يجب مراجعتها دورياً
  • حافظ على تحديث صورة Docker وقاعدة بيانات PostgreSQL لتلقي رقع الأمان لتطبيق عام المواجهة
  • قيّد الوصول المباشر لمنفذ PostgreSQL ولا تكشفه أبداً خارج شبكة Docker الداخلية

المنافذ وإعدادات جدار الحماية

تستمع واجهة ويب Linkwarden على المنفذ 3000، وتعتمد على قاعدة بيانات PostgreSQL على المنفذ 5432 التي يجب أن تبقى داخلية ضمن شبكة Docker ولا تُكشف أبداً للمضيف أو الإنترنت. إذا استخدم Linkwarden خدمة MeiliSearch للبحث الشامل بالنص الكامل، تبقى تلك الخدمة أيضاً داخلية ولا تحتاج منفذاً منشوراً. لأي استخدام يتجاوز الاختبار المحلي، ضع المنفذ 3000 خلف وكيل عكسي مثل Nginx Proxy Manager بشهادة TLS صالحة، لأن إضافة المتصفح وتطبيقات الجوال ترسل بيانات تسجيل الدخول مع كل طلب. اكشف فقط منفذ HTTPS للوكيل العكسي على مستوى الجدار الناري، واحظر الوصول المباشر للمنفذين 3000 و5432 من خارج المضيف.

النسخ الاحتياطي والصيانة

  • انسخ حجم قاعدة بيانات PostgreSQL احتياطياً — فهو يحتوي كل حساب مستخدم ومجموعة ووسم وسجل رابط
  • انسخ حجم بيانات الأرشيف احتياطياً الذي يخزّن لقطات الشاشة وملفات PDF ونسخ HTML والنصوص القابلة للقراءة لكل رابط محفوظ
  • انسخ docker-compose.yml ومتغيرات البيئة احتياطياً، خاصة NEXTAUTH_SECRET — فقدانها قد يؤثر على جلسات المستخدمين الحالية
  • استخدم ميزة التصدير المدمجة في Linkwarden دورياً للاحتفاظ بنسخة قابلة للنقل من روابطك خارج تنسيق قاعدة البيانات
  • جدول نسخاً احتياطية تلقائية، لأن الملفات المؤرشفة تتراكم بسرعة وتمثل تخزيناً كبيراً لا يمكن تعويضه
  • اختبر استعادة نسخة احتياطية على تثبيت منفصل للتأكد أن قاعدة البيانات وملفات الأرشيف تعودان بشكل صحيح

الأخطاء الشائعة

  • ترك التسجيل العام مفعّلاً بعد الإعداد، مما يسمح لغرباء بتسجيل حسابات على تثبيتك
  • عدم نسخ حجم بيانات الأرشيف احتياطياً بشكل منفصل عن قاعدة البيانات — فقدانه يحذف كل لقطة شاشة وPDF ونسخة
  • كشف المنفذ 3000 أو 5432 مباشرة للإنترنت بدلاً من استخدام وكيل عكسي بـ HTTPS
  • استخدام قيمة NEXTAUTH_SECRET الافتراضية للسكريبت في تثبيت طويل الأمد أو عام المواجهة
  • التقليل من تقدير استخدام القرص — أرشفة لقطات الشاشة وملفات PDF ونسخ HTML لكل رابط يستهلك مساحة أكبر بكثير من الإشارات المرجعية العادية
  • تخطي إعداد إضافة المتصفح وإعادة إدخال الروابط يدوياً، ما يُفوّت الحفظ بنقرة واحدة والأرشفة الفورية

استكشاف الأخطاء وإصلاحها

  • فشل الأرشفة أو توقفها — تحقق أن الحاوية تملك ذاكرة كافية للمتصفح غير المرئي المستخدم لعرض لقطات الشاشة وملفات PDF، وراجع سجلات الحاوية
  • تعذر تسجيل الدخول عبر إضافة المتصفح أو تطبيق الجوال — تأكد أن NEXTAUTH_URL يطابق العنوان المتاح خارجياً وليس localhost فقط
  • البحث الشامل بالنص الكامل لا يُعيد نتائج — تحقق أن خدمة MeiliSearch تعمل ويمكن الوصول إليها إذا كان تثبيتك يتضمنها
  • واجهة الويب تُحمّل لكن الصور أو الملفات المؤرشفة معطلة — تحقق أن حجم بيانات الأرشيف مُركَّب بشكل صحيح ويملك مساحة قرص كافية
  • أخطاء اتصال بقاعدة البيانات عند البدء — تأكد أن حاوية PostgreSQL سليمة قبل بدء حاوية Linkwarden، وتحقق من قيمة DATABASE_URL
  • الوسم التلقائي بالذكاء الاصطناعي لا يعمل — تأكد أن نموذج ذكاء اصطناعي محلي مُعدّ ويمكن الوصول إليه، فهذه الميزة اختيارية ومعطلة افتراضياً

البدائل

Raindrop.io مدير إشارات مرجعية مستضاف شهير بباقة مجانية سخية وتطبيقات مصقولة، لكنه لا يؤرشف محتوى الصفحة كاملاً وبياناتك تعيش على خوادمهم. Wallabag يركز على حفظ المقالات للقراءة لاحقاً مع استخراج نص قابل للقراءة لكنه يفتقر لأرشفة لقطات الشاشة وPDF التي يقدمها Linkwarden. Shiori وLinkding مديرا إشارات مرجعية ذاتيا الاستضافة أخف — أبسط في التشغيل لكن بدون أرشفة كاملة للصفحات مدمجة أو وسم بالذكاء الاصطناعي أو تعاون فوري. Hoarder (المعروف حالياً باسم Karakeep) هو أقرب منافس ذاتي الاستضافة، ويقدم أيضاً أرشفة كاملة للصفحات ووسماً بالذكاء الاصطناعي بمعمارية مشابهة. كأداة ذاتية الاستضافة تجمع مجموعات تعاونية وأرشفة متعددة الصيغ وبحثاً شاملاً بالنص الكامل في حزمة واحدة، Linkwarden من أكثر الخيارات اكتمالاً المتاحة.

متى لا تستخدمه

إذا كنت تحتاج فقط بضع إشارات مرجعية شخصية ولا يهمك أرشفة محتوى الصفحات، فمزامنة الإشارات المرجعية المدمجة في المتصفح أو أداة خفيفة مثل Linkding أبسط في التشغيل وتستهلك مساحة تخزين أقل بكثير. الأرشفة التلقائية متعددة الصيغ في Linkwarden تعني أن استخدام القرص ينمو بسرعة، فهو ليس مثالياً على VPS صغير جداً بمساحة تخزين محدودة. إذا كنت تحتاج تجربة قراءة لاحقاً تركز فقط على القراءة الخالية من التشتيت بدلاً من إدارة الروابط والتعاون، فقد يناسبك Wallabag أو تطبيق قارئ مخصص أكثر. وإذا لم تستطع الالتزام بتشغيل وتحديث تطبيق ذاتي الاستضافة يعتمد على PostgreSQL، فخدمة مستضافة مثل Raindrop.io تتنازل عن بعض التحكم وعمق الأرشفة مقابل صيانة معدومة.

هل تحتاج مساعدة احترافية؟

توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.

  • التثبيت وتجهيز السيرفر
  • الإعداد المتقدم وإعداد التوجيه
  • تصليب الأمان وتحسين جدار الحماية
  • إعداد شهادات SSL/TLS مع Let's Encrypt
  • ربط النطاق المخصص والوكيل العكسي
  • جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
  • المراقبة الفورية وتنبيهات الجاهزية
  • الترحيل من المنصات القائمة
  • استكشاف مشكلات الاتصال والأداء وإصلاحها
  • سكريبتات أتمتة مخصصة وعقود دعم مستمر
تواصل مع PrismaTechWork

الأسئلة الشائعة

هل Linkwarden مجاني ومفتوح المصدر فعلاً؟

نعم. Linkwarden مرخّص بموجب AGPLv3، واستضافته ذاتياً تمنحك كل ميزة متوفرة في الباقة السحابية المدفوعة بدون أي تكلفة — لا توجد ميزات مقفلة خلف جدار دفع عند تشغيله بنفسك.

ماذا يؤرشف Linkwarden بالضبط عند حفظ رابط؟

افتراضياً يلتقط لقطة شاشة وملف PDF ونسخة HTML بملف واحد (monolith) ونسخة نص قابل للقراءة من الصفحة. هذا يعني أن المحتوى يبقى متاحاً في تثبيتك حتى لو تم تعديل الصفحة الأصلية أو حجبها خلف اشتراك أو إزالتها.

هل يحتاج Linkwarden قاعدة بيانات منفصلة؟

نعم، يتطلب PostgreSQL التي يُعدّها المثبّت تلقائياً كحاوية مصاحبة على المنفذ 5432 داخلياً. يجب ألا يُكشف هذا المنفذ للإنترنت أبداً — فقط واجهة ويب Linkwarden على المنفذ 3000 تحتاج أن تكون متاحة، ويُفضّل خلف وكيل عكسي.

هل يمكن لعدة أشخاص التعاون على نفس المجموعة؟

نعم. يمكن مشاركة المجموعات مع مستخدمين آخرين، ويمكنك تحديد صلاحيات دقيقة لكل عضو — مثل من يستطيع إضافة الروابط أو تعديلها أو حذفها — ما يجعلها مناسبة لأبحاث الفريق أو مكتبات الموارد المُنسّقة.

هل يدعم Linkwarden إضافات المتصفح وتطبيقات الجوال؟

نعم. تتوفر إضافات متصفح رسمية لـ Chrome وBrave وEdge وFirefox للحفظ بنقرة واحدة، وتوجد تطبيقات جوال أصلية لكل من iOS وAndroid لحفظ روابطك وتصفح أرشيفك أثناء التنقل.