🛠️ تثبيت Linkding — مدير إشارات مرجعية بسيط وذاتي الاستضافة

انشر Linkding على Ubuntu بـ Docker — مدير إشارات مرجعية سريع وبسيط مع الوسوم، بحث نصي كامل، وإضافات متصفح، على المنفذ 9095.

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

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

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

سكريبت تثبيت آلي — أمر واحد ينشر Linkding على المنفذ 9095 مع حساب مسؤول وكلمة مرور مولّدة تلقائياً.
عرض على GitHub

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

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

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

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

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/tools/linkding/linkding-ubuntu.sh

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

chmod +x linkding-ubuntu.sh

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

يثبّت السكريبت Docker إن لزم الأمر، وينشئ مستخدماً مسؤولاً بمتغير LD_SUPERUSER_NAME مضبوط على admin وكلمة مرور مولّدة من 20 حرفاً، ثم يشغّل Linkding على المنفذ 9095 مع تخزين البيانات في ./data.

sudo bash linkding-ubuntu.sh

4 تسجيل الدخول

افتح Linkding وسجّل الدخول كـ admin باستخدام كلمة المرور المولّدة التي يطبعها المثبّت:

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

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

المنفذالغرض
9095Web UI (host → container 9090) — admin + generated password
./dataSQLite database and archived snapshots

نظرة عامة

Linkding هو مدير إشارات مرجعية ذاتي الاستضافة مبني بإطار Django ومدعوم بقاعدة بيانات SQLite، مصمم للسرعة والبساطة بدلاً من قائمة طويلة من الميزات. يتيح لك حفظ الروابط مع وسوم ووصف وملاحظات، ثم إيجادها فوراً عبر بحث نصي كامل يشمل العناوين والأوصاف والوسوم. ميزة الأرشفة التلقائية الاختيارية تلتقط لقطة مُصيّرة بالمتصفح لكل صفحة عند الحفظ، بحيث تبقى الإشارة المرجعية صالحة حتى لو تغيرت الصفحة الأصلية أو اختفت. يعمل التطبيق بالكامل كحاوية Docker خفيفة واحدة دون الحاجة لقاعدة بيانات خارجية لإدارتها.

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

صُمم Linkding لمن يحفظون كماً كبيراً من الروابط وسئموا أدوات الإشارات المرجعية المتضخمة التي تحاول أن تكون تطبيق قراءة لاحقة وتطبيق تدوين ملاحظات وشبكة اجتماعية في آن واحد. يبدأ التشغيل خلال ثوانٍ، ويستهلك موارد شبه معدومة بفضل SQLite، ولا يقف في طريقك — بلا إعلانات، بلا تتبع، بلا حساب لدى طرف ثالث، وبلا حد مصطنع لعدد الإشارات المرجعية أو الوسوم. ولأنه يوفر REST API نظيفاً وإضافات متصفح رسمية لفَيَرفوكس وكروم، يصبح حفظ صفحة من أي مكان تتصفح منه بنقرة واحدة، وتصبح الإشارة المرجعية قابلة للبحث فوراً بالوسم أو النص الكامل من أي جهاز يستطيع الوصول لسيرفرك.

متى تحتاجه

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

