✍️ تثبيت WriteFreely — منصة التدوين اللامركزية البسيطة والاتصال بالـ Fediverse على Docker

نشر منصة WriteFreely على Ubuntu باستخدام Docker — منصة التدوين مفتوحة المصدر اللامركزية والأنيقة للكتابة بمحرر Markdown والمزامنة مع شبكات Fediverse وMastodon عبر ActivityPub على المنفذ 8080.

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

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

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

سكريبت تثبيت مؤتمت — أمر واحد ينشر WriteFreely على المنفذ 8080 مع قاعدة بيانات MySQL والاتصال بشبكة Fediverse جاهزاً.
عرض على GitHub

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

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

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

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

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/Social/writefreely/writefreely-ubuntu.sh

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

chmod +x writefreely-ubuntu.sh

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

يقوم السكريبت بتثبيت Docker وتجهيز مجلد قاعدة بيانات MySQL (`./mysql-data`) ومجلد المفاتيح والإعدادات (`./data`) وتشغيل المنصة على المنفذ 8080.

sudo bash writefreely-ubuntu.sh

4 إنشاء حساب المشرف ونشر أول مقال

افتح متصفحك على الرابط http://ip-سيرفرك:8080. سجل حسابك الأول، واضبط اسم مدونتك وعنوانك اللامركزي (مثل `@blog@yourdomain.com`)، وابدأ في كتابة ونشر مقالاتك بمحرر Markdown النقي.

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

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

المنفذالغرض
8080WriteFreely Web UI (HTTP)
3306MySQL database (internal)

نظرة عامة

تعد WriteFreely منصة تدوين لا مركزية وبسيطة وأنيقة تم بناؤها بلغة Go وقاعدة بيانات MySQL للتركيز الصافي على متعة الكتابة والقراءة بدون مشتتات. تعمل المنصة عبر المنفذ 8080 وتعتمد على بروتوكول ActivityPub المفتوح، مما يتيح لأي مستخدم على منصات Mastodon أو Threads أو Misskey متابعة مدونتك وقراءة مقالاتك الجديدة مباشرة من خلاصاتهم الاجتماعية. وتدعم إنشاء عدة مدونات للحساب الواحد، وتخصيص كود CSS، وتنسيق Markdown، والمعادلات الرياضية MathJax وخلاصات RSS.

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

تمتلئ منصات النشر التجارية (مثل Medium وSubstack) بالنوافذ المنبثقة، وحواجز الدفع، وطلبات التسجيل المزعجة، فضلاً عن تحكمها في جمهورك وقرائك. كما تتطلب أنظمة الـ CMS الثقيلة إعدادات لا تنتهي لمجرد كتابة مقال بسيط. تمنحك WriteFreely وسيلة نشر شخصية فائقة السرعة والأناقة: خالية تماماً من الإعلانات، وتعتمد على نصوص Markdown النقية، مع نشر فوري عبر شبكة الـ Fediverse وسيادة كاملة لبياناتك 100%.

