🌐 تثبيت Bluesky PDS — استضف خادم بياناتك الشخصي على شبكة atproto

انشر خادم بيانات شخصي (PDS) لـ Bluesky على Ubuntu باستخدام Docker — امتلك هويتك وبياناتك على Bluesky على نطاقك الخاص، مع اتحاد كامل مع شبكة atproto. يتطلب نطاقاً عاماً وHTTPS.

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

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

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

⚠️ يتطلب نطاقاً عاماً مع HTTPS للاتحاد مع الشبكة. يُنشر هذا PDS على المنفذ 3045، لكن الاستخدام الفعلي يحتاج وكيلاً عكسياً بشهادة TLS صالحة على نطاقك. أنشئ الحسابات باستخدام pdsadmin.
عرض على GitHub

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

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/social/bluesky-pds/bluesky-pds-ubuntu.sh
chmod +x bluesky-pds-ubuntu.sh
sudo bash bluesky-pds-ubuntu.sh

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

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

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/social/bluesky-pds/bluesky-pds-ubuntu.sh

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

chmod +x bluesky-pds-ubuntu.sh

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

يثبّت السكريبت Docker إن لزم ويُشغّل Bluesky PDS على المنفذ 3045، مولّداً سر JWT وكلمة مرور المشرف ومفتاح دوران PLC. يجب ضبط PDS_HOSTNAME على نطاق عام تملكه — الاتحاد مع الشبكة يتطلب أن يكون هذا النطاق متاحاً عبر HTTPS.

sudo bash bluesky-pds-ubuntu.sh

4 توجيه نطاقك وإنشاء حساب

أعدّ وكيلاً عكسياً بشهادة TLS صالحة لـ PDS_HOSTNAME، ثم أنشئ حسابك الأول باستخدام أداة pdsadmin (أو الـ API):

pdsadmin account create  # after setting up your domain + HTTPS

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

المنفذالغرض
3045PDS (host → container 3000)
⚠️ public domain + HTTPSRequired to federate — reverse proxy with a valid TLS cert
PDS_HOSTNAMEYour public domain; accounts created with pdsadmin
PLC rotation keyGenerated — critical to control of your identity; back it up

نظرة عامة

خادم البيانات الشخصي (PDS) من Bluesky هو التطبيق المرجعي لخادم بيانات atproto — القطعة التي تخزّن فعلياً مستودع الحساب: منشوراته، إعجاباته، متابعاته، ملفه الشخصي، وملفاته الوسائطية (الصور). يفصل atproto عمداً الهوية وتخزين البيانات عن التطبيقات التي تعرضها، لذا فإن تشغيل PDS خاص بك يعني أن حسابك يعيش على بنية تحتية تتحكم بها بدلاً من خوادم Bluesky المشتركة، بينما يظل متحداً بالكامل مع نفس الشبكة التي يقرأ منها bsky.app وكل عميل atproto آخر.

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

تشغيل PDS خاص بك يمنحك ملكية حقيقية وقابلة للتحقق لهويتك وبياناتك في atproto بدلاً من الاعتماد على بنية Bluesky المستضافة. معرّفك اللامركزي (DID) مرتبط بنطاقك الخاص، ومستودعك يعيش على قرصك الخاص، وأنت من يقرر سياسة الاحتفاظ بالبيانات والنسخ الاحتياطي والإشراف على حسابك. إذا أغلقت شركة Bluesky يوماً أو غيّرت شروطها، فلن تتأثر الحسابات المستضافة ذاتياً — يستمر البروتوكول بالعمل طالما هناك أي PDS يخدم البيانات، وهذا بالضبط ما صُمم من أجله نموذج قابلية نقل الحسابات في atproto.

متى تحتاجه

  • تريد أن تعيش هويتك ومنشوراتك على Bluesky على بنية تحتية تتحكم بها بدلاً من PDS المشترك لـ Bluesky
  • لديك الخبرة التقنية لإدارة خدمة عامة تحتاج نطاقاً وHTTPS وDNS وتحديثات Docker مستمرة
  • تريد أقوى ضمان لقابلية نقل الحساب التي يوفرها atproto — الانتقال بين مزودي PDS لاحقاً دون فقدان هويتك
  • تبني أو تجرّب تطبيقات atproto/AT Protocol وتحتاج PDS حقيقياً للتطوير عليه
  • تريد استضافة عدة حسابات (عائلية، مشروع، مجتمع) تحت نطاق تديره أنت
  • تهتم بسيادة بياناتك وتريد تحكماً مباشراً في النسخ الاحتياطي والاحتفاظ واستعادة الحساب