من يحتاجه

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

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

  • حفظ ووسم روابط التوثيق التقني والدروس والمراجع أثناء العمل
  • بناء قاعدة معرفة شخصية من مقالات منتقاة منظمة بوسوم حسب الموضوع
  • أرشفة الصفحات قبل أن تتغير أو تختفي باستخدام ميزة اللقطة التلقائية
  • مشاركة قائمة قراءة لاحقة أو قائمة روابط منتقاة مع زملاء الفريق باستخدام حساب مستخدم ثانٍ
  • أتمتة إنشاء الإشارات المرجعية من خلاصات RSS أو سكريبتات عبر REST API
  • استبدال أشرطة الإشارات المرجعية المتناثرة عبر أجهزة ومتصفحات متعددة بمصدر واحد قابل للبحث

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

  • تنظيم قائم على الوسوم مع إكمال تلقائي ووسم جماعي لعدة إشارات مرجعية دفعة واحدة
  • بحث نصي كامل يشمل العناوين والأوصاف والوسوم، ومحتوى الصفحة المؤرشفة عند تفعيله
  • أرشفة تلقائية باللقطات تحفظ نسخة دائمة قابلة للتصفح من كل صفحة باستخدام متصفح بلا واجهة
  • إضافات متصفح رسمية لفَيَرفوكس وكروم للحفظ بنقرة واحدة والبحث السريع من شريط الأدوات
  • REST API بمصادقة عبر رمز مميز للبرمجة النصية والأتمتة والتكامل مع أطراف أخرى
  • ملاحظات بصيغة Markdown مرفقة بكل إشارة مرجعية لإضافة سياق لا يستطيع العنوان والرابط وحدهما نقله
  • استيراد وتصدير جماعي بصيغة Netscape HTML القياسية للإشارات المرجعية المتوافقة مع كل المتصفحات
  • دعم متعدد المستخدمين مع تحكم في رؤية الإشارات المرجعية لكل مستخدم، مفيد للأسر أو الفرق الصغيرة

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

  • سجّل الدخول بحساب المسؤول وكلمة المرور المولّدة التي يطبعها المثبّت، ثم غيّر كلمة المرور فوراً
  • ثبّت إضافة Linkding الرسمية للمتصفح على كروم أو فَيَرفوكس ووجّهها إلى رابط سيرفرك
  • أنشئ رمز API من Settings → Integrations واستخدمه في الإضافة بدلاً من كلمة مرور حسابك
  • استورد إشاراتك المرجعية الحالية بتصديرها من متصفحك كملف HTML ورفعه من Settings → Import
  • ابدأ بوسم الإشارات المرجعية أثناء حفظها — يكمل Linkding الوسوم الموجودة تلقائياً للحفاظ على تسمية متسقة
  • فعّل اللقطات التلقائية من Settings إذا أردت نسخة مؤرشفة دائمة من كل صفحة تحفظها
  • أنشئ حسابات مستخدمين إضافية من لوحة إدارة Django إذا أردت مشاركة النسخة مع العائلة أو الزملاء
  • اجعل Linkding محرك البحث الافتراضي في متصفحك أو أضف صفحة البحث نفسها للإشارات المرجعية لعمليات بحث سريعة

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

  • غيّر كلمة مرور المسؤول المولّدة فور تسجيل الدخول الأول واحفظها في مدير كلمات مرور
  • ضع Linkding خلف وكيل عكسي مع HTTPS — يجب ألا ينتقل رمز API وملف تعريف ارتباط الجلسة عبر HTTP عادي أبداً
  • استخدم رموز API بدلاً من كلمة مرور حسابك في إضافة المتصفح، وألغِ الرمز إذا فُقد جهاز ما
  • قيّد الوصول إلى السيرفر بـ VPN أو قائمة عناوين IP مسموحة إذا لم تكن بحاجة لوصول عام لإشاراتك المرجعية
  • حافظ على تحديث صورة Docker — اسحب الإصدارات الجديدة بانتظام للحصول على إصلاحات الأمان والاعتماديات
  • عطّل الوصول العام/الضيف في الإعدادات ما لم ترغب عمداً في مشاركة الإشارات المرجعية مع زوار مجهولين
  • اقصر حسابات المستخدمين الإضافية على أشخاص تثق بهم — يستطيع كل مستخدم رؤية الإشارات المرجعية المعلّمة كمشتركة

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

