قم بإعداد اسم مستعار مخصص لغرفة المصفوفة على نطاقك الخاص

لإعطاء غرفة في نظام Matrix عنوانًا مثل #support:example.com`<عنوان الغرفة>`، أنشئ اسمًا مستعارًا محليًا للغرفة على الخادم الرئيسي الذي يحمل اسم الخادم المُكوّن `<اسم الخادم>` example.com، ثم حدد هذا الاسم المستعار كعنوان الغرفة الرئيسي في Element. لا تحتاج إلى سجل DNS منفصل لكل اسم مستعار للغرفة، ولكن لا يمكنك تغيير نطاق الاسم المستعار للخادم الرئيسي الحالي بمجرد توجيه DNS إليه.

فهم عناصر التحكم في النطاق المخصص

اسم الغرفة المستعار هو عنوان قابل للقراءة يُشير إلى مُعرّف الغرفة الدائم في نظام المصفوفة ، وهو مُعرّف يبدأ عادةً بـ !. يمكن أن تحتوي الغرفة الواحدة على عدة أسماء مستعارة، على سبيل المثال #support:example.comو #help:example.com، وكلاهما يُشير إلى الغرفة نفسها. يُحدد النص الذي يلي النقطتين خادم المنزل المسؤول عن حلّ هذا الاسم المستعار، وليس بالضرورة الخادم الذي يستضيف جميع المشاركين.

يُعرّف Matrix الأسماء المستعارة بالصيغة التالية #localpart:server-name: . بالنسبة إلى Synapse، server_nameيُحدد هذا الإعداد النطاق المستخدم لعناوين الغرف المُنشأة محليًا، وتُشير وثائق Synapse إلى أنه لا يُمكن تغيير هذا الإعداد بعد الإعداد الأولي. إذا كان اسم خادمك الحالي هو matrix.example.com، فلن يقوم Element بتحويل أسمائه المستعارة المحلية إلى #support:example.comلمجرد امتلاكك لـ example.com. راجع مواصفات مُعرّف Matrix ودليل تكوين Synapse .

تحقق من المتطلبات الأساسية

  • خادم Matrix منزلي يعمل: يفترض هذا المثال أن Synapse يقوم بالفعل بخدمة طلبات واجهة برمجة تطبيقات العميل على عنوان URL المحدد، https://matrix.example.comبينما تم تكوينه على عنوان URL server_nameالخاص example.comبالعميل. قد يختلف عنوان URL الخاص بالعميل عن اسم الخادم.
  • غرفة موجودة: أنشئ الغرفة أولاً إذا لزم الأمر. اختر اسمًا مستعارًا قصيرًا ومميزًا، مثل localpart support. يجب أن يكون الاسم المستعار فريدًا على الخادم الذي أنشأه.
  • إذن إدارة العناوين: سجّل الدخول باستخدام حساب مُصرّح له بإنشاء اسم مستعار محلي وتغيير العنوان الرئيسي للغرفة. قد تُقيّد سياسة إنشاء الأسماء المستعارة للخادم ومستويات طاقة الغرفة هذه الإجراءات.
  • إحدى طرق الاختبار: احتفظ بحساب Matrix ثانٍ متاحًا، ويفضل أن يكون على خادم منزلي آخر، حتى تتمكن من التحقق من الاكتشاف بشكل مستقل عن جلسة المسؤول الخاصة بك.

أنشئ الاسم المستعار في Element Web

يتطابق المسار التالي مع مصطلحات إعدادات الغرفة في وثائق إعدادات الغرفة الخاصة بـ Element التي تم فحصها في أكتوبر 2026. قد تختلف مواضع القوائم عبر إصدارات Element وعملاء Matrix الآخرين.

1. افتح إعدادات الغرفة

في Element Web أو Element Desktop، افتح الغرفة المطلوبة. اختر " إعدادات الغرفة" من لوحة معلومات الغرفة، أو استخدم قائمة النقاط الثلاث الخاصة بالغرفة واختر " الإعدادات" . إذا كنت بحاجة إلى مُعرّف الغرفة الداخلي لتحديد المشاكل لاحقًا، فابحث عنه في قسم "متقدم" وانسخه دون تغيير أي حرف.

2. أضف عنوانًا محليًا

في صفحة الإعدادات العامة ، ابحث عن " عناوين الغرف" ، ثم "العناوين المحلية ". أدخل الجزء المحلي من العنوان، مثل " عنوان الغرفة support"، في حقل "عنوان الغرفة" ثم حدد "إضافة " أو زر الحفظ المكافئ. تأكد من أن العنوان الكامل الناتج هو " عنوان الغرفة #support:example.com". إذا انتهى بـ "عنوان :matrix.example.comالغرفة"، فتوقف: هذه مشكلة في اسم خادم المنزل، وليست خطأً إملائيًا يمكن تصحيحه من خلال إعدادات الغرفة.

3. اختر العنوان الرئيسي