من يحتاجه

  • عشاق الاستضافة الذاتية الذين يُشغّلون بالفعل بريدهم أو DNS أو خادم Mastodon الخاص بهم ويريدون نفس الاستقلالية لـ Bluesky
  • المطورون الذين يبنون تطبيقات أو بوتات أو مولّدات تغذية atproto ويحتاجون بيئة PDS حقيقية للاختبار عليها
  • المستخدمون المهتمون بالخصوصية الذين يريدون تخزين شبكتهم الاجتماعية ومنشوراتهم على بنية تحتية يملكونها ويراجعونها
  • المجتمعات أو المنظمات الصغيرة التي تريد تشغيل حسابات PDS لأعضائها تحت نطاق مشترك
  • دعاة اللامركزية الذين يريدون إظهار ودعم النموذج الاتحادي غير الوصائي الذي بُني عليه atproto
  • المستخدمون التقنيون المرتاحون مع الوكلاء العكسيين وشهادات TLS وDocker ولا يحتاجون إعداداً بواجهة رسومية

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

  • استضافة حسابك الشخصي على Bluesky تحت نطاقك الخاص بدلاً من استضافة bsky.social الافتراضية
  • تشغيل حسابات PDS لمجتمع صغير أو منظمة تحت نطاق مشترك واحد
  • تطوير واختبار تطبيقات وبوتات atproto ومولّدات تغذية مخصصة على PDS حقيقي
  • الحفاظ على تحكم كامل بتاريخ منشوراتك وحسابك بحيث لا يتأثر بإشراف طرف ثالث أو تغييرات الخدمة
  • ترحيل حساب Bluesky موجود إلى بنية تحتية ذاتية الاستضافة مع الاحتفاظ بنفس المتابعين والهوية
  • تجربة الشبكة الاجتماعية اللامركزية وفهم بنية atproto عملياً

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

  • تطبيق كامل لخادم بيانات AT Protocol — تخزين المستودع، تخزين الملفات الوسائطية، وواجهة XRPC التي تتحدث بها عملاء Bluesky
  • هوية قائمة على DID مرتبطة بنطاقك الخاص عبر طريقة did:web أو did:plc، مما يمنحك ملكية قابلة للنقل وقابلة للتحقق
  • إدارة الحسابات عبر أداة سطر الأوامر pdsadmin — إنشاء حسابات، توليد رموز دعوة، إعادة تعيين كلمات المرور، وطلب تصدير الحسابات
  • اتحاد تلقائي مع نفس الشبكة التي يستخدمها bsky.app — المنشورات والمتابعات تعمل تماماً كحساب Bluesky عادي
  • توليد مفتاح دوران PLC للتحكم، وعند الحاجة، استعادة السيطرة على سجل هوية DID الخاص بك
  • دعم تصدير واستيراد المستودع لنقل الحسابات بين خوادم PDS دون فقدان التاريخ
  • يعمل كحاوية Docker واحدة مع كل الحالة في حجم دائم، مما يجعل النسخ الاحتياطي وإعادة النشر مباشرين
  • مفتوح المصدر ويصونه فريق Bluesky PBC بنشاط كتطبيق PDS المرجعي

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

  • وجّه سجل DNS من نوع A لنطاقك إلى سيرفرك قبل أي شيء آخر — الاتحاد لا يعمل دون أن يكون النطاق قابلاً للحل علناً
  • أعدّ وكيلاً عكسياً (Caddy أو Nginx Proxy Manager) أمام الحاوية لإنهاء HTTPS على PDS_HOSTNAME الخاص بك
  • احفظ كلمة مرور المشرف وسر JWT ومفتاح دوران PLC التي يطبعها المثبّت — خزّنها في مدير كلمات مرور فوراً
  • أنشئ حسابك الأول بأمر pdsadmin account create، مع توفير معرّف (handle) وبريد إلكتروني ورمز دعوة
  • سجّل الدخول إلى تطبيق Bluesky أو bsky.app باستخدام PDS_HOSTNAME المخصص كخادم تسجيل الدخول للتأكد من عمل الاتحاد
  • ولّد رموز دعوة باستخدام pdsadmin إذا كنت تخطط لضم مستخدمين آخرين إلى PDS الخاص بك
  • تحقق من أن حسابك يُحل بشكل صحيح بالتأكد من إمكانية الوصول لمستند DID الخاص به عبر HTTPS على نطاقك
  • اشترك في صفحة حالة Bluesky وملاحظات إصدار PDS لتعرف متى يجب تحديث الحاوية

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

  • لا تكشف منفذ حاوية PDS مباشرة للإنترنت أبداً — أنهِ TLS دائماً عند وكيل عكسي أمامها
  • انسخ مفتاح دوران PLC احتياطياً فوراً وخزّنه في مكان منفصل عن السيرفر — فقدانه قد يعني فقدان السيطرة على هويتك
  • استخدم كلمة مرور مشرف قوية وفريدة، وأعد توليد سر JWT إن شككت يوماً بتسريبه
  • حافظ على تحديث صورة PDS Docker — atproto بروتوكول يتطور بنشاط وتصدر إصلاحات أمان بانتظام
  • قيّد الوصول عبر SSH وإلى السيرفر بإحكام لأن PDS يحمل المفاتيح الخاصة التي تثبت السيطرة على هويتك
  • فعّل التجديد التلقائي لـ HTTPS في الوكيل العكسي حتى لا تنتهي الشهادات وتُكسر عملية الاتحاد
  • لا تعطّل متطلب رمز الدعوة إلا إذا أردت تحديداً فتح التسجيل الذاتي المفتوح على PDS الخاص بك
  • راقب سجلات السيرفر لأي محاولات إنشاء حسابات أو تسجيل دخول غير معتادة، خاصة إذا سمحت بالتسجيل العام

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