يستمع Linkding داخلياً على المنفذ 9090 في الحاوية؛ يربطه هذا التثبيت بمنفذ المضيف 9095، لذا تصفّح http://your-server-ip:9095 واضبط إضافة المتصفح على نفس المنفذ. لا يوجد منفذ قاعدة بيانات منفصل لفتحه لأن Linkding يستخدم SQLite مخزنة داخل حجم ./data. لا تكشف المنفذ 9095 مباشرة للإنترنت بدون وكيل عكسي — ضع Nginx Proxy Manager أو Caddy أمامه بشهادة TLS صالحة، وقيّد الوصول المباشر للمنفذ على مستوى الجدار الناري بحيث يصل إليه فقط الوكيل العكسي (أو VPN).

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

  • انسخ احتياطياً دليل ./data بالكامل — يحتوي على قاعدة بيانات SQLite بكل الإشارات المرجعية والوسوم والمستخدمين والإعدادات
  • إذا كانت اللقطات التلقائية مفعّلة، فإن نفس حجم ./data يحتوي أيضاً على اللقطات المؤرشفة بصيغة HTML، لذا انسخه بالكامل احتياطياً وليس فقط ملف قاعدة البيانات
  • صدّر إشاراتك المرجعية دورياً كملف Netscape HTML قياسي من Settings → Export للحصول على نسخة احتياطية محمولة قابلة للقراءة من أي متصفح
  • أوقف الحاوية قبل نسخ ملف SQLite مباشرة لتجنب أخذ نسخة احتياطية من قاعدة بيانات أثناء الكتابة فيها
  • خزّن النسخ الاحتياطية خارج المضيف — نسخة على نفس القرص لا تحميك من عطل القرص
  • اختبر الاستعادة بتوجيه حاوية جديدة إلى نسخة من دليل ./data والتأكد من تحميل الإشارات المرجعية والوسوم بشكل صحيح

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

  • نسيان تغيير كلمة مرور المسؤول المولّدة بعد تسجيل الدخول الأول
  • كشف المنفذ 9095 للإنترنت بدون وكيل عكسي أو TLS
  • الخلط بين المنفذ الافتراضي الموثّق 9090 ومنفذ المضيف 9095 المستخدم في هذا التثبيت عند ضبط إضافة المتصفح
  • عدم أخذ نسخة احتياطية من حجم ./data إطلاقاً، بافتراض أن الإشارات المرجعية مخزنة 'في السحابة' في مكان ما
  • استخدام كلمة مرور الحساب بدلاً من رمز API في إضافة المتصفح، ما يصعّب إلغاء الوصول لاحقاً
  • عدم تفعيل أرشفة اللقطات ثم فقدان الوصول لصفحة محفوظة بعد أن تختفي الصفحة الأصلية من الإنترنت
  • ترك الوسوم تتشعب دون اتساق (مثل 'docker' و'Docker' كوسمين منفصلين) بدلاً من الاعتماد على الإكمال التلقائي

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

  • تعذّر الوصول لواجهة الويب — تأكد أن الحاوية تعمل باستخدام docker ps وأن المنفذ 9095 مربوط وغير محظور بالجدار الناري
  • فشل تسجيل الدخول بكلمة المرور المطبوعة — انسخها بالضبط من مخرجات المثبّت مع الحذر من المسافات الزائدة أو فواصل الأسطر
  • إضافة المتصفح لا تتصل — تحقق أن رابط السيرفر يتضمن المنفذ الصحيح (9095) ويطابق http أو https بالضبط
  • البحث النصي الكامل لا يُرجع نتائج للمحتوى المؤرشف — تأكد من تفعيل اللقطات ومن انتهاء معالجة اللقطة (تعمل بشكل غير متزامن)
  • الاستيراد من ملف HTML للمتصفح يفشل أو يتخطى إشارات مرجعية — تحقق أن الملف تصدير Netscape صالح وغير تالف
  • لا يتم إنشاء اللقطات — راجع سجلات الحاوية بحثاً عن أخطاء المتصفح بلا واجهة؛ يحتاج عامل اللقطات ذاكرة إضافية على خوادم VPS الصغيرة جداً
  • طلبات API تُرجع 401 Unauthorized — أعد إنشاء الرمز من Settings → Integrations وتأكد من إرساله بشكل صحيح في ترويسة Authorization

البدائل

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

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

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

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

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

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

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

ما هي بيانات تسجيل الدخول؟

ينشئ المثبّت حساب مسؤول باسم مستخدم admin وكلمة مرور مولّدة من 20 حرفاً يطبعها في نهاية الإعداد. سجّل الدخول بهذه البيانات وغيّر كلمة المرور من إعدادات حسابك فوراً بعد ذلك. احفظ البيانات في مكان آمن قبل إغلاق الطرفية.

ما المنفذ الذي يستخدمه Linkding؟

منفذ المضيف 9095، المربوط من المنفذ الداخلي للحاوية 9090. يجدر ملاحظة ذلك لأن الافتراضي الموثّق لـ Linkding هو 9090، بينما يحوّل هذا التثبيت المنفذ الظاهر للمضيف إلى 9095 — لذا تصفّح 9095 ووجّه إضافة المتصفح لنفس المنفذ.

كيف أستخدم إضافة المتصفح؟

ثبّت إضافة Linkding الرسمية لفَيَرفوكس أو كروم، ثم أدخل في إعداداتها رابط سيرفرك ورمز API مُنشأ من Settings → Integrations في Linkding. استخدم الرمز بدلاً من كلمة مرور حسابك لأنه أكثر أماناً ويمكن إلغاؤه بشكل مستقل. بعد ذلك، يصبح حفظ صفحة بنقرة واحدة من شريط الأدوات.

كيف يقارن Linkding بـ Linkwarden؟

Linkding هو الخيار البسيط — سريع، مدعوم بـ SQLite، ويركز بحتاً على الإشارات المرجعية مع ميزة لقطة اختيارية. Linkwarden أثقل، مدعوم بـ PostgreSQL، ويؤرشف نسخة دائمة كاملة من كل صفحة إلى جانب المجموعات والتعاون متعدد المستخدمين.

ما الذي أحتاج نسخه احتياطياً؟

حجم ./data، الذي يحتوي على قاعدة بيانات SQLite وأي لقطات صفحات مؤرشفة — بما أنها SQLite، فهذه نسخة احتياطية كاملة بحد ذاتها. يستحق الأمر أيضاً تصدير إشاراتك المرجعية دورياً كملف HTML قياسي، ما يمنحك نسخة محمولة يمكنك استيرادها في أي مكان.