متى تحتاجه

  • تريد مدونة شخصية خفيفة وبسيطة وخالية من التشتيت لكتابة المقالات والتأملات والشروحات التقنية
  • تريد ربط مدونتك بشبكة الـ Fediverse (Mastodon وThreads) ليتمكن القراء من متابعتك عبر ActivityPub
  • تبحث عن بديل مفتوح المصدر ومستضاف ذاتياً بنسبة 100% لمنصات Medium وSubstack وBear Blog بدون قيود
  • تريد محرك تدوين فائق السرعة مبرمج بلغة Go يفتح الصفحات في أقل من 50 ميلي ثانية بدون كود جافاسكريبت معقد
  • تريد استضافة عدة مدونات مستقلة لنفسك أو لأفراد عائلتك أو لمجتمع كُتّاب على سيرفر واحد

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

  • نشر مقال تقني مفصل بـ Markdown يستلمه متابعوك على منصة Mastodon في خلاصاتهم تلقائياً
  • استضافة يوميات رقمية شخصية وأرشيف للمقالات بخطوط عربية جميلة وتنسيق CSS مخصص
  • إطلاق مجتمع تدوين للشركات أو العائلة يتيح لكل مؤلف إنشاء مدونته المستقلة الخاصة
  • توفير خلاصات RSS وAtom نقية للقراء لمتابعة التدوينات في تطبيقات الأخبار بدون كوكيز
  • كتابة المعادلات الرياضية المعقدة بـ LaTeX والأكواد البرمجية مع تمييز الألوان

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

  • محرر نقي وخالٍ من المشتتات على المنفذ 8080: كتابة سريعة بـ Markdown مع حفظ تلقائي ومعاينة فورية
  • اتصال كامل بشبكة ActivityPub: تمكين مستخدمي Mastodon وThreads من متابعة مدونتك بسهولة
  • دعم المدونات المتعددة: إنشاء وإدارة عدة مدونات عامة أو سرية من حساب مستخدم واحد
  • أداء فائق واستجابة لحظية: مبرمج بلغة Go ويقدم صفحات HTML خفيفة بزمن تحميل يقل عن 50 ميلي ثانية
  • تخصيص كامل بـ CSS: إمكانية تعديل الخطوط والألوان ووضع القراءة الليلي حسب ذوقك
  • دعم المعادلات والأكواد: دعم مدمج لصيغ LaTeX عبر MathJax وتمييز الأكواد البرمجية (Syntax Highlighting)
  • خلاصات RSS وAtom تلقائية: توليد روابط خلاصات فورية لكل مدونة ولكل كاتب بالموقع
  • معمارية Docker Compose تجمع تطبيق WriteFreely مع قاعدة بيانات MySQL على المنفذ 8080

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

  • افتح المتصفح وانتقل إلى الرابط http://ip-سيرفرك:8080
  • سجل حساب المشرف الشخصي الأول باسم المستخدم وكلمة المرور الآمنة
  • توجه إلى إعدادات المدونة واضبط عنوانها ووصفها واسم حسابك على الـ Fediverse
  • اكتب وانشر أول مقال باستخدام تنسيقات Markdown والوسوم
  • اختبر متابعة مدونتك من تطبيق Mastodon بالبحث عن `@yourblog@yourdomain.com`
  • ضع WriteFreely خلف وكيل عكسي مشفر بـ HTTPS (مثل Nginx) مع شهادة SSL صالحة
  • أعد سكريبت نسخ احتياطي دوري لمجلد قاعدة البيانات ومجلد الإعدادات

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

  • تنبيه أمني حاسم: عيّن كلمة مرور معقدة لقاعدة البيانات وولّد مفاتيح تشفير قوية بملف `config.ini`
  • استخدم تشفير HTTPS دائماً؛ حيث يتطلب بروتوكول ActivityPub شهادة SSL صالحة لربط المدونة بـ Mastodon
  • عطّل ميزة التسجيل العام في ملف `config.ini` (`open_registration = false`) إذا كنت تريد قصر السيرفر على نفسك
  • أبقِ منفذ قاعدة البيانات الداخلي MySQL 3306 معزولاً عن الإنترنت العام
  • احمِ مجلدات البيانات والمفاتيح التشفيرية بصلاحيات نظام صارمة بالسيرفر (`chmod 700`)
  • حدّث صورة الحاوية دورياً للحصول على التحديثات الأمنية وإصلاحات الاستقرار

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