يستمع PDS على المنفذ 3045 على المضيف (معيّن من منفذ الحاوية 3000) للوصول المحلي، لكن يجب ألا يُكشف هذا المنفذ مباشرة للإنترنت العام أبداً. الاتحاد مع الشبكة يتطلب أن يكون PDS متاحاً عند PDS_HOSTNAME الخاص بك عبر HTTPS على المنفذ القياسي 443 — ضع وكيلاً عكسياً مثل Caddy أو Nginx Proxy Manager أمام الحاوية لإنهاء TLS بشهادة صالحة وموثوقة. افتح فقط المنفذين 80 و443 في جدار الحماية للوكيل العكسي، وأبقِ المنفذ 3045 مقيّداً بالوصول المحلي أو محظوراً تماماً من الخارج.

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

  • انسخ احتياطياً دليل بيانات PDS بالكامل، والذي يحتوي على قواعد بيانات SQLite للمستودع، وتخزين الملفات الوسائطية، وكل حالة الحساب
  • خزّن مفتاح دوران PLC وبيانات اعتماد المشرف في مدير كلمات مرور مشفّر منفصل عن السيرفر نفسه
  • صدّر مستودعات الحسابات الفردية دورياً باستخدام أدوات تصدير PDS حتى تبقى الحسابات قابلة للنقل حتى لو فُقد السيرفر
  • انسخ احتياطياً ملف docker-compose.yml وملف البيئة (.env) لتتمكن من إعادة إنشاء نفس PDS_HOSTNAME والمفاتيح على مضيف جديد
  • اختبر استعادة كاملة على جهاز منفصل دورياً للتأكد من أن نسخك الاحتياطية تعمل فعلاً قبل أن تحتاجها
  • احتفظ بنسخ احتياطية خارج السيرفر — النسخ المحلية فقط على نفس القرص لا تحميك من عطل الأجهزة أو اختراق السيرفر

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

  • النشر دون نطاق عام وHTTPS جاهزين — لن يتحد PDS مع الشبكة وستظهر الحسابات معطلة لمستخدمي atproto الآخرين
  • فقدان مفتاح دوران PLC أو عدم نسخه احتياطياً أبداً، وهو مطلوب لإثبات واستعادة السيطرة على هويتك
  • كشف المنفذ 3045 مباشرة للإنترنت بدلاً من وضع وكيل عكسي بـ TLS أمامه
  • نسيان ضبط PDS_HOSTNAME ليطابق النطاق الفعلي الموجّه للسيرفر، مما يكسر حل الهوية
  • عدم إنشاء سجل DNS لـ PDS_HOSTNAME قبل تشغيل الحاوية، مما يسبب فشل إصدار الشهادة
  • افتراض أن التسجيل الذاتي مفتوح افتراضياً — يجب إنشاء الحسابات صراحة بـ pdsadmin ما لم تضبط غير ذلك
  • تشغيل PDS على VPS بذاكرة منخفضة دون مراقبة — فهرسة المستودع وحركة الاتحاد تحتاج موارد معقولة
  • تجاهل التحديثات المنتظمة، مما قد يفوّت تغييرات بروتوكول تؤثر على توافق الاتحاد مع الشبكة الأوسع

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

  • الحساب غير مرئي على bsky.app — تحقق من أن PDS_HOSTNAME يُحل علناً عبر HTTPS وأن الوكيل العكسي يوجّه بشكل صحيح إلى المنفذ 3045
  • أخطاء الشهادة — تأكد من اكتمال انتشار DNS قبل طلب شهادة، وراجع سجلات الوكيل العكسي لفشل تحدي ACME
  • فشل أوامر pdsadmin — تأكد من تشغيلها داخل الحاوية باستخدام docker exec وأن كلمة مرور المشرف مضبوطة بشكل صحيح
  • يبدو أن الاتحاد معطل — تحقق من أن سجل هوية PLC يُحل ويطابق PDS_HOSTNAME الحالي ومفاتيح التوقيع
  • فشل تشغيل الحاوية — راجع سجلات docker logs بحثاً عن متغيرات بيئة مفقودة، خاصة PDS_HOSTNAME وسر JWT وكلمة مرور المشرف
  • أداء بطيء — تحقق من أن السيرفر لديه معالج وذاكرة كافيين، لأن معالجة المستودع والتعامل مع ملفات الصور قد يكون مكلفاً
  • تعذّر إنشاء الحسابات — تأكد من استخدام رمز دعوة صالح وأن إنشاء الحسابات غير معطّل في إعداداتك
  • فقدان الوصول للهوية — إذا كنت لا تزال تملك مفتاح دوران PLC، استخدمه لاستعادة السيطرة؛ بدونه، قد تكون الاستعادة مستحيلة

