الاستضافة الذاتية والتطبيقات الأدلة التقنية

Matrix مع Element: محادثة مشفرة بين مؤسستين

شغلنا سيرفرين من Synapse متحدين في Docker، أحدهما للشركة والآخر لمكتب التدقيق، وفتحنا بينهما محادثة مشفرة تحققنا منها برموز Emoji، ثم فتشنا قاعدة بيانات كل سيرفر لنرى ما يعرفه.

Matrix مع Element: محادثة مشفرة بين مؤسستين

في مقال مصطلحات المحادثة رأينا أن الاتحاد Federation يجعل كل مؤسسة على سيرفرها مثل البريد، وأن التشفير من طرف إلى طرف E2EE يخفي الرسالة عن السيرفر نفسه، وأن التحقق من الأجهزة هو الذي يكشف السيرفر الذي يبدل المفاتيح. وفي هذا المقال ننتقل من الفكرة إلى سيرفرين حقيقيين: الشركة الناشئة التي نتابعها في السلسلة، وهي شركة فوترة إلكترونية فيها 45 موظفاً تترك Slack، تتعامل كل أسبوع مع مكتب تدقيق خارجي له فريقه وسيرفره، وكل ما بينهما اليوم يمر عبر قناة Slack Connect على سيرفر شركة ثالثة، أو عبر البريد بملفات مرفقة لا يعرف أحد أي نسخة منها هي الأخيرة.

والمطلوب واضح: غرفة مشتركة بين الشركة ومكتب التدقيق، كل طرف يدخلها من سيرفره وبحسابه، والرسائل فيها مشفرة بحيث لا يقرؤها مدير أي من السيرفرين، ولا تحتاج الشركة أن تنشئ لموظفي المكتب حسابات ضيف تتذكر أن توقفها عندما ينتهي العقد. وهذا بالضبط ما صمم له Matrix، لذلك سوف نشغل في هذا المقال سيرفرين من Synapse داخل Docker، واحداً للشركة باسم company.test وآخر للمكتب باسم audit.test، ونجعلهما يتحدان فعلاً عبر TLS، ثم نفتح بينهما محادثة مشفرة من Element Web في متصفحين، ونتحقق من الطرف الآخر برموز Emoji، ثم ننظر في قاعدة بيانات كل سيرفر لنرى ما الذي يعرفه وما الذي لا يعرفه، ثم نوقف سيرفر المكتب ونرى ماذا يحدث لرسالة أرسلت في غيابه.

المواضيع في السلسلة:

  • مصطلحات المحادثة للمبتدئين.
  • Matrix مع Element: محادثة مشفرة بين مؤسستين (الموضوع الحالي).
  • Rocket.Chat: محادثة الفريق مع العملاء والقنوات الخارجية.
  • Zulip: محادثة منظمة بالمواضيع للفرق الكبيرة.
  • اجتماعات الفيديو مع Jitsi Meet.
  • مقارنة Mattermost وRocket.Chat وZulip وMatrix على الحالة نفسها.

وسوف نناقش في هذا المقال ما يلي:

  • ما هو Matrix من الداخل: البروتوكول والسيرفر والعميل والغرفة كسلسلة من الأحداث الموقعة.
  • أي سيرفر تختار: Synapse أم Continuwuity أم حزمة Element الجاهزة، وما الترخيص.
  • بناء سيرفرين متحدين في Docker، مع شرح كل إعداد غيرناه ولماذا.
  • المشكلة الأولى التي ظهرت: السيرفر يرفض أن يتصل بعنوان داخلي، والإعداد الذي لم يعمل باسمه الجديد.
  • محادثة مشفرة بين المؤسستين في Element، والتحقق برموز Emoji، وما الذي يحدث خلف كل خطوة.
  • ماذا وجدنا في قاعدة بيانات السيرفرين، وما الذي لا يخفيه التشفير.
  • تسجيل دخول ثان يطلب إثبات الهوية، وحد محاولات الدخول، وسيرفر الشريك المتوقف.
  • ما الذي يتغير في الإنتاج، ونقاط القوة ونقاط الضعف، وقائمة تحقق.

كيف يعمل Matrix من الداخل؟ Protocol

Matrix ليس برنامجاً، وإنما معيار مفتوح يصف كيف تتكلم البرامج مع بعضها، وتكتبه مؤسسة غير ربحية هي Matrix.org Foundation وتنشره في موقع المواصفات. وهذا المعيار يقسم العالم إلى ثلاثة أجزاء، ويحدد بين كل جزأين واجهة برمجية API منفصلة:

  • العميل Client: البرنامج الذي يستخدمه الموظف، مثل Element على الويب والجوال وسطح المكتب، أو أي برنامج آخر يتبع المعيار. والعميل يتكلم مع سيرفر مؤسسته فقط عبر واجهة العميل للسيرفر Client-Server API، وهي HTTP وJSON عادية.
  • السيرفر الرئيسي Homeserver: السيرفر الذي يحمل حسابات مؤسستك ويحفظ الغرف التي فيها أحد من موظفيك، وأشهر برامجه Synapse.
  • السيرفرات الأخرى: عندما يكون في الغرفة شخص من سيرفر آخر، يتكلم السيرفران عبر واجهة السيرفر للسيرفر Server-Server API، ويوقع كل سيرفر ما يرسله بمفتاحه الخاص، فيتحقق الطرف الآخر أن الحدث جاء فعلاً من company.test وليس من أحد ينتحل اسمها.

والفكرة التي تميز Matrix عن Slack وعن XMPP أن الغرفة Room ليست ملكاً لسيرفر واحد، وإنما هي سلسلة من الأحداث Events، كل حدث فيها يشير إلى الأحداث التي قبله، فتتكون منها بنية تشبه سجل Git أكثر مما تشبه جدول رسائل، ويسميها المعيار رسماً موجهاً غير دوري DAG. وكل سيرفر فيه عضو من الغرفة يحمل نسخة من هذا الرسم، وإذا انقطع سيرفران عن بعضهما ثم رجعا، يتبادلان الأحداث التي فاتتهما ويدمجانها، كما يدمج Git فرعين. والرسالة نفسها حدث من نوع m.room.message، أو m.room.encrypted إذا كانت الغرفة مشفرة، ودخول شخص إلى الغرفة حدث من نوع m.room.member، وتغيير اسم الغرفة حدث، وتغيير الصلاحيات حدث، وهذا ما سوف نراه بعيننا في قاعدة البيانات بعد قليل.

وعنوان المستخدم في Matrix يحمل اسم سيرفره بعد النقطتين: @sara:company.test، والغرفة لها معرف يبدأ بعلامة التعجب مثل !Z3Wgxgdd…:company.test وقد يكون لها اسم مستعار Alias مثل #audit-q4:company.test. ولاحظ أن الجزء بعد النقطتين هو اسم السيرفر Server Name وليس بالضرورة اسم الجهاز الذي يعمل عليه السيرفر، فتستطيع أن تجعل عناوين موظفيك @sara:company.example بينما يعمل السيرفر على matrix.company.example، وهذا ما يسمى التفويض Delegation، وسوف نرجع إليه في قسم الإنتاج.

أي سيرفر تختار؟ Synapse أم Continuwuity

