بمساعدة بعض الذكاء الاصطناعي، إليك قائمة شاملة بالأوامر الفرعية لأمر discourse.
توفر واجهة سطر الأوامر discourse (المُنفذة عبر script/discourse باستخدام حزمة Thor) 13 أمرًا فرعيًا أساسيًا مصنفة في النسخات الاحتياطية والاستعادة، إدارة الموقع والأوضاع، أدوات قاعدة البيانات، وهجرة البيانات (الاستيراد/التصدير).
مرجع سريع للأوامر
| الفئة | الأمر الفرعي | الوظيفة الأساسية |
|---|---|---|
| النسخ الاحتياطي والاستعادة | backup |
ينشئ أرشيف نسخ احتياطي كامل أو لقاعدة البيانات فقط. |
restore |
يستعيد ملف النسخ الاحتياطي .tar.gz إلى المثيل. |
|
enable_restore |
يمنح الإذن بتنفيذ أوامر الاستعادة. | |
disable_restore |
يسحب الإذن بتنفيذ عمليات الاستعادة. | |
rollback |
يعكس حالة قاعدة البيانات بعد فشل عملية الاستعادة. | |
| أوضاع الموقع | enable_readonly |
يبدّل وضع القراءة فقط المؤقت عبر الموقع. |
disable_readonly |
يزيل وضع القراءة فقط لاستعادة الكتابة العادية في الموقع. | |
request_refresh |
يُطلق مطالبة بتحديث المتصفح لجميع العملاء المتصلين النشطين. | |
| عمليات قاعدة البيانات | remap |
يؤدي بحثًا واستبدالًا نصيًا عالميًا عبر جداول قاعدة البيانات. |
| هجرة البيانات | export_category |
يصدر فئة واحدة، ومواضيعها، والمستخدمين المرتبطين بها. |
import_category |
يستورد أرشيف فئة إلى المنتدى الحالي. | |
export_topics |
يصدر مواضيع محددة حسب المعرف وحسابات مؤلفيها/المرددين عليها. | |
import_topics |
يستورد أرشيف موضوع إلى المنتدى الحالي. |
وثائق مفصلة للأوامر الفرعية
1. أوامر النسخ الاحتياطي والاستعادة
discourse backup [FILENAME]
-
الوصف: ينشئ نسخة احتياطية كاملة لقاعدة بيانات المنتدى والملفات الثابتة (Assets).
-
العلامات:
-
--sql-only: (قيمة منطقية، الافتراضي:false) يصدر فقط قاعدة بيانات PostgreSQL، متجاوزًا الملفات المرفوعة محليًا. -
--s3-uploads: (قيمة منطقية، الافتراضي:false) يفرض تضمين الملفات الثابتة المخزنة في S3 في أرشيف النسخ الاحتياطي (يُتجاهل عند تعيين--sql-only). -
مثال:
discourse backup
discourse backup --sql-only
discourse restore [FILENAME]
- الوصف: يستعيد نسخة احتياطية للمنتدى من أرشيف محلي
.tar.gzموجود في/var/www/discourse/public/backups/default. - المتطلب المسبق: يتطلب تشغيل
discourse enable_restoreأولاً. - مثال:
discourse restore discourse-2026-07-22-120000-v2026xxxx.tar.gz
discourse enable_restore و discourse disable_restore
- الوصف: يبدّل العلم التطبيقي الذي يسمح أو يقيد مهام الاستعادة عبر واجهة سطر الأوامر أو الويب.
- تسلسل الاستخدام:
discourse enable_restore
discourse restore <filename>
discourse disable_restore
discourse rollback
- الوصف: يعكس مخطط قاعدة البيانات وحالتها إلى النقطة التي كانت عليها قبل فشل تنفيذ عملية الاستعادة.
2. حالة الموقع والتحكم في العملاء
discourse enable_readonly و discourse disable_readonly
- الوصف: يحدد أو يزيل
READONLY_MODE_KEYفي Redis. - التفاصيل:
- يجمد عمليات الكتابة في قاعدة البيانات مع إبقاء الموقع قابلًا للقراءة للمستخدمين.
- يستخدم حلقة «مدة الحياة» (TTL) القصيرة التي يتم تجديدها أثناء النشاط، مما يمنع بقاء الموقع مقفلاً بشكل دائم إذا تعطلت جلسة الطرفية.
discourse request_refresh
- الوصف: يرسل رسالة نظام عبر MessageBus تأمر جميع جلسات الويب المتصلة بإعادة تحميل صفحة الويب. مفيد بعد نشر تحديثات الملفات الثابتة أو التغييرات العالمية في السمات.
3. إعادة تعيين قاعدة البيانات
discourse remap [OPTIONS] FROM TO
-
الوصف: يؤدي بحثًا واستبدالًا مباشرًا للسلاسل النصية عبر الأعمدة النصية في قاعدة البيانات. أمر حاسم عند تحديث أسماء النطاقات، أو مسارات CDN، أو بادئات رفع الصور.
-
العلامات:
-
--global: (قيمة منطقية) يمسح ويعيد تعيين عبر جميع الجداول بدلاً من جداول المحتوى القياسية. -
--regex: (قيمة منطقية) يقيّم معاملFROMكتعبير نمطي بدلاً من سلسلة حرفية. -
مثال:
discourse remap "old-domain.com" "new-domain.com"
discourse remap --global "/uploads/default/" "/cdn-uploads/"
4. الاستيراد والتصدير الانتقائي للبيانات
discourse export_category [CATEGORY_ID]
- الوصف: يسلسل فئة واحدة، بما في ذلك جميع المواضيع المتداخلة، والمنشورات، وملفات تعريف المستخدمين المشاركين، في ملف أرشيف JSON.
discourse import_category [FILE_PATH]
- الوصف: يقرأ أرشيفًا أنشأه
export_categoryويدمج بيانات الفئة في المثيل المستهدف.
discourse export_topics [TOPIC_IDS...]
- الوصف: يأخذ معرفًا واحدًا أو أكثر للمواضيع مفصولًا بمسافات ويصدر المواضيع، والمنشورات، وحسابات المستخدمين ذات الصلة.
- مثال:
discourse export_topics 102 105 210
discourse import_topics [FILE_PATH]
- الوصف: يستورد أرشيف JSON أنشأه
export_topicsإلى مثيل Discourse الوجهة.