يقدم WriteFreely واجهة الويب وبروتوكول ActivityPub عبر منفذ TCP 8080. اسمح بالمنفذ 8080 للشبكة المحلية (`ufw allow 8080/tcp`). وفي الإنتاج، وجه حركة المرور عبر وكيل عكسي مشفر بـ SSL على المنفذ 443 ووجهه لمنفذ 8080، مع إبقاء المنفذ 8080 مغلقاً خارجياً وقاعدة البيانات معزولة.

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

  • انسخ مجلد `./mysql-data` احتياطياً، والذي يحتوي على كامل قاعدة بيانات MySQL بكافة المقالات والمدونات والمتابعين
  • انسخ مجلد `./data` الذي يحتوي على ملف `config.ini` والمفاتيح التشفيرية المشغلة للـ Fediverse
  • استخرج نسخة احتياطية يومية لقاعدة البيانات عبر mysqldump: `docker exec writefreely-db mysqldump -u root -p writefreely > writefreely_backup.sql`
  • احتفظ بنسخة من ملف `docker-compose.yml` وملف الإعدادات
  • أتمت النسخ الاحتياطي اليومي للمجلدات وارفعه إلى مساحة تخزين سحابية عبر restic أو rsync

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

  • التشغيل عبر HTTP غير المشفر مما يكسر الاتصال ببروتوكول ActivityPub وشبكة Mastodon بالكامل
  • تغيير اسم النطاق `host` في `config.ini` بعد بدء النشر بالـ Fediverse مما يكسر روابط المتابعين القدامى
  • عدم ربط مجلدي التخزين الدائم لقاعدة البيانات والمفاتيح، مما يسبب مسح كافة المقالات عند تحديث الحاوية
  • ترك خيار `open_registration = true` متاحاً على سيرفر عام مما يسمح للغرباء بنشر مدونات سبام بنطاقك
  • استخدام SQLite في المواقع متعددة المستخدمين ذات الزيارات العالية بدلاً من MySQL

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

  • رفض الاتصال بالواجهة — تأكد من عمل الحاوية بالأمر `docker compose ps` وافحص السجلات: `docker logs writefreely -f`
  • مستخدمو Mastodon لا يجدون المدونة — تأكد من تفعيل شهادة SSL/HTTPS ومطابقة النطاق بملف `config.ini`
  • خطأ الاتصال بقاعدة البيانات — تأكد من عمل حاوية `writefreely-db` وصحة بيانات المرور بملف `config.ini`
  • تنسيقات الخطوط لا تظهر — تأكد من احتواء رابط النطاق في `config.ini` على بادئة `https://`
  • ظهور خطأ 404 في استعلامات webfinger — تأكد من أن الوكيل العكسي يمرر مسار `/.well-known/webfinger` لـ WriteFreely

البدائل

منصة Ghost للنشرات البريدية والاشتراكات. منصة Bear Blog البسيطة. منصة Mataroa مفتوحة المصدر. نظام WordPress التقليدي. مولدات المواقع الثابتة كـ Hugo وJekyll.

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

تجنب استخدام WriteFreely إذا كنت تحتاج لبناء صفحات هبوط تجارية بالسحب والإفلات أو متجر إلكتروني معقد (حيث صُمم WordPress للمتاجر والإضافات المعقدة). وإذا كنت تفضل موقعاً ثابتاً يُترجم إلى ملفات HTML على GitHub Pages بدون الحاجة لتشغيل سيرفر أو قاعدة بيانات، فإن Hugo أو Astro أخف.

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

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

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

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

ما هي منصة WriteFreely وما الذي يميزها عن غيرها؟

تعد WriteFreely منصة تدوين مفتوحة المصدر وخفيفة مبرمجة بلغة Go. تركز على تجربة الكتابة البسيطة بنصوص Markdown بدون مشتتات، وتدعم بروتوكول ActivityPub للاتصال المباشر بشبكات الـ Fediverse مثل Mastodon وThreads.

كيف تعمل ميزة الاتصال بـ Mastodon عبر ActivityPub؟

تمتلك مدونتك في WriteFreely معرّفاً لامركزياً مثل `@yourblog@yourdomain.com`. وعندما يبحث مستخدمو Mastodon عن هذا المعرف ويتابعونه، تظهر مقالاتك الجديدة تلقائياً في خلاصاتهم الرئيسية على Mastodon.

هل يمكنني استضافة عدة مدونات تحت حساب واحد؟

نعم! يتيح WriteFreely للمستخدم إنشاء وإدارة عدة مدونات عامة أو خاصة بعناوين وأسماء Fediverse وتنسيقات مستقلة من نفس الحساب.

هل يدعم WriteFreely تخصيص التصميم والمعادلات الرياضية؟

نعم! يدعم WriteFreely إضافة أكواد CSS مخصصة لكل مدونة، وتمييز نصوص الأكواد البرمجية (Syntax Highlighting)، والمعادلات الرياضية المعقدة عبر MathJax.

كم تستهلك منصة WriteFreely من الذاكرة العشوائية (RAM)؟

تمت ترجمة WriteFreely بلغة Go وتتميز بخفة استثنائية، حيث تستهلك عادة ما بين 30 إلى 60 ميجابايت فقط من الرام داخل Docker.