لأن Matrix معيار، فهناك أكثر من برنامج يعمل كسيرفر رئيسي، والخيارات العملية اليوم ثلاثة:

  • Synapse: السيرفر المرجعي المكتوب بلغة Python، وهو الأقدم والأكثر اكتمالاً في دعم المعيار، وتطوره شركة Element. وقد نقلته Element في ديسمبر 2023 إلى ترخيص AGPLv3 مع اتفاقية مساهمين CLA، وذكرت في الإعلان أن السبب أنها تكتب أغلب كوده ولم تصبح شركة رابحة بعد، فتريد من الجهات التجارية التي تبني عليه أن تنشر تعديلاتها أو تشتري استثناء من الترخيص. وبالنسبة لشركة تشغله لموظفيها دون أن تبيعه فهذا لا يغير شيئاً، والإصدار الذي جربناه هو 1.164.2 الصادر في 2 نوفمبر 2026.
  • Continuwuity: سيرفر مكتوب بلغة Rust، يأتي من سلسلة مشاريع بدأت بـ Conduit، ويعمل كملف تنفيذي واحد مع قاعدة بيانات مدمجة، فيأخذ ذاكرة أقل بكثير ولا يحتاج PostgreSQL. وهو مناسب لسيرفر صغير أو تجربة، ولكنه مشروع مجتمعي أصغر، ودعمه لبعض أجزاء المعيار يتأخر عن Synapse.
  • ESS Community: حزمة من Element تجمع Synapse مع خدمة الدخول Matrix Authentication Service وElement Web وElement Call، وتثبت عبر Helm على Kubernetes أو على جهاز واحد. وتقول صفحتها إنها موجهة لتثبيتات من 1 إلى 100 مستخدم للاستخدام غير المهني والتقييم، وإنها غير مخصصة للإنتاج في البيئات التجارية، وتوجه الشركات إلى النسخة المدفوعة ESS Pro.

وقد اخترنا Synapse في المختبر لأنه السيرفر الذي تكتب عليه أغلب الوثائق ويقيس عليه الجميع، ولأن ما نريد أن نراه، وهو الاتحاد والتشفير، يعمل فيه كما يصفه المعيار تماماً. ولاحظ أن صفحة ESS Community الرسمية هي التي تقول إنها ليست للإنتاج التجاري، وهذا يعني أن الشركة التي نتابعها إذا أرادت Matrix في الإنتاج فأمامها طريقان: Synapse تديره بنفسها كما في هذا المقال مع PostgreSQL، أو اشتراك مدفوع مع Element. وأما العميل فهو Element Web 1.12.33، وهو موقع ثابت من HTML وJavaScript يعمل في المتصفح ويكلم السيرفر مباشرة، وكل التشفير يحدث داخل المتصفح نفسه.

المختبر: سيرفران متحدان في Docker Lab

الصورة التالية تبين ما سوف نبنيه: شبكة Docker واحدة اسمها wr-chat-net، فيها سيرفر للشركة وسيرفر للمكتب، ولكل منهما منفذان: 8008 للعملاء، و8448 للاتحاد عبر TLS، وContainer ثالث يقدم ملفات Element Web فقط.

شبكة Docker باسم wr-chat-net على 172.18.0.0/16، فيها wr-chat-hs1 بالاسم company.test وwr-chat-hs2 بالاسم audit.test، وكلاهما Synapse 1.164.2 مع SQLite ومنفذ 8008 للعملاء و8448 للاتحاد عبر TLS بشهادات ذاتية التوقيع، وwr-chat-element يقدم Element Web 1.12.33، ومتصفح على localhost:18008 لـ sara ومتصفح على localhost:18009 لـ omar
كل سيرفر يملك حساباته ومفتاح توقيعه، ويتكلمان عبر المنفذ 8448، وElement يعمل في المتصفح

والسؤال الأول هو: كيف يجد سيرفر الشركة سيرفر المكتب؟ عندما يريد Synapse أن يرسل شيئاً إلى audit.test، فإنه يتبع الخطوات التي يحددها المعيار بالترتيب: يطلب أولاً الملف https://audit.test/.well-known/matrix/server ليعرف هل فوض المكتب سيرفراً آخر، فإذا لم يجده يبحث عن سجل SRV في DNS، فإذا لم يجده يتصل بـ audit.test على المنفذ 8448 مباشرة. وفي المختبر جعلنا الخطوة الأخيرة هي التي تعمل، بأن أعطينا كل Container اسماً مستعاراً Alias في شبكة Docker هو اسم سيرفره، فيحل DNS الداخلي في Docker الاسم audit.test إلى عنوان Container المكتب.

شهادة لكل سيرفر Certificates

الاتحاد يمر دائماً عبر TLS، لذلك يحتاج كل سيرفر شهادة باسمه. وفي الإنتاج تكون الشهادة من Let's Encrypt على نطاق حقيقي، أما في المختبر فلا يوجد نطاق عام، فأنشأنا شهادة ذاتية التوقيع Self-Signed لكل سيرفر بهذا السكربت داخل debian:13-slim:

# Self-signed certificate for each homeserver (lab only)
set -e
apt-get update -qq >/dev/null && apt-get install -y -qq openssl >/dev/null
for s in company.test audit.test; do
  d=/certs/$s; mkdir -p $d
  openssl req -x509 -newkey ec -pkeyopt ec_paramgen_curve:P-256 -nodes -days 30 \
    -subj "/CN=$s" -addext "subjectAltName=DNS:$s" -keyout $d/tls.key -out $d/tls.crt 2>/dev/null
  echo "$s: $(openssl x509 -in $d/tls.crt -noout -subject -enddate | tr '\n' ' ')"
done

والمخرج:

company.test: subject=CN=company.test notAfter=Dec  5 17:42:07 2026 GMT
audit.test: subject=CN=audit.test notAfter=Dec  5 17:42:07 2026 GMT 

ولاحظ أن الشهادة تحمل اسم السيرفر في الحقل subjectAltName، لأن TLS الحديث يتحقق من هذا الحقل وليس من CN، وأن مدتها 30 يوماً لأنها لن تعيش أكثر من المختبر. وقد شرحنا الحقول والصيغ في مقال الشهادات الرقمية TLS وX.509.

إعداد Synapse: ما الذي غيرناه ولماذا Configuration

يأتي Image الرسمي matrixdotorg/synapse بأمر generate ينشئ ملف homeserver.yaml ومفتاح توقيع السيرفر Signing Key وأسراراً عشوائية، والملف الذي ينشئه يعمل بـ SQLite ويستمع على المنفذ 8008 فقط دون TLS. لذلك كتبنا سكربتاً صغيراً بلغة Python يعدل الملف بعد إنشائه، وشغلناه داخل Image Synapse نفسه لأنه يحمل مكتبة YAML:

# Adds a TLS federation listener and lab settings to the generated homeserver.yaml
# Run inside the Synapse image: python /lab/patch.py /data/homeserver.yaml
import sys, yaml
p = sys.argv[1]
c = yaml.safe_load(open(p))
c['listeners'] = [
    {'port': 8008, 'type': 'http', 'tls': False, 'x_forwarded': True,
     'resources': [{'names': ['client'], 'compress': False}]},
    {'port': 8448, 'type': 'http', 'tls': True,
     'resources': [{'names': ['federation'], 'compress': False}]},
]
c['tls_certificate_path'] = '/data/tls.crt'
c['tls_private_key_path'] = '/data/tls.key'
c['federation_verify_certificates'] = False   # lab only: self-signed certificates
c['trusted_key_servers'] = []                 # fetch server keys directly, not via matrix.org
c['enable_registration'] = False
c['presence'] = {'enabled': True}
yaml.safe_dump(c, open(p, 'w'), sort_keys=False)
print('patched', c['server_name'])

في الإعداد أعلاه لاحظ التالي:

  • فصلنا المستمع Listener الخاص بالعملاء على 8008 عن مستمع الاتحاد على 8448، والملف الأصلي يضع الاثنين على 8008. والسبب أن المنفذين لهما جمهوران مختلفان: 8008 يجب أن يصل إليه موظفوك فقط عبر الـ Reverse Proxy، و8448 يجب أن يصل إليه السيرفرات الأخرى من الإنترنت، وفصلهما يسمح لك أن تضع لكل منهما قواعد مختلفة في الجدار الناري Firewall.
  • federation_verify_certificates: false هو الإعداد الوحيد في المختبر الذي لا يجب أن تراه في الإنتاج أبداً، لأنه يجعل سيرفرك يقبل أي شهادة من أي سيرفر، ويذكر توثيق الإعدادات أن قيمته الافتراضية true. وقد احتجناه لأن شهاداتنا ذاتية التوقيع.
  • trusted_key_servers: []: الملف الأصلي يجعل matrix.org سيرفراً موثوقاً يسأله سيرفرك عن مفاتيح السيرفرات الأخرى، وهذا مريح على الإنترنت، ولكنه يعني أن سيرفرك يخبر matrix.org بأسماء السيرفرات التي يتكلم معها. وفي المختبر لا يوجد إنترنت أصلاً، وفي شركة حساسة قد تفضل أن يأخذ سيرفرك المفاتيح من كل سيرفر مباشرة.
  • enable_registration: false: لا أحد يستطيع أن ينشئ حساباً من صفحة الدخول، والحسابات تنشأ بأمر من المدير أو من مزود الهوية، وهذا هو الأصل في سيرفر شركة.

