كيفية إنشاء مدير الإشارات المرجعية الخاص بك مع Linkding

Linkding هو مدير إشارات مرجعية بسيط ومرن على شبكة الإنترنت لنظام التشغيل Linux. على غرار مديري الإشارات المرجعية في وضع عدم الاتصال، يسمح لك بإنشاء روابط الويب التي تراكمت لديك مع مرور الوقت والتعليق عليها.

ستوضح لك هذه المقالة كيف يمكنك تثبيت Linkding على جهاز Ubuntu 22.04 باستخدام Docker وDocker Compose. كما سيسلط الضوء أيضًا على كيفية إنشاء مستخدم غير إداري وإدارته داخل مثيل Linkding الجديد الخاص بك.

لماذا تستضيف مدير الإشارات المرجعية الخاص بك باستخدام Linkding؟

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

يعمل Linkding أيضًا على توسيع الميزات الأساسية الموجودة في معظم مديري الإشارات المرجعية لتشمل مشاركة الارتباط ووضع المستخدمين المتعددين. وهذا يجعله مثاليًا للمستخدمين الذين يرغبون في إنشاء منصة تعاونية خاصة لمشاركة الروابط بين المجموعة.

الحصول على Linkding وDocker Compose

لنشر Linkding، تحتاج أولاً إلى تثبيت Docker مع مكون Docker Compose الخاص به. يمكنك القيام بذلك عن طريق جلب مفتاح توقيع البرنامج من موقع المطور:

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg

قم بإنشاء ملف مستودع جديد لتثبيت Docker الخاص بك:

sudo nano /etc/apt/sources.list.d/docker.list

الصق السطر التالي من التعليمات البرمجية داخل ملف المستودع الجديد الخاص بك:

deb (arch=amd64 signed-by=/etc/apt/keyrings/docker.gpg) https://download.docker.com/linux/ubuntu jammy stable

قم بإعادة تحميل مستودعات حزم نظامك عن طريق تشغيل الأمر التالي:

sudo apt update && sudo apt upgrade
sudo apt install docker-ce docker-ce-cli containerd.io docker-compose-plugin docker-buildx-plugin nginx

الحصول على حاوية Linkding Docker ونشرها

قم بإنشاء مجلد جديد لـ Linkding داخل الدليل الرئيسي الخاص بك وانتقل إلى داخله:

mkdir ~/linkding && cd ~/linkding

استخدم محرر النصوص المفضل لديك لإنشاء ملف “docker-compose.yml” فارغ:

nano ./docker-compose.yml

قم بلصق كتلة التعليمات البرمجية التالية داخل ملف الإنشاء الجديد الخاص بك:

---
version: "3"
services:
  linkding:
    container_name: ${LD_CONTAINER_NAME:-linkding}
    image: sissbruecker/linkding:latest
    ports:
      - ${LD_HOST_PORT:-9090}:9090
    volumes:
      - ${LD_HOST_DATA_DIR:-./data}:/etc/linkding/data
    env_file:
      - .env
    restart: unless-stopped

احفظ ملف docker-compose.yml الجديد، ثم أنشئ ملف بيئة لمثيلك. سيحتوي هذا على كافة المتغيرات المخصصة للتثبيت الجديد:

الصق كتلة التعليمات البرمجية التالية داخل ملف البيئة الجديد الخاص بك:

LD_CONTAINER_NAME="linkding"
LD_HOST_PORT="9090"
LD_HOST_DATA_DIR="./data"
LD_SUPERUSER_NAME="linkding" # CHANGE WITH A SECURE USERNAME
LD_SUPERUSER_PASSWORD="linkding" # CHANGE WITH A SECURE PASSWORD
LD_DISABLE_BACKGROUND_TASKS="False"
LD_DISABLE_URL_VALIDATION="False"
LD_ENABLE_AUTH_PROXY="False"
LD_CSRF_TRUSTED_ORIGINS="https://linkding.your-domain-name.here"

وأخيرًا، أنشئ حاوية Docker الجديدة الخاصة بك عن طريق تشغيل الأمر التالي:

إنشاء وكيل Nginx Reverse Proxy لـ SSL

في هذه المرحلة، لديك الآن نسخة عاملة من Linkding تعمل على المنفذ 9090. ومع ذلك، لتتمكن من الوصول إليها بشكل عام، تحتاج إلى إنشاء وكيل عكسي يعمل على تأمين الاتصالات الواردة باستخدام SSL.

