قم بإعداد اسم مستعار مخصص لغرفة المصفوفة على نطاقك الخاص
امنح غرفة Matrix عنوانًا سهل المشاركة على نطاقك باستخدام Element أو Matrix API، مع عمليات التحقق من الأذونات وتسمية Synapse والاتحاد.
لإعطاء غرفة في نظام 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 .
https://matrix.example.comبينما تم تكوينه على عنوان URL server_nameالخاص example.comبالعميل. قد يختلف عنوان URL الخاص بالعميل عن اسم الخادم.support. يجب أن يكون الاسم المستعار فريدًا على الخادم الذي أنشأه.يتطابق المسار التالي مع مصطلحات إعدادات الغرفة في وثائق إعدادات الغرفة الخاصة بـ Element التي تم فحصها في أكتوبر 2026. قد تختلف مواضع القوائم عبر إصدارات Element وعملاء Matrix الآخرين.
في Element Web أو Element Desktop، افتح الغرفة المطلوبة. اختر " إعدادات الغرفة" من لوحة معلومات الغرفة، أو استخدم قائمة النقاط الثلاث الخاصة بالغرفة واختر " الإعدادات" . إذا كنت بحاجة إلى مُعرّف الغرفة الداخلي لتحديد المشاكل لاحقًا، فابحث عنه في قسم "متقدم" وانسخه دون تغيير أي حرف.
في صفحة الإعدادات العامة ، ابحث عن " عناوين الغرف" ، ثم "العناوين المحلية ". أدخل الجزء المحلي من العنوان، مثل " عنوان الغرفة support"، في حقل "عنوان الغرفة" ثم حدد "إضافة " أو زر الحفظ المكافئ. تأكد من أن العنوان الكامل الناتج هو " عنوان الغرفة #support:example.com". إذا انتهى بـ "عنوان :matrix.example.comالغرفة"، فتوقف: هذه مشكلة في اسم خادم المنزل، وليست خطأً إملائيًا يمكن تصحيحه من خلال إعدادات الغرفة.
ضمن قسم "عناوين الغرف" ، ابحث عن "العناوين المنشورة" وعيّن " العنوان الرئيسي" إلى العنوان #support:example.comالمطلوب. تشير وثائق Element إلى أنه عادةً ما يتم اختيار أول عنوان محلي يتم إنشاؤه كعنوان رئيسي تلقائيًا. يُفيد تحديده صراحةً عندما تحتوي الغرفة بالفعل على عدة أسماء مستعارة.
العنوان الرئيسي هو الاسم المستعار الرسمي للغرفة : وهو العنوان المفضل المُعلن عنه في حالة الغرفة. إنشاء اسم مستعار واختيار الاسم المستعار الرسمي عمليتان مرتبطتان ولكنهما منفصلتان. يدعم نظام Matrix أيضًا أسماء مستعارة بديلة مُعلن عنها. يجب أن يكون الاسم المستعار الرسمي مُرتبطًا بتلك الغرفة قبل الإعلان عنها.
فعّل خيار "نشر هذه الغرفة في دليل الغرف العامة" فقط عندما ترغب فعلاً في ظهورها في الدليل. تحديد عنوان الغرفة لا يجعلها عامة، ونشرها منفصل عن قواعد الانضمام إليها. يمكن للغرفة الخاصة أو التي لا يُسمح بالانضمام إليها إلا بدعوة شخص ما أن يكون لها اسم مستعار يسهل تذكره دون منح الجميع إذن الانضمام. بالنسبة لغرف المجتمع العامة، تحقق من إعدادات الدليل وقواعد الانضمام قبل مشاركة العنوان على نطاق واسع.
يمكن للمسؤولين وأدوات التشغيل الآلي استخدام واجهة برمجة تطبيقات 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 الحالية عليها. بالنسبة للنشر الجديد، حدد اسم الخادم المطلوب قبل إنشاء المستخدمين والغرف. إذا كنت تعمل بالفعل باسم آخر، فقد يكون استخدام نطاق النطاق البديل الفعلي هو الخيار الأكثر أمانًا، إلا إذا تمكنت من تخصيص خادم رئيسي باسم مناسب لامتلاك أسماء النطاقات البديلة الجديدة.
يشير HTTP 403عادةً إلى رفض الإذن أو وجود سياسة خادم سارية. تحقق من صلاحيات المستخدم في الغرفة وقواعد Synapse alias_creation_rules؛ حيث تُقيّم القواعد بالتسلسل، وتمنع القائمة الفارغة تمامًا إنشاء أي اسم مستعار. أما HTTP 409فيعني أن الاسم المستعار موجود بالفعل. اختر جزءًا محليًا مختلفًا أو تحقق من التعيين الحالي بدلًا من استبداله عشوائيًا. يوثق دليل تكوين Synapse خيارات سياسة الأسماء المستعارة.
تأكد أولاً من إمكانية الوصول إلى الاسم المستعار محلياً. إذا نجح البحث المحلي ولكن فشل الاكتشاف الخارجي، فافحص عملية الربط بين نطاق الاسم المستعار ، بما في ذلك شهادات HTTPS، /.well-known/matrix/serverوالتفويض ذي الصلة، ومستمع الربط المُعرَض. لا يؤدي استخدام اسم مضيف لحركة مرور العميل إلى إنشاء ربط تلقائي لاسم خادم Matrix مختلف. توضح واجهة برمجة تطبيقات Matrix Server-Server عملية اكتشاف الخادم والتفويض. تأكد أيضاً من السماح للمستخدمين عن بُعد بالانضمام؛ فقد يتم الوصول إلى غرفة مخصصة للدعوات فقط بنجاح مع رفض الانضمام.
#support:example.comيظهر تحت العناوين المحلية وكعنوان رئيسي مقصود في Element.room_idبالمعرف الموضح في إعدادات الغرفة المتقدمة في Element.https://matrix.to/#/%23support%3Aexample.com. من المفترض أن يؤدي الرابط إلى الغرفة المطلوبة؛ أما إمكانية انضمام الحساب فتعتمد على قواعد الوصول الخاصة بالغرفة.يُحدد مرجع تنسيق الغرفة و matrix.to في Matrix تنسيق رابط المشاركة المُشفّر. إذا اجتازت جميع الفحوصات الثلاثة بنجاح، يكون العنوان الجديد جاهزًا للمشاركة بينما يبقى مُعرّف الغرفة الأصلي دون تغيير.
امنح غرفة Matrix عنوانًا سهل المشاركة على نطاقك باستخدام Element أو Matrix API، مع عمليات التحقق من الأذونات وتسمية Synapse والاتحاد.
قم بتكوين coturn و Synapse باستخدام بيانات اعتماد TURN المطابقة، وافتح منافذ الترحيل المطلوبة، وتحقق من أن عملاء Matrix يمكنهم الحصول على مرشحي الترحيل.
قم بإعداد خادم Synapse منزلي دائم باستخدام Docker Compose و PostgreSQL وتكوين خاص وفحوصات قبل عرضه عبر HTTPS.
قم بتعيين اسم ذي علامة تجارية وألوان مخصصة وأصول تسجيل دخول لنشر Element Web الخاص بك مع فهم الأجزاء التي ستظل تحمل علامة Element التجارية.
قم بتشخيص ما إذا كان برنامج Synapse قد وصل إلى الحد الأقصى للملفات المفتوحة لكل عملية، وقم بتعيين ملف systemd drop-in للخدمة أو العامل المناسب، وتحقق من الحد الأقصى للتشغيل.
اكتشف ما إذا كان الخطأ يقتصر على متصفح واحد أو حدث واحد، ثم استخدم مفتاح استرداد Element أو جهازًا موثوقًا به دون المخاطرة بسجل التصفح المشفر المتبقي.
استخدم واجهات برمجة تطبيقات Synapse الخاصة بحذف السجلات والوسائط أو إعدادات الاحتفاظ لإزالة البيانات القديمة بأمان، ثم تحقق من اكتمال العملية واستعادة مساحة القرص.
قم بتثبيت المكتبة الحالية، وقم بتوصيل حساب Matrix مخصص، وقم بتشغيل روبوت !echo صغير مع معالجة بيانات اعتماد أكثر أمانًا واختبار واضح.
قم بإعداد ثلاثة جسور mautrix مع تسجيلات وتسجيلات دخول واختبارات منفصلة - وتجنب مفاجآت شبكات Docker وسياسة الحساب والمزامنة.
ابحث عن الأشياء التي تملأ مساحة تخزين Synapse، وقم بتعيين الاحتفاظ الآمن بالوسائط، وقم بمسح ذاكرة التخزين المؤقت عن بعد دون حذف الملفات مباشرة من القرص.