ميولنير هو بوت إدارة لمنصة ماتريكس، قادر على تطبيق سياسات الحظر المشتركة، وإخفاء الرسائل، ومراقبة الغرف المحمية، ومساعدة المشرفين على اتخاذ الإجراءات اللازمة دون استخدام حساباتهم الشخصية. يعتمد الإعداد الآمن على ثلاثة قرارات: مكان تشغيل البوت، ومن يمكنه إصدار الأوامر له، وما هي الصلاحيات التي يحصل عليها في كل غرفة محمية. حافظ على خصوصية غرفة التحكم، واحمِ الغرف التي تنوي حمايتها فقط، وتحقق من الصلاحيات قبل الاعتماد على البوت أثناء أي حادث.
يتبع هذا الدليل وثائق إعداد Mjolnir الأصلية ووثائق الإشراف، بالإضافة إلى إرشادات الإشراف الخاصة بمجتمع Matrix، والتي تم التحقق منها في 6 أكتوبر 2026. تُشير صفحة إصدارات المشروع إلى أن الإصدار 1.12.1 هو أحدث إصدار وقت المراجعة. يُرجى مراجعة صفحة الإصدارات الأصلية ونموذج التكوين مرة أخرى عند التثبيت، لأن علامات الحاويات والخيارات المدعومة قابلة للتغيير.
هل مطرقة ثور (Mjolnir) مناسبة لمجتمع ماتريكس الخاص بكم؟
استخدم Mjolnir عندما يحتاج المشرفون إلى مشاركة قواعد الإشراف بين عدة غرف، أو الاشتراك في قوائم سياسات مشتركة، أو تطبيق إجراءات متكررة بشكل متسق. لا تزال صلاحيات غرفة Matrix تحدد ما يمكن للروبوت فعله؛ فـ Mjolnir لا يكتسب صلاحيات لمجرد انضمامه إلى غرفة. في الإشراف العادي على الغرف الصغيرة، قد تكون أدوات الغرفة المدمجة كافية. يكون Mjolnir أكثر فائدة عندما يدير نفس المجتمع غرفًا متعددة أو يحتاج إلى سير عمل مشترك ومنظم.
إدارة الغرف وإدارة الخادم الرئيسي اختصاصان منفصلان. يستطيع Mjolnir إدارة عمليات الحظر والتنقيح على مستوى الغرف باستخدام الصلاحيات المناسبة. أما الأوامر الأكثر تأثيرًا على مستوى الخادم - مثل تعطيل المستخدمين، أو نقل الأسماء المستعارة، أو إغلاق الغرف - فتتطلب أن يكون Mjolnir مسؤولًا عن خادم Synapse. لا تمنح صلاحيات إدارة الخادم الرئيسي إلا إذا كان لدى المشرفين حاجة ماسة لهذه العمليات.
ما الذي يجب عليك تحضيره قبل تثبيته؟
- حساب خادم منزلي من نوع Matrix مخصص للروبوت، مثل
@mjolnir:example.org. - غرفة إدارة خاصة حيث يمكن للمشرفين المعتمدين إصدار الأوامر وتلقي رسائل الحالة.
- دليل أو وحدة تخزين دائمة لتكوين وحالة Mjolnir.
- خطة للغرف المشفرة. يدعم تكوين Mjolnir الحالي التشفير الأصلي؛ كما يوثق التكوين Pantalaimon كخيار منفصل وغير مدعوم. لا تقم بتفعيل كلا المسارين معًا.
- غرفة اختبار يمكنك من خلالها تأكيد الدعوات والأذونات وسلوك القوائم قبل حماية غرف الإنتاج المزدحمة.
كيف يتم تثبيت مطرقة ثور (ميولنير)؟
يوثّق المشروع الأصلي عملية تثبيت Docker والتثبيت الذاتي. بالنسبة لمعظم المسؤولين الذين يستخدمون الحاويات بالفعل، يُعدّ Docker Compose خيارًا مناسبًا لأنه يُتيح إعادة تشغيل البوت وعرض السجلات دون الحاجة إلى إبقاء نافذة طرفية تفاعلية مفتوحة. اتبع تعليمات إعداد Docker الخاصة بالمشروع ، وثبّت إصدارًا مُراجعًا في بيئة الإنتاج بدلًا من الاعتماد بشكل دائم على latestعلامة عائمة. الصورة الرسمية هي [رابط الصورة] matrixdotorg/mjolnir.
قم بإعداد التكوين قبل تشغيل الحاوية. يتوقع دليل Docker الأصلي وجود التكوين في دليل بيانات دائم في المسار التالي config/production.yaml: . اجعل هذا الدليل قابلاً للقراءة فقط من قِبل المسؤولين والخدمات التي تحتاج إليه. قد يحتوي الملف على رمز وصول أو بيانات اعتماد تسجيل دخول أخرى؛ لا تقم برفعه إلى مستودع عام، أو لصقه في غرفة دعم، أو تضمينه في سجلات النظام.
استخدم الإعدادات الافتراضية الحالية للمشروع مع التعليقات كمصدر موثوق لأسماء الخيارات. كحد أدنى، حدد عنوان URL للخادم الرئيسي وغرفة الإدارة، ثم قم بتهيئة المصادقة والتشفير للنشر الذي اخترته. إذا كنت تستخدم إعدادًا قائمًا على الرموز المميزة، فتعامل مع الرمز المميز ككلمة مرور. يشرح دليل الإعداد الأصلي كيفية الحصول عليه عن طريق تسجيل الدخول كبوت من ملف تعريف متصفح منفصل في Element، ثم فتح الإعدادات، والمساعدة، وقسم رمز الوصول. يحذر الدليل من تسجيل الخروج بعد ذلك لأن ذلك قد يُبطل الرمز المميز؛ أغلق ملف تعريف المتصفح بدلاً من ذلك. بالنسبة لغرفة إدارة مشفرة، فعّل دعم التشفير في Mjolnir واختبره قبل الاعتماد على الأوامر الموجودة هناك.
# Illustrative values only; use the exact keys and authentication method
# from the current upstream configuration sample. Never share real secrets.
homeserverUrl: https://matrix.example.org
managementRoom: '!privateRoomId:example.org'
accessToken: '[STORE A SECRET HERE, NOT IN PUBLIC]'
هذا المقتطف الصغير ليس إعدادًا كاملاً. على وجه الخصوص، تعتمد إعدادات التشفير وتسجيل الدخول على ما إذا كنت تستخدم التشفير الأصلي أو مسار Pantalaimon الاختياري. يُرجى الرجوع إلى المثال الحالي بدلاً من نسخ مدونة أو ملف قديم. كما يُوصي دليل إعداد Mjolnir بإبقاء البوت قريبًا من خادم الشبكة الرئيسي لتقليل زمن الاستجابة.
كيف يمكنك تأمين غرفة الإدارة؟
أنشئ غرفة للمشرفين الموثوق بهم، وادعُ حساب البوت، واجعل الغرفة خاصة بفريق الإشراف. يُدخل مُعرّف الغرفة أو اسمها المستعار في [المكان المُخصص] managementRoom. يُعرّف الإعداد الحالي هذه الغرفة كمصدر للأوامر، ويُحذّر من أن أي شخص يُمكنه إرسال أوامر إليها يُمكنه التحكم في Mjolnir؛ فهو لا يُوفّر طبقة تحكّم دقيقة في الوصول لكل أمر على حدة. هذا يجعل مراجعة العضوية أمرًا ضروريًا. أزل المشرفين السابقين فورًا، ولا تستخدم غرفة تحكّم البوت كدردشة عامة للمجتمع.
يُنصح بتشفير غرفة الإدارة. في حال تشفيرها، تأكد من قدرة Mjolnir على قراءة الرسائل والرد عليها باستخدام طريقة التشفير المُهيأة. قد يظهر البوت الذي انضم إلى غرفة مُشفرة ولكنه لا يستطيع فك تشفير أحداثها متصلاً بالإنترنت متجاهلاً الأوامر. استخدم إعدادات التشفير وسجلات النظام لتشخيص هذه المشكلة بدلاً من تعطيل تشفير الغرفة كخطوة أولى.
ما هي الصلاحيات التي يجب أن يحصل عليها مطرقة ثور؟
قم بدعوة البوت إلى كل غرفة يُفترض أن يحميها، وامنحه الصلاحيات الكافية لتنفيذ مهام الإشراف المطلوبة. يستخدم نظام Matrix مستويات صلاحيات الغرف لعمليات مثل الحظر والطرد وحجب أحداث المستخدمين الآخرين وتغيير حالة الغرفة. تُحدد القيمة المطلوبة بناءً على حدث مستوى صلاحيات الغرفة؛ وتكون القيم الافتراضية في Matrix للحظر والطرد والحجب عادةً 50 عند عدم تحديدها، ولكن يمكن تغييرها في كل غرفة على حدة.
تُشير إرشادات مجتمع Matrix إلى أن مستوى القوة 100 هو إعداد شائع لـ Mjolnir لتمكينه من فرض قرارات الإشراف. مع ذلك، يُعد هذا المستوى كبيرًا جدًا: أي شخص يتحكم في حساب Mjolnir يمتلك فعليًا هذه السلطة في الغرف المحمية، وقد يصبح البوت مالكًا فعليًا لها. راجع مستويات القوة لكل غرفة واختر مستوى يسمح للبوت بتنفيذ الإجراءات المطلوبة مع الحد من الصلاحيات غير الضرورية. لا تمنحه صلاحيات مدير الخادم الرئيسي للإشراف على الغرف العادية.
في Element، يمكنك دعوة البوت من لوحة أعضاء الغرفة أو إدخال أمر دعوة مثل /invite @mjolnir:example.org. بعد انضمامه، عدّل دوره في قائمة أعضاء الغرفة. كرر هذه العملية لكل غرفة تريد حمايتها. لا يستطيع Mjolnir حماية الغرف التي لم ينضم إليها، وهذا ناتج عن نموذج صلاحيات Matrix اللامركزي الذي يعتمد على كل غرفة على حدة.
كيف يمكنني إنشاء قائمة حظر وإضافة غرف محمية؟
بعد بدء تشغيل البوت ونشر حالته في غرفة الإدارة، أنشئ قائمة سياسات هناك. يستخدم دليل البدء السريع لـ Mjolnir هذا المثال:
!mjolnir list create COC code-of-conduct-ban-list
!mjolnir default COC
!mjolnir rooms add #community:example.org
!mjolnir verify
!mjolnir status
يُنشئ الأمر الأول غرفة قائمة حظر باستخدام الرمز المختصر COC؛ ويتم دعوة الشخص الذي أنشأها ليتمكن من إدارة مستوى ظهورها. يختار الأمر الثاني تلك القائمة كقائمة افتراضية لأوامر الإشراف اللاحقة. يُضيف الأمر الثالث غرفة إلى مجموعة الغرف المحمية في Mjolnir. يتحقق أمر التحقق مما إذا كان لدى البوت الأذونات المطلوبة في جميع الغرف المحمية، بينما يساعد الأمر status في التأكد من أنه يعمل كما هو متوقع. استخدم الأمر !mjolnir helpلعرض صيغة الأوامر المتاحة في نسختك المُثبتة.
احتفظ بقائمة السياسات خاصة إذا كانت تحتوي على ملاحظات داخلية أو مخصصة لفريقك فقط. اجعلها عامة فقط عندما تريد أن تكتشفها مجتمعات أخرى وتشترك فيها. قواعد Mjolnir تراكمية عبر القوائم، لذا راجع القوائم التي تراقبها قبل الاعتماد عليها؛ إذ يمكن لقائمة أن تستمر في مطابقة مستخدم أو خادم حتى لو أزلت قاعدة مكررة من قائمة أخرى.
ما الذي يجب عليك اختباره قبل استخدامه في حادثة حقيقية؟
- تأكد من أن البوت ينشر رسائل بدء التشغيل والحالة في غرفة الإدارة المُهيأة.
- قم بتشغيل البرنامج
!mjolnir verifyبعد دعوته إلى غرفة الاختبار ومنحه الدور المختار. - قم بتشغيل
!mjolnir roomsالجهاز وتأكد من ظهور الغرفة المقصودة، دون تضمين أي غرفة غير ذات صلة. - راجع
!mjolnir protectionsوقم بتفعيل الحمايات التي تفهمها فقط؛ فالحمايات التلقائية قد تؤثر على المستخدمين الشرعيين. - استخدم حسابًا تجريبيًا وغرفة مؤقتة للتحقق من صحة إجراءات الحظر وإلغاء الحظر والتنقيح الخاصة بالفريق قبل تطبيقها على الأعضاء الحقيقيين.
- تحقق من سجلات الحاوية ورسائل غرفة إدارة Mjolnir إذا فات البوت الأوامر أو أبلغ عن أذونات مفقودة.
لا تختبر الحظر عن طريق حظر أحد أعضاء المجتمع الحقيقيين أو باستخدام حظر عام ضد خادم مباشر. قد يؤثر الحظر العام على العديد من المستخدمين؛ ويتطلب الإعداد الافتراضي الحالي علامة تأكيد إضافية للحظر العام. اقرأ دليل المشرف قبل تفعيل الحماية الآلية، ووثّق من لديه صلاحية الموافقة على أي إجراء ذي تأثير كبير.
ما هي أخطاء الإعداد الشائعة؟
- منح خادم البوت صلاحيات المسؤول لتسهيل الأمر: عادةً ما تتطلب إدارة الغرفة صلاحيات الغرفة، وليس حقوق مسؤول Synapse.
- ترك غرفة الإدارة متاحة على نطاق واسع: كل عضو قادر على إصدار الأوامر موثوق به في التحكم في إدارة البوت.
- نسيان أذونات الغرفة المحمية: يمكن أن يكون الروبوت متصلاً بالإنترنت ومع ذلك يفشل في الحظر أو التنقيح إذا كان مستوى قوته منخفضًا جدًا.
- استخدام الغرف المشفرة دون تهيئة التشفير: العضوية وحدها لا تسمح للروبوت بقراءة الأوامر المشفرة.
- نسخ وصفة إعداد قديمة: يتطور تكوين Mjolnir ودعم التشفير؛ استخدم النموذج الافتراضي الحالي ووثائق الإعداد.
- بافتراض أن إزالة قائمة واحدة تلغي كل حظر: قد تظل قائمة مراقبة أخرى تطبق نفس القاعدة.
أين يمكنك التحقق من التفاصيل الحالية؟
ابدأ بدليل إعداد Mjolnir الأصلي ، ودليل المشرف ، وسجل الإصدارات . للاطلاع على صلاحيات الغرف، راجع دليل الإشراف على مجتمع Matrix ومواصفات Matrix لمستويات طاقة الغرف . تعتمد أوامر التثبيت الدقيقة وإعدادات التشفير على خادمك المنزلي، وإعداد الحاوية، وإصدار Mjolnir؛ لذا يجب اعتماد هذه المراجع الأصلية في حال تغيّر التعليمات.