قم بإنشاء ملف تكوين موقع جديد لمثيلك:

sudo nano /etc/nginx/sites-available/linkding

قم بلصق كتلة التعليمات البرمجية التالية داخل ملف موقعك الجديد:

server {
    listen 80;
    listen (::):80;
 
    root                    /var/www/html;
    server_name             linkding.your-domain-name.here;
 
    location / {
        proxy_set_header    X-Forwarded-For $remote_addr;
        proxy_set_header    Host $http_host;
        proxy_set_header    X-Forwarded-Proto $scheme;
        proxy_pass          http://localhost:9090;
    }
}

قم بإزالة ملف تكوين الموقع الافتراضي وقم بإنشاء رابط رمزي لملف التكوين الجديد الخاص بك إلى “/etc/nginx/sites-enabled”:

sudo rm /etc/nginx/default
sudo ln -s /etc/nginx/sites-available/linkding /etc/nginx/sites-enabled/linkding

ابدأ تشغيل برنامج Nginx وقم بتمكينه لتطبيق إعداداته الجديدة:

sudo systemctl restart nginx
sudo systemctl enable --now nginx

تمكين SSL لمثيل الارتباط الخاص بك

تأكد من أن جهازك يحتوي على أحدث إصدار ثنائي أساسي:

قم بتثبيت حزمة Certbot الخاصة بـ Electronic Frontier Foundation (EFF):

sudo snap install certbot --classic

اختبر ما إذا كان تثبيت certbot الخاص بك يعمل بشكل صحيح عن طريق تسجيله في EFF:

sudo certbot register --agree-tos -m ramces@email.invalid

اطلب شهادة SSL لمثيلك عن طريق تشغيل الأمر التالي:

sudo certbot --nginx -d linkding.your-domain-name.here

اختبر ما إذا كان المثيل الجديد الخاص بك آمنًا ويعمل عن طريق تحميل عنوانه على متصفح الويب.

إنشاء مستخدم جديد في Linkding

قم بتسجيل الدخول إلى مثيل Linkding الجديد باستخدام بيانات اعتماد المستخدم المتميز التي قدمتها في ملف “.env” الخاص بك.

انقر على رابط “الإعدادات” في الزاوية اليمنى العليا من الصفحة.

انقر فوق علامة التبويب “المسؤول” في صفحة إعدادات Linkding. سيؤدي هذا إلى إظهار لوحة إدارة Linkding.

لإضافة مستخدم جديد، انقر فوق الرابط “إضافة” بجوار صف المستخدمين ضمن فئة “المصادقة والترخيص”.

قم بتوفير اسم مستخدم وكلمة مرور لمستخدم Linkding الجديد، ثم انقر فوق “حفظ” لتنشيط المستخدم الجديد.

اختبر ما إذا كان المستخدم الجديد يعمل بشكل صحيح عن طريق تسجيل الدخول إليه من خلال جلسة متصفح مختلفة.

تعطيل مستخدم موجود في Linkding

لتعطيل مستخدم حالي في Linkding، انتقل إلى لوحة المسؤول الخاصة بمثيلك، ثم حدد رابط “المستخدمون” ضمن فئة “المصادقة والتفويض”.

انقر فوق اسم المستخدم الذي تريد تعطيله. سيؤدي هذا إلى تحميل الملف الشخصي لهذا المستخدم المعين.

قم بالتمرير لأسفل إلى فئة “الأذونات”، ثم قم بإلغاء تحديد مربع الاختيار الموجود بجوار التصنيف “نشط”.

قم بالتمرير لأسفل إلى أسفل الصفحة ثم انقر فوق “حفظ” لتعطيل المستخدم بشكل كامل.

أسئلة مكررة

حقوق الصورة: Lauren Mancke عبر Unsplash (الخلفية) Linkding Github (الشعار). جميع التعديلات ولقطات الشاشة بواسطة Ramces Red.

رمسيس كاتب في مجال التكنولوجيا عاش مع أجهزة الكمبيوتر طوال حياته. قارئ غزير الإنتاج وطالب في الأنثروبولوجيا، وهو شخصية غريبة الأطوار تكتب مقالات عن Linux وأي شيء لا شيء.