ثم جمعنا كل شيء في ملف compose.yaml:

# Two federated Synapse homeservers (company.test and audit.test) and Element Web, all prefixed wr-chat-
name: wr-chat-matrix
services:
  hs1:
    image: matrixdotorg/synapse:v1.164.2
    container_name: wr-chat-hs1
    volumes: [ "wr-chat-hs1:/data" ]
    ports: [ "127.0.0.1:18008:8008" ]
    networks: { default: { aliases: [ company.test ] } }
  hs2:
    image: matrixdotorg/synapse:v1.164.2
    container_name: wr-chat-hs2
    volumes: [ "wr-chat-hs2:/data" ]
    ports: [ "127.0.0.1:18009:8008" ]
    networks: { default: { aliases: [ audit.test ] } }
  element:
    image: vectorim/element-web:v1.12.33
    container_name: wr-chat-element
    volumes: [ "./element-config.json:/app/config.json:ro" ]
    ports: [ "127.0.0.1:18080:80" ]
volumes:
  wr-chat-hs1: { external: true }
  wr-chat-hs2: { external: true }
networks:
  default: { name: wr-chat-net, external: true }

ولاحظ أننا لم ننشر المنفذ 8448 على الجهاز إطلاقاً، لأن السيرفرين يتكلمان داخل شبكة Docker فقط، ونشرنا 8008 على 127.0.0.1 فقط حتى لا يصل إليه أحد من الشبكة المحلية. وملف element-config.json يحدد السيرفر الافتراضي في صفحة الدخول:

{
  "default_server_config": {
    "m.homeserver": { "base_url": "http://localhost:18008", "server_name": "company.test" }
  },
  "disable_custom_urls": false,
  "disable_guests": true,
  "brand": "Element",
  "default_country_code": "SA",
  "show_labs_settings": false,
  "setting_defaults": { "UIFeature.feedback": false }
}

وجعلنا disable_custom_urls بقيمة false حتى يستطيع موظف المكتب أن يغير السيرفر في صفحة الدخول إلى سيرفره، أما في الإنتاج فكل مؤسسة تشغل Element خاصاً بها يشير إلى سيرفرها، أو يستخدم موظفوها تطبيق Element على الجوال ويكتبون اسم سيرفرهم. وبعد التشغيل أنشأنا ثلاثة حسابات بالأمر register_new_matrix_user الذي يأتي مع Synapse، ويستخدم السر registration_shared_secret الموجود في الملف حتى ينشئ الحساب دون أن يفتح التسجيل للعامة:

docker exec wr-chat-hs1 register_new_matrix_user -c /data/homeserver.yaml -u sara -p 'Lab-Sara-2026!' --no-admin http://localhost:8008
docker exec wr-chat-hs1 register_new_matrix_user -c /data/homeserver.yaml -u admin -p 'Lab-Admin-2026!' --admin http://localhost:8008
docker exec wr-chat-hs2 register_new_matrix_user -c /data/homeserver.yaml -u omar -p 'Lab-Omar-2026!' --no-admin http://localhost:8008
⚠️
إذا شغلت هذه الأوامر من Git Bash على Windows فسوف يظهر لك الخطأ can't open 'C:/Program Files/Git/data/homeserver.yaml'، وهذا ما حدث معنا في أول محاولة. والسبب أن Git Bash يحول أي معامل يبدأ بـ / إلى مسار داخل مجلد Git قبل أن يصل إلى Docker، والحل أن تضع export MSYS_NO_PATHCONV=1 قبل الأوامر، أو أن تشغلها من PowerShell أو Linux.

أول سؤال بين السيرفرين Federation API

قبل أي واجهة رسومية، سألنا سيرفر المكتب من داخل Container الشركة عن إصداره وعن مفتاحه، كما يفعل أي سيرفر Matrix قبل أن يثق بسيرفر آخر:

docker exec wr-chat-hs1 curl -sk https://audit.test:8448/_matrix/federation/v1/version
docker exec wr-chat-hs1 curl -sk https://audit.test:8448/_matrix/key/v2/server

والمخرج سوف يكون كما يلي:

{"server":{"name":"Synapse","version":"1.164.2"}}
{"old_verify_keys":{},"server_name":"audit.test","signatures":{"audit.test":{"ed25519:a_mVsU":"6C2FnGjUpn01nQdp6arGclbDT1n/Z6+8TrcGPgDAsz23RJ7Weg8DiPWy+SFVfiluGrKiAtj8EYfQO5oxN5/fBA"}},"valid_until_ts":1793986955719,"verify_keys":{"ed25519:a_mVsU":{"key":"dwxRgVkGOzKdKdnIwmmh0aoXR6xn8LIAofKebmHxMz0"}}}

في المخرج أعلاه لاحظ التالي:

  • السطر الأول يثبت أن المنفذ 8448 يعمل وأن TLS يعمل، فالخيار -k في curl يتجاهل أن الشهادة ذاتية التوقيع، تماماً كما يفعل Synapse بعد الإعداد الذي غيرناه.
  • الحقل verify_keys هو المفتاح العام لسيرفر المكتب من نوع ed25519، ومعرفه a_mVsU، وهذا المفتاح هو الذي يوقع به سيرفر المكتب كل حدث يرسله إلى أي سيرفر آخر.
  • الحقل signatures توقيع السيرفر على هذا الرد نفسه بالمفتاح نفسه، فيستطيع سيرفر الشركة أن يتحقق أن الرد لم يتغير في الطريق.
  • الحقل valid_until_ts وقت انتهاء صلاحية هذا الرد بالميلي ثانية، وبعده يجب أن يسأل سيرفر الشركة من جديد. وهذا يعني أن ملف المفتاح audit.test.signing.key في Volume السيرفر هو هوية المؤسسة في شبكة Matrix، فإذا ضاع وأنشأت مفتاحاً جديداً سوف تحتاج السيرفرات الأخرى وقتاً حتى تقبله، لذلك يجب أن يدخل في النسخة الاحتياطية Backup مع قاعدة البيانات.

المشكلة الأولى: السيرفر يرفض العنوان الداخلي ip_range_blacklist

بعد أن عمل السؤال من curl، دخلت sara في Element وبدأت محادثة مع @omar:audit.test، فلم يظهر اسم عمر، وعرض Element نافذة تقول إنه جهة اتصال جديدة دون أي معلومات. وعندما نظرنا في سجلات Logs سيرفر الشركة وجدنا ما يلي:

2026-11-05 17:46:34,053 - synapse.http.federation.well_known_resolver - 282 - INFO - GET-212 - Fetching https://audit.test/.well-known/matrix/server
2026-11-05 17:46:34,058 - synapse.http.client - 219 - INFO - sentinel - Blocked 172.18.0.2 from DNS resolution to audit.test
2026-11-05 17:46:34,059 - synapse.http.federation.well_known_resolver - 313 - INFO - GET-212 - Error fetching https://audit.test/.well-known/matrix/server: DNS lookup failed: no results for hostname lookup: audit.test.
2026-11-05 17:46:34,751 - synapse.http.client - 219 - INFO - sentinel - Blocked 172.18.0.2 from DNS resolution to audit.test
2026-11-05 17:46:34,751 - synapse.http.federation.matrix_federation_agent - 402 - INFO - GET-212 - Failed to connect to audit.test:8448: DNS lookup failed: no results for hostname lookup: audit.test.
2026-11-05 17:46:34,752 - synapse.http.server - 132 - INFO - GET-212 - <XForwardedForRequest ... uri='/_matrix/client/v3/profile/%40omar2%3Aaudit.test' ...> SynapseError: 502 - Failed to fetch profile