ضمن قسم "عناوين الغرف" ، ابحث عن "العناوين المنشورة" وعيّن " العنوان الرئيسي" إلى العنوان #support:example.comالمطلوب. تشير وثائق Element إلى أنه عادةً ما يتم اختيار أول عنوان محلي يتم إنشاؤه كعنوان رئيسي تلقائيًا. يُفيد تحديده صراحةً عندما تحتوي الغرفة بالفعل على عدة أسماء مستعارة.

العنوان الرئيسي هو الاسم المستعار الرسمي للغرفة : وهو العنوان المفضل المُعلن عنه في حالة الغرفة. إنشاء اسم مستعار واختيار الاسم المستعار الرسمي عمليتان مرتبطتان ولكنهما منفصلتان. يدعم نظام Matrix أيضًا أسماء مستعارة بديلة مُعلن عنها. يجب أن يكون الاسم المستعار الرسمي مُرتبطًا بتلك الغرفة قبل الإعلان عنها.

4. تحديد ما إذا كانت الغرفة تنتمي إلى دليل

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

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

يمكن للمسؤولين وأدوات التشغيل الآلي استخدام واجهة برمجة تطبيقات Matrix القياسية للعميل والخادم . ينشئ المثال أدناه نفس الاسم المستعار؛ لا تقم بتشغيله إذا كان العنصر موجودًا بالفعل #support:example.com. استبدل معرّف الغرفة الحقيقي ورمز وصول صالحًا لمستخدم مسموح به بموجب سياسة الأسماء المستعارة للخادم الرئيسي. تعامل مع الرمز ككلمة مرور.

curl --request PUT \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  --data '{"room_id":"!yourRoomId:example.com"}' \
  'https://matrix.example.com/_matrix/client/v3/directory/room/%23support%3Aexample.com'

يُعيد الطلب الناجح 200كائن JSON فارغًا عبر HTTP. يُمثل الجزءان %23`<name>` و` <name>` %3Aترميز URL لـ ` <name>` #و` :<name>`. يُنشئ طلب PUT ربطًا بين اسم مستعار وغرفة، ولا يُغير بالضرورة الاسم المستعار الرسمي للغرفة. بعد إنشاء الغرفة عبر واجهة برمجة التطبيقات فقط، ارجع إلى عنصر تحكم العنوان الرئيسي في Element إذا كنت ترغب في الإعلان عن هذا الاسم المستعار كاسم رئيسي. يُرجى عدم لصق رمز حامل حقيقي في أمر shell مشترك، أو لقطة شاشة، أو تذكرة دعم.

تأكد من أن عملية الربط تتم بنجاح

لا يتطلب البحث في الدليل تسجيل دخول. استبدل عنوان URL الخاص بالمضيف بنقطة نهاية واجهة برمجة التطبيقات (API) الخاصة بك والتي يمكن الوصول إليها.

curl --fail-with-body --silent --show-error \
  'https://matrix.example.com/_matrix/client/v3/directory/room/%23support%3Aexample.com'

يجب أن تتضمن الاستجابة اسم room_idغرفة الوجهة ومصفوفة servers. يختبر هذا حلّ الأسماء المستعارة، وليس ما إذا كان بإمكان كل خادم بعيد الاتصال بخادمك.

حل الإخفاقات الشائعة

الاسم المستعار له نطاق خاطئ

تحقق من إعدادات Synapse server_name. لا تُغير هذه القيمة على خادم قائم في محاولة لتغيير أسماء النطاقات البديلة، إذ تعتمد هويته ومعرّفات Matrix الحالية عليها. بالنسبة للنشر الجديد، حدد اسم الخادم المطلوب قبل إنشاء المستخدمين والغرف. إذا كنت تعمل بالفعل باسم آخر، فقد يكون استخدام نطاق النطاق البديل الفعلي هو الخيار الأكثر أمانًا، إلا إذا تمكنت من تخصيص خادم رئيسي باسم مناسب لامتلاك أسماء النطاقات البديلة الجديدة.

فشل الإنشاء مع ظهور الخطأ 403 أو 409

يشير HTTP 403عادةً إلى رفض الإذن أو وجود سياسة خادم سارية. تحقق من صلاحيات المستخدم في الغرفة وقواعد Synapse alias_creation_rules؛ حيث تُقيّم القواعد بالتسلسل، وتمنع القائمة الفارغة تمامًا إنشاء أي اسم مستعار. أما HTTP 409فيعني أن الاسم المستعار موجود بالفعل. اختر جزءًا محليًا مختلفًا أو تحقق من التعيين الحالي بدلًا من استبداله عشوائيًا. يوثق دليل تكوين Synapse خيارات سياسة الأسماء المستعارة.

لا يستطيع الأشخاص الموجودون على خوادم أخرى العثور على الغرفة