البدائل

الحسابات المستضافة على Bluesky (PDS الافتراضي bsky.social) هي الخيار الأبسط — إعداد صفري، لكن هويتك وبياناتك تعيش على بنية Bluesky المشتركة. توجد تطبيقات PDS مستقلة أخرى للمطورين الذين يريدون بناء خادم بيانات مخصص، لكن صورة Docker الرسمية bluesky-social/pds تبقى الخيار الأنضج والأكثر انتشاراً للاستضافة الذاتية. خارج atproto تماماً، يقدّم Mastodon وشبكة ActivityPub الأوسع نموذجاً لامركزياً مختلفاً بمجتمع استضافة ذاتية أكبر، لكنهما غير متوافقين مع شبكة Bluesky. للبقاء داخل منظومة Bluesky/atproto مع امتلاك بنيتك التحتية، يبقى PDS الرسمي الخيار الواقعي الوحيد.

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

لا تستضف PDS ذاتياً إذا لم تكن مستعداً لصيانة سيرفر عام يحتاج نطاقاً وHTTPS صالحاً وتحديثات Docker مستمرة — PDS معطل يعني عملياً أن حسابك غير متاح لكامل الشبكة. إذا كنت تريد فقط استخدام Bluesky دون العبء التشغيلي، فإن PDS المستضاف الافتراضي bsky.social هو الخيار الأفضل لمعظم الناس. الاستضافة الذاتية أيضاً ليست ضرورية إذا كان هدفك الوحيد هو تصدير البيانات أو قابلية النقل — أدوات ترحيل الحساب في atproto تتيح لك الانتقال بين مزودي PDS لاحقاً دون الحاجة لتشغيل بنية تحتية اليوم.

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

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

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

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

ما هو Bluesky PDS؟

PDS (خادم البيانات الشخصي) هو منزلك الخاص في شبكة atproto التي تشغّل Bluesky. بما أن atproto يفصل الهوية والبيانات عن تطبيق العرض، فإن تشغيل PDS خاص بك يعني أن حسابك ومنشوراتك وشبكتك الاجتماعية تعيش على سيرفرك ونطاقك بدلاً من بنية Bluesky، مع بقائها متحدة بالكامل مع bsky.app وكل عملاء atproto الآخرين.

هل أحتاج فعلاً نطاقاً عاماً وHTTPS؟

نعم — هذا غير قابل للتفاوض للاتحاد مع الشبكة. يستمع PDS على المنفذ 3045 محلياً، لكن للمشاركة في شبكة atproto يجب أن يكون متاحاً عند PDS_HOSTNAME الخاص بك عبر HTTPS بشهادة TLS صالحة وموثوقة.

كيف أنشئ الحسابات؟

تستخدم أداة pdsadmin (أو الـ API) مع كلمة مرور المشرف التي يولّدها المثبّت. لا يوجد تسجيل ذاتي مفتوح افتراضياً — بصفتك المشغّل، أنت من ينشئ الحسابات عبر pdsadmin.

ما هو مفتاح دوران PLC؟

هو مفتاح تشفيري مرتبط بالتحكم في هويتك على atproto في PLC (الدليل الذي يربط الهويات). إنه أحد أهم الأسرار التي يولّدها PDS الخاص بك، لأنه مرتبط بقدرتك على إدارة هويتك، وإذا لزم الأمر، استعادة السيطرة عليها.

كيف يختلف هذا عن استخدام Bluesky ببساطة؟

الحساب العادي المستضاف على Bluesky يعيش على بنية PDS الخاصة بـ Bluesky — بسيط، لكنك لا تملك خادم البيانات أو الهوية الأساسي. تشغيل PDS خاص بك يضع هويتك وبياناتك على سيرفرك ونطاقك، متحدة مع نفس الشبكة، مما يمنحك قابلية نقل واستقلالية حقيقيتين.