والسطر المهم هو الثاني: Blocked 172.18.0.2 from DNS resolution to audit.test. أي أن DNS أعطى العنوان الصحيح، ولكن Synapse رفض أن يستخدمه، ثم كتب في السطر التالي أن البحث فشل وكأن الاسم غير موجود، وهذا مضلل لمن يقرأ السطر الأخير فقط. والسبب أن Synapse يمنع افتراضياً أي طلب خارج منه إلى العناوين الخاصة Private IP Ranges، ويذكر التوثيق أن الإعداد ip_range_blacklist يشمل افتراضياً 10.0.0.0/8 و172.16.0.0/12 و192.168.0.0/16 و127.0.0.0/8 وغيرها، وأن هذا يطبق على الاتحاد وعلى سيرفرات الهوية والإشعارات. وهذا المنع حماية مهمة وليس خطأ، فبدونه يستطيع أي شخص على الإنترنت أن يسجل نطاقاً يشير إلى 10.0.0.5، ثم يجعل سيرفرك يرسل طلبات إلى سيرفرات شبكتك الداخلية، وهذا الهجوم يسمى SSRF (Server-Side Request Forgery).

والحل في المختبر أن نسمح بشبكة Docker وحدها، وهنا ظهرت المشكلة الثانية: في الكود والتوثيق الجديد ترى كلمتي blocklist وallowlist، فكتبنا ip_range_allowlist وأعدنا التشغيل، وظهر الخطأ نفسه تماماً. وعندما بحثنا في كود Synapse 1.164.2 داخل Container وجدنا أن المتغير الداخلي اسمه ip_range_allowlist، ولكن المفتاح الذي يقرؤه من الملف ما زال ip_range_whitelist:

722:        self.ip_range_allowlist = generate_ip_set(
723:            config.get("ip_range_whitelist", ()), config_path=("ip_range_whitelist",)

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

# Second patch, after the first federation attempt was blocked:
# Synapse refuses outbound requests to private ranges (172.16.0.0/12 included); allow the lab network only.
if len(sys.argv) > 2:
    c = yaml.safe_load(open(p))
    c.pop('ip_range_allowlist', None)            # not read by Synapse 1.164: the key is still ip_range_whitelist
    c['ip_range_whitelist'] = [sys.argv[2]]
    yaml.safe_dump(c, open(p, 'w'), sort_keys=False)
    print('allowlisted', sys.argv[2])

وبعد إعادة التشغيل رجع اسم عمر من سيرفر المكتب في أقل من ثانية: {"displayname":"omar2"} للحساب التجريبي الذي استخدمناه وقتها. والدرس الأول أن Synapse لا يعطيك خطأ عندما تكتب مفتاحاً لا يعرفه في homeserver.yaml، وإنما يتجاهله بصمت، لذلك عندما لا يغير الإعداد شيئاً فتحقق من اسمه في توثيق الإعدادات لإصدارك قبل أن تبحث عن سبب آخر. والدرس الثاني أنك في الإنتاج لن تحتاج هذا الإعداد غالباً، لأن السيرفرات الأخرى على عناوين عامة، أما إذا كان سيرفر الشريك على شبكة خاصة بينكما عبر VPN فهذا هو الإعداد الذي سوف تحتاجه، وحدد فيه الشبكة الصغيرة بعينها ولا تفتح 10.0.0.0/8 كلها.

محادثة مشفرة بين المؤسستين في Element

شغلنا Element في متصفحين منفصلين بلا واجهة Headless Chrome، كل واحد بملف تعريف Profile خاص، ودخلت sara من سيرفر الشركة، ودخل omar بعد أن غير السيرفر في صفحة الدخول إلى http://localhost:18009. وأول ما يعرضه Element بعد الدخول نافذة صغيرة عنوانها «Back up your chats» تطلب إنشاء مفتاح استرداد Recovery Key، وسوف نرجع إليها لأنها أهم نافذة في Element ويتجاهلها أغلب الناس. ثم ضغطت sara على «Start chat» وكتبت عنوان عمر الكامل، وأرسلت الرسالة الأولى:

Element Web عند sara: محادثة مباشرة مع omar، وصندوق Encryption enabled يقول إن الرسائل مشفرة من طرف إلى طرف ويطلب التحقق من omar في ملفه، ورسالة sara الأولى بالعربية عن غرفة مراجعة الربع الرابع، وsara invited omar
المحادثة المباشرة في Element مشفرة افتراضياً، والدعوة وصلت إلى سيرفر المكتب

ولاحظ في الصورة ثلاثة أشياء: الصندوق «Encryption enabled» يقول إن المحادثة مشفرة من طرف إلى طرف دون أن تطلب sara ذلك، لأن Element يفعل التشفير افتراضياً في المحادثات المباشرة والغرف الخاصة، والحدث sara invited omar يعني أن سيرفر الشركة أرسل الدعوة إلى سيرفر المكتب ووقعها، والصندوق نفسه يقول «Verify omar in their profile»، أي أن Element يعرف أن التشفير دون تحقق نصف الحماية فقط. وعند عمر ظهرت الدعوة في قسم «Invites»:

Element Web عند omar على audit.test: قسم Invites فيه sara، والسؤال Do you want to chat with sara، وsara wants to chat من @sara:company.test، وأزرار Start chatting وDecline وDecline and block
الدعوة عند عمر على سيرفر المكتب، وفيها العنوان الكامل لـ sara مع اسم سيرفرها

وهنا يظهر الفرق الذي تحدثنا عنه في مقال المصطلحات: عمر يرى @sara:company.test، أي أنه يعرف من أي مؤسسة جاءت الدعوة من اسم السيرفر نفسه، ويستطيع أن يرفضها أو يرفضها ويحظر المرسل Decline and block. وبعد أن ضغط «Start chatting» ورد برسالة، أصبحت الغرفة موجودة على السيرفرين، وكل رسالة فيها تمر بالطريق الذي تبينه الصورة التالية:

طريق الرسالة: Element عند sara يرسل PUT إلى /rooms/send في company.test، وcompany.test يرسل PUT إلى /federation/v1/send/{txn} في audit.test، وElement عند omar يستلمها عبر GET /sync. وتحتها ثلاث خطوات: مفتاح الغرفة Megolm Session Key ينشئه جهاز sara ويرسله لكل جهاز مشفراً بـ Olm كرسالة To-Device، والرسالة نفسها حدث m.room.encrypted بالخوارزمية m.megolm.v1.aes-sha2 ويوقعه سيرفر الشركة، وكل سيرفر يحفظ نسخة كاملة ويعيد المحاولة إذا كان الآخر متوقفاً
السيرفران ينقلان ويحفظان ويوقعان، والمفتاح الذي يفك الرسالة لا يمر إلا مشفراً بين الأجهزة

والتفصيل الذي يجب أن تفهمه من الصورة أن هناك نوعين من الرسائل يمران بين السيرفرين: أحداث الغرفة Room Events التي تحفظ في الغرفة ويراها كل أعضائها، ورسائل جهاز إلى جهاز To-Device التي لا تحفظ في الغرفة، وإنما تسلم لجهاز محدد ثم تحذف. ومفتاح جلسة Megolm الذي شرحناه في مقال المصطلحات يمر بالنوع الثاني، مشفراً بقناة Olm بين جهاز sara وجهاز omar، والرسائل نفسها تمر بالنوع الأول مشفرة بمفتاح الجلسة. لذلك عندما يدخل عضو جديد إلى غرفة مشفرة، فإنه لا يستطيع أن يقرأ الرسائل القديمة إلا إذا أرسل له أحد الأعضاء مفاتيح الجلسات القديمة، وهذا قرار يتحكم فيه إعداد رؤية التاريخ في الغرفة.

التحقق برموز Emoji: SAS Verification

في مقال المصطلحات رأينا أن السيرفر الذي يتحكم في توزيع المفاتيح يستطيع أن يبدل مفتاح أحد الطرفين بمفتاحه، وأن الذي يكشف ذلك مقارنة خارج السيرفر. وفي Element تبدأ المقارنة من ملف الشخص: ضغطت sara على صورة عمر في المحادثة، ثم «Verify User»، ثم «Start Verification»، فظهر عند عمر طلب «Verification requested» قبله، ثم اختارت sara «Verify by emoji»، فظهر على الجهازين سبعة رموز:

لوحتا التحقق جنباً إلى جنب: على اليسار عند omar وعلى اليمين عند sara، والرموز السبعة نفسها على الجهازين: Mushroom وPenguin وRocket وGift وCake وFlower وUmbrella، مع زري They match وThey don't match
الرموز السبعة نفسها على جهاز omar (يسار) وجهاز sara (يمين)، وكل طرف يؤكد أنها متطابقة

وما يحدث خلف هذه الرموز يسمى في المعيار التحقق بسلسلة قصيرة SAS (Short Authentication String)، وهو قريب جداً مما فعلناه بـ openssl في مقال المصطلحات، مع خطوات إضافية تجعله آمناً. فكل جهاز ينشئ مفتاحاً مؤقتاً، ويتبادلان المفتاحين، ويحسبان سراً مشتركاً بخوارزمية curve25519-hkdf-sha256، ثم يأخذان من هذا السر عدداً صغيراً من البتات ويعرضانه كسبعة رموز Emoji من قائمة ثابتة في المعيار. فإذا كان السيرفر قد بدل أحد المفتاحين لاختلف السر عند الطرفين، ولاختلفت الرموز. وبعد أن يضغط الطرفان «They match»، يوقع كل منهما مفتاح الآخر بمفتاحه الخاص بالتوقيع المتبادل Cross-Signing، فيصبح عمر «موثقاً» عند sara، وتصبح كل أجهزة عمر التي يوثقها هو بنفسه لاحقاً موثقة عندها تلقائياً:

Element عند sara بعد التحقق: علامة خضراء بجانب اسم omar في رأس المحادثة، ولوحة تقول You've successfully verified omar مع درع أخضر، وزر Got it
بعد التحقق تظهر علامة خضراء بجانب اسم omar، وتبقى ما دام لم يغير مفاتيح هويته

وقد يتساءل البعض: هل يجب أن يتحقق كل موظف في الشركة من كل موظف في المكتب؟ والإجابة أن هذا هو المثالي ولكنه غير عملي في غرفة فيها عشرون شخصاً، لذلك فالمعقول أن يتحقق الأشخاص الذين يتبادلون معلومات حساسة فعلاً، مثل مسؤول المالية في الشركة ومدير المراجعة في المكتب، وأن يكون ذلك في اجتماع وجهاً لوجه أو في مكالمة فيديو يرى فيها كل منهما الآخر، لأن مقارنة الرموز عبر رسالة في المحادثة نفسها لا معنى لها، فالرسالة تمر عبر السيرفر الذي نريد أن نتحقق منه.

ماذا وجدنا في قاعدة البيانات؟ Metadata

بعد ثلاث رسائل وتحقق كامل، كتبنا سكربتاً صغيراً يفتح قاعدة بيانات SQLite في كل سيرفر، ويعد الأحداث في الغرفة بحسب نوعها، ويعرض آخر رسالة مشفرة كما هي محفوظة، ثم يبحث عن نص عربي من الرسائل في ملفات قاعدة البيانات نفسها:

# What each homeserver stores for the shared room: event types, and the content of the last encrypted message
import sqlite3, json, sys
db = sqlite3.connect('/data/homeserver.db')
room = db.execute("select room_id from rooms order by rowid desc limit 1").fetchone()[0]
print('room:', room)
for t, n in db.execute("select type, count(*) from events where room_id=? group by type order by 2 desc", (room,)):
    print(f'  {n:3}  {t}')
ev = db.execute("select e.event_id, j.json from events e join event_json j using(event_id) where e.room_id=? and e.type='m.room.encrypted' order by e.stream_ordering desc limit 1", (room,)).fetchone()
c = json.loads(ev[1])
print('last encrypted event from', c['sender'], 'origin_server_ts', c['origin_server_ts'])
print(json.dumps({k: (v[:60] + '...' if isinstance(v, str) and len(v) > 60 else v) for k, v in c['content'].items()}, indent=1))
print('plaintext found in database file:', 'كشف الحساب'.encode() in open('/data/homeserver.db', 'rb').read())

وشغلناه على السيرفرين بالأمر docker exec -i wr-chat-hs1 python - < db.py ثم على wr-chat-hs2، والمخرج على سيرفر الشركة:

room: !Z3WgxgddiZeDH2ngyWPMLQ15yZjY8flPdWZh12SBMw8
    3  m.room.member
    3  m.room.encrypted
    2  m.key.verification.mac
    2  m.key.verification.key
    2  m.key.verification.done
    1  m.room.power_levels
    1  m.room.message
    1  m.room.join_rules
    1  m.room.history_visibility
    1  m.room.guest_access
    1  m.room.encryption
    1  m.room.create
    1  m.key.verification.start
    1  m.key.verification.ready
    1  m.key.verification.accept
last encrypted event from @sara:company.test origin_server_ts 1793902099257
{
 "algorithm": "m.megolm.v1.aes-sha2",
 "ciphertext": "AwgBEuABZc84eBXfE3Z4nDYtVqrllzIzzu1B6T9+V4cregRPjyGjnTX2p98+...",
 "device_id": "YIDOBOBEIA",
 "sender_key": "7+X7mO/yp6dJOyrw++fM81Y/+8OiQZuQh10tdbGf8CQ",
 "session_id": "j+y9uJX6bfmHRxQxjlc+dS7Tx4XaIncFYs6jK7tm63g"
}
plaintext found in database file: False

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

  • الرسائل الثلاث التي كتبناها محفوظة كأحداث m.room.encrypted، والحقل algorithm يقول إنها مشفرة بـ Megolm، والحقل ciphertext هو النص المشفر، والحقل session_id يحدد أي مفتاح جلسة يفكها، وهذا المفتاح غير موجود في أي مكان على السيرفر.
  • بحثنا عن عبارة «كشف الحساب» التي كتبها عمر في كل ملفات قاعدة البيانات، أي homeserver.db وملفي -wal و-shm اللذين تكتب فيهما SQLite التغييرات قبل دمجها، ولم نجدها على أي من السيرفرين.
  • ولكن هناك 22 حدثاً آخر في الغرفة غير مشفرة: من دخل الغرفة ومتى m.room.member، ومن أنشأها m.room.create، وأنها مشفرة أصلاً m.room.encryption، وكل خطوات التحقق m.key.verification.*، وكل حدث مشفر يحمل بجانب النص المشفر اسم المرسل sender ووقت الإرسال origin_server_ts ومعرف الجهاز device_id.

والحدث الوحيد من نوع m.room.message لم يكن رسالة من أحدنا، وإنما طلب التحقق نفسه، وهذا جزء من محتواه كما وجدناه في قاعدة البيانات:

m.room.message -> {"body": "@sara:company.test is requesting to verify your key, but your client does not support in-chat key verification. You will need to use legacy key verification to verify keys.", "from_device": "YIDOBOBEIA", "methods": ["m.sas.v1", "m.qr_code.show.v1", "m.reciprocate.v1"], "msgtype": "m.key.ve
m.key.verification.start -> {"from_device": "YIDOBOBEIA", "hashes": ["sha256"], "key_agreement_protocols": ["curve25519-hkdf-sha256"], ...
files: ['homeserver.db', 'homeserver.db-shm', 'homeserver.db-wal']
plaintext in any db file: False

والنص في الحقل body رسالة احتياطية لعميل قديم لا يفهم التحقق داخل المحادثة، والحقل methods يعرض طرق التحقق التي يدعمها Element: الرموز m.sas.v1 ورمز QR. والصورة التالية تلخص ما وجدناه:

عمودان: مشفر لا يقرؤه السيرفر فيه 3 أحداث m.room.encrypted بنص مشفر وخوارزمية m.megolm.v1.aes-sha2 والبحث عن كشف الحساب أعطى False على السيرفرين، وواضح يراه السيرفر فيه m.room.member وm.room.create وm.room.encryption وm.room.message لطلب التحقق و8 أحداث m.key.verification والمرسل والوقت والجهاز والجلسة
الرسائل نفسها مشفرة على السيرفرين، أما من كلم من ومتى فمعروف لكل سيرفر في الغرفة

وهذه هي الحدود الحقيقية للتشفير من طرف إلى طرف في Matrix، ويجب أن تقولها لإدارة الشركة بوضوح قبل أن تعدهم بشيء: مدير سيرفر الشركة ومدير سيرفر المكتب لا يستطيعان أن يقرآ ما كتب في الغرفة، ولكنهما يعرفان أن sara وomar تكلما، ومتى، وكم رسالة، ومن أي جهاز، وهذه البيانات الوصفية Metadata قد تكون حساسة وحدها، فرسائل كثيرة بين المالية والمكتب في ليلة إغلاق الربع تقول شيئاً حتى دون محتواها.

تسجيل دخول ثان: Confirm your digital identity

أثناء بناء المختبر أغلقنا متصفح sara ودخلنا بحسابها مرة ثانية من متصفح جديد، فلم تظهر المحادثات، وإنما ظهرت هذه الشاشة:

شاشة Element بعنوان Confirm your digital identity: Choose how to verify to set up secure messaging، مع خيارين Use another device وUse recovery key، والرسالة This option is not available because you have not set up a recovery key، ورابط Can't confirm وزر Sign out
الجهاز الجديد يجب أن يثبت أنه لصاحب الحساب قبل أن يرى المحادثات المشفرة

والسبب أن Element أنشأ لـ sara في أول دخول مفاتيح هوية للتوقيع المتبادل Cross-Signing، والجهاز الجديد بالنسبة للآخرين جهاز غريب حتى يثبت أنه لـ sara نفسها، وطريقتا الإثبات أن توافق من جهاز قديم ما زال يعمل، أو أن تكتب مفتاح الاسترداد Recovery Key. وفي حالتنا كان الجهاز القديم قد أغلق، ولم ننشئ مفتاح استرداد لأننا ضغطنا «Not now» على نافذة «Back up your chats» في أول دخول، فظهر تحت الخيار الثاني «This option is not available because you have not set up a recovery key»، ولم يبق إلا «Can't confirm?» الذي يعيد إنشاء هوية جديدة، وعندها تفقد الرسائل المشفرة القديمة على هذا الجهاز، ويرى كل من تحقق من sara سابقاً تحذيراً بأن هويتها تغيرت.

وهذه ليست مشكلة مختبر، وإنما أكثر مشكلة سوف يواجهها فريق الدعم في الشركة بعد الانتقال إلى Matrix: موظف يغير هاتفه، أو يمسح المتصفح، أو يفقد جهازه الوحيد، ولم يحفظ مفتاح الاسترداد. وتذكر أن مدير السيرفر لا يستطيع أن يساعده، لأن المفتاح ليس على السيرفر أصلاً، وهذا بالضبط ما حدث لمستخدمي matrix.org في 2019 عندما سجل الفريق خروج الجميع بعد الاختراق، كما ذكرنا في مقال المصطلحات. لذلك اجعل إنشاء مفتاح الاسترداد خطوة إلزامية في أول يوم للموظف، واطلب منه أن يحفظه في مدير كلمات المرور Password Manager الخاص بالشركة.

حد محاولات الدخول M_LIMIT_EXCEEDED

ومشكلة ثالثة ظهرت لنا لأننا كررنا الدخول كثيراً أثناء كتابة سكربت المتصفح: بعد عدة محاولات دخول من العنوان نفسه خلال دقائق، عرض Element تحت عنوان «Sign in» الرسالة «Something went wrong. Please try again later. (M_LIMIT_EXCEEDED)». والسبب الإعداد rc_login في Synapse، وقيمته الافتراضية بحسب التوثيق per_second: 0.003 مع burst_count: 5 لكل عنوان IP ولكل حساب، أي خمس محاولات متتالية ثم محاولة واحدة كل خمس دقائق ونصف تقريباً. وهذا الحد يحميك من تخمين كلمات المرور، ولكن انتبه إلى أنه يحسب بعنوان IP، فإذا كان كل موظفي الشركة يخرجون إلى الإنترنت من عنوان واحد عبر NAT، أو كان الـ Reverse Proxy لا يمرر عنوان المستخدم الحقيقي، فسوف يرى السيرفر الشركة كلها كأنها عنوان واحد، ويحظر الدخول صباح يوم الأحد عندما يفتح الجميع أجهزتهم. وفي المختبر رفعنا الحد بجزء ثالث في سكربت الإعداد، أما في الإنتاج فلا ترفعه، وإنما تأكد أن x_forwarded: true مفعل في المستمع وأن الـ Reverse Proxy يرسل العنوان الحقيقي.

ماذا لو توقف سيرفر مكتب التدقيق؟ What If

في الاتحاد كل مؤسسة تدير سيرفرها، وهذا يعني أن سيرفر المكتب سوف يتوقف يوماً ما لتحديث أو عطل، والسؤال الذي يسأله مدير الشركة: ماذا يحدث لرسائلنا في ذلك الوقت؟ فجربنا ذلك: أوقفنا Container المكتب بالأمر docker stop wr-chat-hs2، ثم أرسلت sara رسالة «أرسلنا كشف الحساب، وسيرفركم متوقف الآن»، ثم انتظرنا 15 ثانية، ثم شغلنا السيرفر من جديد، وجعلنا السكربت يسأل متصفح عمر كل ثانيتين هل ظهرت الرسالة. والمخرج من سكربت التجربة:

stop hs2: wr-chat-hs2
start hs2: wr-chat-hs2
message visible on omar side after restart: true 16.5 s

وفي أثناء التوقف كتب سيرفر الشركة في سجلاته محاولاته لتسليم الرسالة:

2026-11-05 18:07:03,043 - synapse.http.federation.well_known_resolver - 313 - INFO - GET-81 - Error fetching https://audit.test/.well-known/matrix/server: Connection was refused by other side: 111: Connection refused.
2026-11-05 18:08:19,230 - synapse.http.federation.matrix_federation_agent - 402 - INFO - federation_transaction_transmission_loop-11 - Failed to connect to audit.test:8448: DNS lookup failed: no results for hostname lookup: audit.test.
2026-11-05 18:08:19,231 - synapse.http.matrixfederationclient - 838 - INFO - federation_transaction_transmission_loop-11 - {PUT-O-23} [audit.test] Request failed: PUT matrix-federation://audit.test/_matrix/federation/v1/send/1793901964169: DNSLookupError('no results for hostname lookup: audit.test')
2026-11-05 18:08:24,678 - synapse.http.federation.matrix_federation_agent - 402 - INFO - federation_transaction_transmission_loop-11 - Failed to connect to audit.test:8448: DNS lookup failed: no results for hostname lookup: audit.test.
2026-11-05 18:08:24,678 - synapse.http.matrixfederationclient - 838 - INFO - federation_transaction_transmission_loop-11 - {PUT-O-23} [audit.test] Request failed: PUT matrix-federation://audit.test/_matrix/federation/v1/send/1793901964169: DNSLookupError('no results for hostname lookup: audit.test')
Element عند omar بعد رجوع سيرفر المكتب: الرسالة أرسلنا كشف الحساب، وسيرفركم متوقف الآن ظاهرة في آخر المحادثة مع الوقت 21:08، وعلامة التحقق الخضراء بجانب اسم sara
الرسالة التي أرسلت أثناء توقف سيرفر المكتب وصلت إلى omar بعد 16.5 ثانية من تشغيله

في المخرج أعلاه لاحظ التالي:

  • عند sara لم يحدث شيء غريب: الرسالة أرسلت وحفظت في سيرفر الشركة وظهرت بعلامة الإرسال، لأن sara تتكلم مع سيرفرها فقط، وسيرفرها يعمل. وهذا فرق مهم عن الأدوات المركزية: عطل سيرفر الشريك لا يوقف عمل الشركة في الغرفة المشتركة، وإنما يؤخر وصول رسائلها إليه.
  • سيرفر الشركة يحمل الرسالة في عملية تسمى federation_transaction_transmission_loop، ويحاول أن يرسل المعاملة Transaction نفسها برقمها 1793901964169 عدة مرات، والمعاملة هي ما يجمع فيه Synapse الأحداث الذاهبة إلى سيرفر واحد.
  • رسالة الخطأ هنا DNSLookupError وليست رفض اتصال، والسبب أن Docker يحذف الاسم المستعار audit.test من DNS الداخلي عندما يتوقف Container. وفي الإنتاج سوف ترى غالباً Connection refused أو انتهاء المهلة Timeout، فلا تبحث عن مشكلة DNS عندما يكون السبب أن السيرفر متوقف.
  • بعد التشغيل ظهرت الرسالة عند عمر في 16.5 ثانية، وهذا الوقت يشمل تشغيل Synapse نفسه، وانتظار محاولة سيرفر الشركة التالية. وإذا طال التوقف ساعات فإن Synapse يباعد بين المحاولات Backoff، وقد يتأخر التسليم دقائق بعد الرجوع، ويستطيع السيرفر الراجع أن يطلب ما فاته بنفسه عندما يصله أي حدث جديد من الغرفة.

كم يأخذ هذا المختبر؟ Footprint

قسنا الذاكرة بعد انتهاء التجربة، وحجم ال Images، وحجم قاعدة البيانات في سيرفر الشركة:

NAME              CPU %     MEM USAGE / LIMIT
wr-chat-hs1       0.19%     186.5MiB / 31.29GiB
wr-chat-hs2       0.52%     153.6MiB / 31.29GiB
wr-chat-element   0.00%     7.559MiB / 31.29GiB
REPOSITORY:TAG                                                   SIZE
matrixdotorg/synapse:v1.164.2                                    475MB
vectorim/element-web:v1.12.33                                    325MB
2.2M	/data/homeserver.db
4.0M	/data/homeserver.db-wal

سيرفر Synapse بغرفة واحدة وثلاثة حسابات أخذ قرابة 186 ميغابايت من الذاكرة، وElement Web أقل من 8 ميغابايت لأنه nginx يقدم ملفات ثابتة فقط، والعمل الحقيقي في المتصفح. ولا تأخذ هذه الأرقام كتقدير لسيرفر حقيقي، لأن الذاكرة في Synapse تكبر مع عدد الغرف وحجمها، وأكثر ما يستهلكها الانضمام إلى غرف كبيرة على سيرفرات أخرى فيها آلاف الأعضاء، لأن سيرفرك يجب أن يحمل حالة الغرفة State كاملة. وسوف نقيس هذه الأرقام على الحالة نفسها للأدوات الأربع في مقال المقارنة.

ما الذي يتغير في الإنتاج؟ Production

المختبر تعمد أن يكون بسيطاً، والصورة التالية تجمع ما يجب أن تغيره قبل أن تضع الشركة عليه محادثة حقيقية مع المكتب:

سيرفرات أخرى تتصل عبر Reverse Proxy على 443 و8448 بشهادة Let's Encrypt مع ملف التفويض .well-known/matrix/server، ثم Synapse مع federation_domain_whitelist لـ audit.example فقط ومفتاح signing.key يجب حفظه، ثم PostgreSQL بدل SQLite مع نسخة احتياطية يومية، وأربعة صناديق: الدخول عبر MAS مع OIDC وenable_registration false، ومفتاح استرداد لكل موظف، والمراقبة عبر federationtester، والوسائط في media_store مع حد أعلى للحجم
النطاق والشهادة الحقيقية، وقاعدة PostgreSQL، وقائمة السيرفرات المسموحة، والدخول الموحد، وخطة لمفاتيح الموظفين
  • قاعدة البيانات Database: يقول دليل التثبيت صراحة إن SQLite مقبولة للتجربة فقط ولا يجب أن تستخدم في سيرفر إنتاج، وإن Synapse يعمل ببطء عليها خصوصاً في الغرف الكبيرة، لذلك استخدم PostgreSQL من البداية، وإذا بدأت بـ SQLite فهناك أداة synapse_port_db لنقلها.
  • النطاق والتفويض Delegation: اجعل عناوين الموظفين على النطاق الرئيسي @sara:company.example، وشغل السيرفر على matrix.company.example، وضع في النطاق الرئيسي ملف /.well-known/matrix/server يقول أين السيرفر، كما يشرح توثيق التفويض. ولا تغير اسم السيرفر بعد ذلك أبداً، لأن server_name جزء من كل معرف في قاعدة البيانات، وتغييره يعني سيرفراً جديداً.
  • الـ Reverse Proxy: يوصي الدليل بأن يكون أمام Synapse Reverse Proxy على المنفذين 443 و8448 يحمل الشهادة الحقيقية، وقد شرحنا ذلك مع Caddy وTraefik، وتأكد من النتيجة بأداة Federation Tester الرسمية.
  • قائمة السيرفرات المسموحة: الإعداد federation_domain_whitelist قيمته الافتراضية null، أي أن سيرفرك يتحد مع كل سيرفرات العالم، ويستطيع أي شخص في أي سيرفر أن يرسل دعوة لموظفيك. والشركة في حالتنا تحتاج مكتب التدقيق فقط، فاجعل القائمة [audit.example]، ويذكر التوثيق أن القائمة الفارغة [] توقف الاتحاد كله.
  • الدخول الموحد SSO: يدعم Synapse الدخول عبر OpenID Connect مباشرة، والاتجاه الجديد في Matrix هو خدمة Matrix Authentication Service التي تأتي مع حزمة ESS، وكلاهما يربطك بـ Keycloak أو authentik، فيدخل الموظف بحساب الشركة ويتوقف دخوله عندما يغادر.
  • الاحتفاظ Retention: يدعم Synapse سياسات الاحتفاظ بالرسائل على مستوى السيرفر والغرفة، ولكن تذكر أنها تحذف من سيرفرك فقط، والنسخة على سيرفر المكتب تحكمها سياسة المكتب.
  • النسخ الاحتياطي Backup: قاعدة البيانات، ومجلد الوسائط media_store، ومفتاح التوقيع signing.key. وتذكر أن النسخة الاحتياطية لا تحمل مفاتيح الرسائل المشفرة، فاستعادتها لا تعيد إلى موظف فقد مفتاحه رسائله.

من يستخدم Matrix في مؤسسات حقيقية؟ Real Case

أوضح مثال موثق على Matrix بين مؤسسات مستقلة هو نظام المحادثة في القطاع الصحي الألماني. فقد اشترطت gematik، وهي الجهة المسؤولة عن البنية الرقمية للرعاية الصحية في ألمانيا، أن يستخدم TI-Messenger البروتوكول المفتوح من Matrix.org Foundation، وتقول صفحتها إن هذا هو ما جعل التواصل بين تطبيقات من مزودين مختلفين ممكناً، فيستطيع الطبيب في عيادة أن يكلم الصيدلي أو المستشفى أو شركة التأمين، كل منهم على تطبيق ومزود مختلف. وتذكر الصفحة نفسها أن تطبيقات مبنية على Matrix تستخدمها جهات حكومية في فرنسا والجيش الألماني وأنظمة تعليم في بعض الولايات الألمانية، ومنها Tchap للموظفين الحكوميين في فرنسا. وما يجمع هذه الحالات هو ما يجمع حالتنا: مؤسسات كثيرة مستقلة، كل منها يريد أن يملك سيرفره وبياناته، وتحتاج أن تتكلم مع بعضها دون أن تكون كلها على خدمة شركة واحدة.

نقاط القوة ونقاط الضعف Strengths and Weaknesses

نقاط القوة:

  • اتحاد حقيقي ومفتوح: مكتب التدقيق يستطيع أن يشغل أي سيرفر Matrix وأي عميل، ولا يحتاج أن يستخدم الأداة نفسها التي اختارتها الشركة.
  • تشفير من طرف إلى طرف افتراضي في المحادثات الخاصة، مع تحقق برموز Emoji وتوقيع متبادل، وقد رأينا أن الرسائل لا توجد كنص في قاعدة بيانات أي من السيرفرين.
  • الغرفة تبقى تعمل عند الشركة عندما يتوقف سيرفر الشريك، والرسائل تصله عندما يرجع.
  • معيار مكتوب ومستقل عن أي شركة، وجسور Bridges إلى شبكات أخرى، وتطبيقات لكل منصة.

نقاط الضعف:

  • إدارة المفاتيح عبء على الموظفين وعلى الدعم: جهاز جديد دون مفتاح استرداد يعني تاريخاً مشفراً مفقوداً، ومدير السيرفر لا يستطيع أن يساعد.
  • البيانات الوصفية معروفة لكل سيرفر في الغرفة، ورسائلك في غرفة متحدة تحفظ عند الطرف الآخر وتحكمها سياسته.
  • Synapse أثقل من بدائله وتكبر ذاكرته مع الغرف الكبيرة، وحزمة ESS Community المجانية تقول صفحتها إنها ليست للإنتاج التجاري.
  • تجربة الفريق اليومية، مثل البحث في الرسائل المشفرة والتكاملات والروبوتات، أضعف من أدوات الفرق المركزية، لأن السيرفر لا يرى المحتوى.
  • إعدادات كثيرة تفشل بصمت، مثل مفتاح غير معروف في homeserver.yaml، ورسائل أخطاء مضللة مثل «DNS lookup failed» عندما يكون السبب منع العنوان.

أخطاء شائعة Common Mistakes

  • ترك federation_domain_whitelist دون قيمة في سيرفر شركة تحتاج شريكاً واحداً، فيصبح موظفوها قابلين للدعوة من أي سيرفر.
  • نقل federation_verify_certificates: false من مختبر أو دليل إلى الإنتاج.
  • تشغيل الإنتاج على SQLite لأن المختبر عمل عليها.
  • إهمال نافذة «Back up your chats» وعدم إنشاء مفتاح استرداد، ثم اكتشاف المشكلة مع أول هاتف جديد.
  • مقارنة رموز التحقق عبر رسالة في المحادثة نفسها بدل لقاء أو مكالمة.
  • الاعتقاد أن التشفير يخفي من كلم من ومتى.
  • تغيير server_name بعد بدء الاستخدام، أو فقد signing.key لأنه لم يدخل النسخة الاحتياطية.
  • Reverse Proxy لا يمرر عنوان المستخدم الحقيقي، فيصطدم كل موظفي الشركة بحد rc_login في الصباح.
  • كتابة إعداد بالاسم الجديد الذي تراه في الكود أو في مقال، دون التحقق من الاسم في توثيق إصدارك.

قائمة تحقق قبل الإنتاج Checklist

البندكيف تتحقق
النطاق والتفويضFederation Tester يعرض النتيجة خضراء لاسم السيرفر
الشهادة حقيقية والتحقق مفعلfederation_verify_certificates غير موجود أو true
السيرفرات المسموحة فقطfederation_domain_whitelist فيه الشركاء بأسمائهم
PostgreSQLقسم database يستخدم psycopg2 وليس sqlite3
التسجيل مغلق والدخول من مزود الهويةenable_registration: false ومزود OIDC يعمل
مفتاح استرداد لكل موظفخطوة في يوم الموظف الأول، والمفتاح في مدير كلمات المرور
النسخة الاحتياطيةقاعدة البيانات وmedia_store وsigning.key، وتجربة استعادة على سيرفر آخر
العنوان الحقيقي للمستخدمx_forwarded: true والـ Reverse Proxy يرسل X-Forwarded-For
إجراء التحقق مع الشريكمن يتحقق من من، ومتى، وكيف يقارنان الرموز

إزالة التجربة Cleanup

حذفنا كل ما بدأ اسمه بـ wr-chat- من Containers وVolumes والشبكة، وأبقينا Image Synapse وElement لأن مقال المقارنة في آخر السلسلة يحتاجهما:

docker compose down
docker volume rm wr-chat-hs1 wr-chat-hs2 wr-chat-certs
docker network rm wr-chat-net

الخلاصة Summary

وصلنا لنهاية الموضوع، وأهم ما فيه:

  • Matrix معيار مفتوح يجعل الغرفة سلسلة من الأحداث الموقعة، يحفظها كل سيرفر فيه عضو منها، والعنوان يحمل اسم السيرفر مثل البريد.
  • شغلنا سيرفرين من Synapse 1.164.2 متحدين عبر TLS على المنفذ 8448، وأول ما منع الاتحاد أن Synapse يرفض العناوين الخاصة افتراضياً، والإعداد الصحيح في هذا الإصدار اسمه ip_range_whitelist وليس ip_range_allowlist.
  • المحادثة المباشرة في Element مشفرة افتراضياً، والتحقق برموز Emoji أظهر الرموز السبعة نفسها على الجهازين، ثم وضع علامة التحقق بجانب الاسم.
  • قاعدة بيانات السيرفرين تحمل الرسائل كنص مشفر بـ Megolm، ولم نجد نص الرسائل فيها، ولكنها تحمل من كلم من ومتى ومن أي جهاز، وكل خطوات التحقق.
  • جهاز جديد دون مفتاح استرداد لا يرى المحادثات المشفرة، وحد rc_login قد يحظر شركة كاملة خلف عنوان واحد.
  • عندما توقف سيرفر المكتب استمرت الشركة في العمل، ووصلت الرسالة إلى عمر بعد 16.5 ثانية من رجوع السيرفر.

وفي المقال التالي من السلسلة بإذن الله ننتقل إلى Rocket.Chat، فنرى كيف تجمع أداة واحدة محادثة الفريق مع محادثة العملاء من الموقع، ونتحقق من حدود نسختها المجانية من صفحاتها الرسمية. والمقالات المرتبطة بهذا المقال:

دليلمصطلحات المحادثة للمبتدئين، من Threads إلى E2EEقبل أن تختار بديلاً لـ Slack أو Teams، افهم ما تعنيه القنوات والخيوط والاتحاد والتشفير من طرف إلى طرف، وجرب بنفسك كيف يتفق جهازان على مفتاح عبر سيرفر لا يثقان به.دليلتثبيت Mattermost Team Edition مع PostgreSQL وترقيته بأمانمساحة محادثة لفريقك على سيرفرك مع Mattermost، تبقى فيها الرسائل والملفات كاملة، فلا يحذفها حد للرسائل ولا خطة مجانية.دليلالتشفير للمطورين: ماذا تستخدم ولماذا لا تخترع خوارزميتكأي هاش تستخدم لكلمات المرور، ومتى تحتاج التشفير المتماثل أو غير المتماثل، وأين تحفظ المفاتيح بأمان في تطبيقك.دليلالشهادات الرقمية TLS للمبتدئين وصيغ ملفاتهاكيف يعرف المتصفح أنه يتحدث مع الموقع الحقيقي، وماذا يوجد داخل الشهادة، ولماذا تأتي ملفاتها بأكثر من صيغة.دليلتثبيت Keycloak مزود الهوية IdP الأشهر في المؤسساتنثبت Keycloak مع PostgreSQL، ونربط به تطبيقاً عبر OIDC، ونفرض المصادقة الثنائية على الجميع، ونقيس ما يحتاجه من ذاكرة.دليلتثبيت Caddy على خادمك: Reverse Proxy بشهادات HTTPS تلقائيةكيف تثبت Caddy على سيرفرك ليمنح كل موقع شهادة HTTPS تلقائياً، وتربط به تطبيقاتك بملف إعداد من بضعة أسطر.

سجل التحديثات Changelog

  • نوفمبر 2026: كتابة المقال وتنفيذ المختبر على Synapse 1.164.2 (matrixdotorg/synapse:v1.164.2) مع SQLite في سيرفرين متحدين، وElement Web 1.12.33 (vectorim/element-web:v1.12.33) في Headless Chrome، وشهادات OpenSSL 3.5.7 من debian:13-slim، على Docker Engine 29.8.0.
نشرة عرب رووت | ArabRoot

معرفة تستحق مكاناً في بريدك.

مقالات مختارة وأدوات مفيدة وأفكار لمشروعك القادم، في رسالة واحدة كل أسبوع.

يمكنك إلغاء الاشتراك متى شئت. الخصوصية

تم استلام طلبك. افتح بريدك واضغط رابط التأكيد لإتمام الاشتراك.