تأكد أولاً من إمكانية الوصول إلى الاسم المستعار محلياً. إذا نجح البحث المحلي ولكن فشل الاكتشاف الخارجي، فافحص عملية الربط بين نطاق الاسم المستعار ، بما في ذلك شهادات HTTPS، /.well-known/matrix/serverوالتفويض ذي الصلة، ومستمع الربط المُعرَض. لا يؤدي استخدام اسم مضيف لحركة مرور العميل إلى إنشاء ربط تلقائي لاسم خادم Matrix مختلف. توضح واجهة برمجة تطبيقات Matrix Server-Server عملية اكتشاف الخادم والتفويض. تأكد أيضاً من السماح للمستخدمين عن بُعد بالانضمام؛ فقد يتم الوصول إلى غرفة مخصصة للدعوات فقط بنجاح مع رفض الانضمام.

تحقق من عنوان الغرفة المخصصة

  1. تحقق من ذلك الذي #support:example.comيظهر تحت العناوين المحلية وكعنوان رئيسي مقصود في Element.
  2. قم بتشغيل طلب GET للدليل غير المصادق عليه أعلاه وقارنه room_idبالمعرف الموضح في إعدادات الغرفة المتقدمة في Element.
  3. حاول فتح الرابط من حساب آخر https://matrix.to/#/%23support%3Aexample.com. من المفترض أن يؤدي الرابط إلى الغرفة المطلوبة؛ أما إمكانية انضمام الحساب فتعتمد على قواعد الوصول الخاصة بالغرفة.

يُحدد مرجع تنسيق الغرفة و matrix.to في Matrix تنسيق رابط المشاركة المُشفّر. إذا اجتازت جميع الفحوصات الثلاثة بنجاح، يكون العنوان الجديد جاهزًا للمشاركة بينما يبقى مُعرّف الغرفة الأصلي دون تغيير.

اترك تعليقاً

قم بإعداد اسم مستعار مخصص لغرفة المصفوفة على نطاقك الخاص

امنح غرفة Matrix عنوانًا سهل المشاركة على نطاقك باستخدام Element أو Matrix API، مع عمليات التحقق من الأذونات وتسمية Synapse والاتحاد.

إعداد نظام كوتور لإجراء مكالمات صوتية ومرئية موثوقة عبر المصفوفة

قم بتكوين coturn و Synapse باستخدام بيانات اعتماد TURN المطابقة، وافتح منافذ الترحيل المطلوبة، وتحقق من أن عملاء Matrix يمكنهم الحصول على مرشحي الترحيل.

نشر Matrix Synapse باستخدام Docker Compose و PostgreSQL

نشر Matrix Synapse باستخدام Docker Compose و PostgreSQL

قم بإعداد خادم Synapse منزلي دائم باستخدام Docker Compose و PostgreSQL وتكوين خاص وفحوصات قبل عرضه عبر HTTPS.

تخصيص مظهر وعلامة Element Web التجارية

قم بتعيين اسم ذي علامة تجارية وألوان مخصصة وأصول تسجيل دخول لنشر Element Web الخاص بك مع فهم الأجزاء التي ستظل تحمل علامة Element التجارية.

رفع حد ملفات Systemd في Synapse بدون تخمين

رفع حد ملفات Systemd في Synapse بدون تخمين

قم بتشخيص ما إذا كان برنامج Synapse قد وصل إلى الحد الأقصى للملفات المفتوحة لكل عملية، وقم بتعيين ملف systemd drop-in للخدمة أو العامل المناسب، وتحقق من الحد الأقصى للتشغيل.

هل تظهر رسالة "فشل فك التشفير"؟ استعد مفتاح الغرفة المفقود

هل تظهر رسالة "فشل فك التشفير"؟ استعد مفتاح الغرفة المفقود

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

تنظيف رسائل Synapse القديمة والوسائط دون فقدان البيانات

استخدم واجهات برمجة تطبيقات Synapse الخاصة بحذف السجلات والوسائط أو إعدادات الاحتفاظ لإزالة البيانات القديمة بأمان، ثم تحقق من اكتمال العملية واستعادة مساحة القرص.

قم بإنشاء روبوت صدى المصفوفة باستخدام بايثون مع مكتبة Simple-Matrix-Bot-Lib

قم بإنشاء روبوت صدى المصفوفة باستخدام بايثون مع مكتبة Simple-Matrix-Bot-Lib

قم بتثبيت المكتبة الحالية، وقم بتوصيل حساب Matrix مخصص، وقم بتشغيل روبوت !echo صغير مع معالجة بيانات اعتماد أكثر أمانًا واختبار واضح.

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

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

قم بإعداد ثلاثة جسور mautrix مع تسجيلات وتسجيلات دخول واختبارات منفصلة - وتجنب مفاجآت شبكات Docker وسياسة الحساب والمزامنة.

استعادة مساحة قرص Synapse Media دون الإضرار بالملفات المشتركة

ابحث عن الأشياء التي تملأ مساحة تخزين Synapse، وقم بتعيين الاحتفاظ الآمن بالوسائط، وقم بمسح ذاكرة التخزين المؤقت عن بعد دون حذف الملفات مباشرة من القرص.