> ## Content Index
> Fetch the complete content index at: https://arabroot.io/llms.txt
> Use this file to discover other available public pages before exploring further.

# Matrix مع Element: محادثة مشفرة بين مؤسستين
- URL: https://arabroot.io/articles/matrix-مع-element-محادثة-مشفرة-بين-مؤسستين/
- Published: 2026-11-05T21:33:43.000Z
- Updated: 2026-11-05T22:32:41.000Z
- Description: شغلنا سيرفرين من Synapse متحدين في Docker، أحدهما للشركة والآخر لمكتب التدقيق، وفتحنا بينهما محادثة مشفرة تحققنا منها برموز Emoji، ثم فتشنا قاعدة بيانات كل سيرفر لنرى ما يعرفه.
- Author: فريق عرب رووت
- Tags: الأدلة التقنية, الاستضافة الذاتية والتطبيقات, تطبيقات لفريقك, الاستضافة الذاتية, Matrix

في [مقال مصطلحات المحادثة](https://arabroot.io/articles/%D9%85%D8%B5%D8%B7%D9%84%D8%AD%D8%A7%D8%AA-%D8%A7%D9%84%D9%85%D8%AD%D8%A7%D8%AF%D8%AB%D8%A9-%D9%84%D9%84%D9%85%D8%A8%D8%AA%D8%AF%D8%A6%D9%8A%D9%86-%D9%85%D9%86-threads-%D8%A7%D9%84%D9%89-e2ee/) رأينا أن الاتحاد Federation يجعل كل مؤسسة على سيرفرها مثل البريد، وأن التشفير من طرف إلى طرف E2EE يخفي الرسالة عن السيرفر نفسه، وأن التحقق من الأجهزة هو الذي يكشف السيرفر الذي يبدل المفاتيح. وفي هذا المقال ننتقل من الفكرة إلى سيرفرين حقيقيين: الشركة الناشئة التي نتابعها في السلسلة، وهي شركة فوترة إلكترونية فيها 45 موظفاً تترك Slack، تتعامل كل أسبوع مع مكتب تدقيق خارجي له فريقه وسيرفره، وكل ما بينهما اليوم يمر عبر قناة Slack Connect على سيرفر شركة ثالثة، أو عبر البريد بملفات مرفقة لا يعرف أحد أي نسخة منها هي الأخيرة.

والمطلوب واضح: غرفة مشتركة بين الشركة ومكتب التدقيق، كل طرف يدخلها من سيرفره وبحسابه، والرسائل فيها مشفرة بحيث لا يقرؤها مدير أي من السيرفرين، ولا تحتاج الشركة أن تنشئ لموظفي المكتب حسابات ضيف تتذكر أن توقفها عندما ينتهي العقد. وهذا بالضبط ما صمم له [Matrix](https://matrix.org/?ref=arabroot.io)، لذلك سوف نشغل في هذا المقال سيرفرين من Synapse داخل Docker، واحداً للشركة باسم `company.test` وآخر للمكتب باسم `audit.test`، ونجعلهما يتحدان فعلاً عبر TLS، ثم نفتح بينهما محادثة مشفرة من Element Web في متصفحين، ونتحقق من الطرف الآخر برموز Emoji، ثم ننظر في قاعدة بيانات كل سيرفر لنرى ما الذي يعرفه وما الذي لا يعرفه، ثم نوقف سيرفر المكتب ونرى ماذا يحدث لرسالة أرسلت في غيابه.

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

- [مصطلحات المحادثة للمبتدئين](https://arabroot.io/articles/%D9%85%D8%B5%D8%B7%D9%84%D8%AD%D8%A7%D8%AA-%D8%A7%D9%84%D9%85%D8%AD%D8%A7%D8%AF%D8%AB%D8%A9-%D9%84%D9%84%D9%85%D8%A8%D8%AA%D8%AF%D8%A6%D9%8A%D9%86-%D9%85%D9%86-threads-%D8%A7%D9%84%D9%89-e2ee/).
- Matrix مع Element: محادثة مشفرة بين مؤسستين (الموضوع الحالي).
- Rocket.Chat: محادثة الفريق مع العملاء والقنوات الخارجية.
- Zulip: محادثة منظمة بالمواضيع للفرق الكبيرة.
- اجتماعات الفيديو مع Jitsi Meet.
- مقارنة [Mattermost](https://arabroot.io/articles/%D8%AA%D8%AB%D8%A8%D9%8A%D8%AA-mattermost-%D9%88%D8%AA%D8%B1%D9%82%D9%8A%D8%AA%D9%87/) وRocket.Chat وZulip وMatrix على الحالة نفسها.

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

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

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

Matrix ليس برنامجاً، وإنما معيار مفتوح يصف كيف تتكلم البرامج مع بعضها، وتكتبه مؤسسة غير ربحية هي Matrix.org Foundation وتنشره في [موقع المواصفات](https://spec.matrix.org/latest/?ref=arabroot.io). وهذا المعيار يقسم العالم إلى ثلاثة أجزاء، ويحدد بين كل جزأين واجهة برمجية API منفصلة:

- العميل Client: البرنامج الذي يستخدمه الموظف، مثل Element على الويب والجوال وسطح المكتب، أو أي برنامج آخر يتبع المعيار. والعميل يتكلم مع سيرفر مؤسسته فقط عبر [واجهة العميل للسيرفر Client-Server API](https://spec.matrix.org/latest/client-server-api/?ref=arabroot.io)، وهي HTTP وJSON عادية.
- السيرفر الرئيسي Homeserver: السيرفر الذي يحمل حسابات مؤسستك ويحفظ الغرف التي فيها أحد من موظفيك، وأشهر برامجه Synapse.
- السيرفرات الأخرى: عندما يكون في الغرفة شخص من سيرفر آخر، يتكلم السيرفران عبر [واجهة السيرفر للسيرفر Server-Server API](https://spec.matrix.org/latest/server-server-api/?ref=arabroot.io)، ويوقع كل سيرفر ما يرسله بمفتاحه الخاص، فيتحقق الطرف الآخر أن الحدث جاء فعلاً من `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](https://github.com/element-hq/synapse?ref=arabroot.io): السيرفر المرجعي المكتوب بلغة Python، وهو الأقدم والأكثر اكتمالاً في دعم المعيار، وتطوره شركة Element. وقد نقلته Element في ديسمبر 2023 إلى [ترخيص AGPLv3](https://element.io/blog/synapse-now-lives-at-github-com-element-hq-synapse/?ref=arabroot.io) مع اتفاقية مساهمين CLA، وذكرت في الإعلان أن السبب أنها تكتب أغلب كوده ولم تصبح شركة رابحة بعد، فتريد من الجهات التجارية التي تبني عليه أن تنشر تعديلاتها أو تشتري استثناء من الترخيص. وبالنسبة لشركة تشغله لموظفيها دون أن تبيعه فهذا لا يغير شيئاً، والإصدار الذي جربناه هو [1.164.2](https://github.com/element-hq/synapse/releases/tag/v1.164.2?ref=arabroot.io) الصادر في 2 نوفمبر 2026.
- [Continuwuity](https://github.com/continuwuity/continuwuity?ref=arabroot.io): سيرفر مكتوب بلغة Rust، يأتي من سلسلة مشاريع بدأت بـ Conduit، ويعمل كملف تنفيذي واحد مع قاعدة بيانات مدمجة، فيأخذ ذاكرة أقل بكثير ولا يحتاج PostgreSQL. وهو مناسب لسيرفر صغير أو تجربة، ولكنه مشروع مجتمعي أصغر، ودعمه لبعض أجزاء المعيار يتأخر عن Synapse.
- [ESS Community](https://element.io/server-suite/community?ref=arabroot.io): حزمة من 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](https://github.com/element-hq/element-web/releases/tag/v1.12.33?ref=arabroot.io)، وهو موقع ثابت من 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](https://arabroot.io/content/images/2026/11/matrix-element-01-lab.webp)

كل سيرفر يملك حساباته ومفتاح توقيعه، ويتكلمان عبر المنفذ 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`:

```bash
# 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
```

والمخرج:

```text
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](https://arabroot.io/articles/%D8%A7%D9%84%D8%B4%D9%87%D8%A7%D8%AF%D8%A7%D8%AA-%D8%A7%D9%84%D8%B1%D9%82%D9%85%D9%8A%D8%A9-tls-%D9%88-x509-%D9%88%D8%B5%D9%8A%D8%BA-pem-%D9%88-der/).

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

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

```python
# 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` هو الإعداد الوحيد في المختبر الذي لا يجب أن تراه في الإنتاج أبداً، لأنه يجعل سيرفرك يقبل أي شهادة من أي سيرفر، ويذكر [توثيق الإعدادات](https://element-hq.github.io/synapse/latest/usage/configuration/config%5Fdocumentation.html?ref=arabroot.io) أن قيمته الافتراضية `true`. وقد احتجناه لأن شهاداتنا ذاتية التوقيع.
- `trusted_key_servers: []`: الملف الأصلي يجعل `matrix.org` سيرفراً موثوقاً يسأله سيرفرك عن مفاتيح السيرفرات الأخرى، وهذا مريح على الإنترنت، ولكنه يعني أن سيرفرك يخبر `matrix.org` بأسماء السيرفرات التي يتكلم معها. وفي المختبر لا يوجد إنترنت أصلاً، وفي شركة حساسة قد تفضل أن يأخذ سيرفرك المفاتيح من كل سيرفر مباشرة.
- `enable_registration: false`: لا أحد يستطيع أن ينشئ حساباً من صفحة الدخول، والحسابات تنشأ بأمر من المدير أو من مزود الهوية، وهذا هو الأصل في سيرفر شركة.

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

```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` يحدد السيرفر الافتراضي في صفحة الدخول:

```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` الموجود في الملف حتى ينشئ الحساب دون أن يفتح التسجيل للعامة:

```bash
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 قبل أن يثق بسيرفر آخر:

```bash
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
```

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

```text
{"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 سيرفر الشركة وجدنا ما يلي:

```text
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`:

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

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

```python
# 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`، وإنما يتجاهله بصمت، لذلك عندما لا يغير الإعداد شيئاً فتحقق من اسمه في [توثيق الإعدادات](https://element-hq.github.io/synapse/latest/usage/configuration/config%5Fdocumentation.html?ref=arabroot.io) لإصدارك قبل أن تبحث عن سبب آخر. والدرس الثاني أنك في الإنتاج لن تحتاج هذا الإعداد غالباً، لأن السيرفرات الأخرى على عناوين عامة، أما إذا كان سيرفر الشريك على شبكة خاصة بينكما عبر 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](https://arabroot.io/content/images/2026/11/matrix-element-04-first-message.webp)

المحادثة المباشرة في 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](https://arabroot.io/content/images/2026/11/matrix-element-03-invite.webp)

الدعوة عند عمر على سيرفر المكتب، وفيها العنوان الكامل لـ 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 ويوقعه سيرفر الشركة، وكل سيرفر يحفظ نسخة كاملة ويعيد المحاولة إذا كان الآخر متوقفاً](https://arabroot.io/content/images/2026/11/matrix-element-02-message-path.webp)

السيرفران ينقلان ويحفظان ويوقعان، والمفتاح الذي يفك الرسالة لا يمر إلا مشفراً بين الأجهزة

والتفصيل الذي يجب أن تفهمه من الصورة أن هناك نوعين من الرسائل يمران بين السيرفرين: أحداث الغرفة 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](https://arabroot.io/content/images/2026/11/matrix-element-05-emoji-both.webp)

الرموز السبعة نفسها على جهاز omar (يسار) وجهاز sara (يمين)، وكل طرف يؤكد أنها متطابقة

وما يحدث خلف هذه الرموز يسمى في المعيار [التحقق بسلسلة قصيرة SAS (Short Authentication String)](https://spec.matrix.org/latest/client-server-api/?ref=arabroot.io#short-authentication-string-sas-verification)، وهو قريب جداً مما فعلناه بـ openssl في مقال المصطلحات، مع خطوات إضافية تجعله آمناً. فكل جهاز ينشئ مفتاحاً مؤقتاً، ويتبادلان المفتاحين، ويحسبان سراً مشتركاً بخوارزمية `curve25519-hkdf-sha256`، ثم يأخذان من هذا السر عدداً صغيراً من البتات ويعرضانه كسبعة رموز Emoji من قائمة ثابتة في المعيار. فإذا كان السيرفر قد بدل أحد المفتاحين لاختلف السر عند الطرفين، ولاختلفت الرموز. وبعد أن يضغط الطرفان «They match»، يوقع كل منهما مفتاح الآخر بمفتاحه الخاص بالتوقيع المتبادل Cross-Signing، فيصبح عمر «موثقاً» عند sara، وتصبح كل أجهزة عمر التي يوثقها هو بنفسه لاحقاً موثقة عندها تلقائياً:

![Element عند sara بعد التحقق: علامة خضراء بجانب اسم omar في رأس المحادثة، ولوحة تقول You've successfully verified omar مع درع أخضر، وزر Got it](https://arabroot.io/content/images/2026/11/matrix-element-06-verified.webp)

بعد التحقق تظهر علامة خضراء بجانب اسم omar، وتبقى ما دام لم يغير مفاتيح هويته

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

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

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

```python
# 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`، والمخرج على سيرفر الشركة:

```text
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` لم يكن رسالة من أحدنا، وإنما طلب التحقق نفسه، وهذا جزء من محتواه كما وجدناه في قاعدة البيانات:

```text
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 والمرسل والوقت والجهاز والجلسة](https://arabroot.io/content/images/2026/11/matrix-element-08-what-server-sees.webp)

الرسائل نفسها مشفرة على السيرفرين، أما من كلم من ومتى فمعروف لكل سيرفر في الغرفة

وهذه هي الحدود الحقيقية للتشفير من طرف إلى طرف في 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](https://arabroot.io/content/images/2026/11/matrix-element-07-confirm-identity.webp)

الجهاز الجديد يجب أن يثبت أنه لصاحب الحساب قبل أن يرى المحادثات المشفرة

والسبب أن 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 ثانية، ثم شغلنا السيرفر من جديد، وجعلنا السكربت يسأل متصفح عمر كل ثانيتين هل ظهرت الرسالة. والمخرج من سكربت التجربة:

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

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

```text
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](https://arabroot.io/content/images/2026/11/matrix-element-09-catch-up.webp)

الرسالة التي أرسلت أثناء توقف سيرفر المكتب وصلت إلى 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، وحجم قاعدة البيانات في سيرفر الشركة:

```text
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 مع حد أعلى للحجم](https://arabroot.io/content/images/2026/11/matrix-element-10-production.webp)

النطاق والشهادة الحقيقية، وقاعدة PostgreSQL، وقائمة السيرفرات المسموحة، والدخول الموحد، وخطة لمفاتيح الموظفين

- قاعدة البيانات Database: يقول [دليل التثبيت](https://element-hq.github.io/synapse/latest/setup/installation.html?ref=arabroot.io) صراحة إن SQLite مقبولة للتجربة فقط ولا يجب أن تستخدم في سيرفر إنتاج، وإن Synapse يعمل ببطء عليها خصوصاً في الغرف الكبيرة، لذلك استخدم PostgreSQL من البداية، وإذا بدأت بـ SQLite فهناك أداة [synapse\_port\_db](https://element-hq.github.io/synapse/latest/postgres.html?ref=arabroot.io) لنقلها.
- النطاق والتفويض Delegation: اجعل عناوين الموظفين على النطاق الرئيسي `@sara:company.example`، وشغل السيرفر على `matrix.company.example`، وضع في النطاق الرئيسي ملف `/.well-known/matrix/server` يقول أين السيرفر، كما يشرح [توثيق التفويض](https://element-hq.github.io/synapse/latest/delegate.html?ref=arabroot.io). ولا تغير اسم السيرفر بعد ذلك أبداً، لأن `server_name` جزء من كل معرف في قاعدة البيانات، وتغييره يعني سيرفراً جديداً.
- الـ Reverse Proxy: يوصي الدليل بأن يكون أمام Synapse Reverse Proxy على المنفذين 443 و8448 يحمل الشهادة الحقيقية، وقد شرحنا ذلك مع [Caddy](https://arabroot.io/articles/%D8%AA%D8%AB%D8%A8%D9%8A%D8%AA-caddy-reverse-proxy/) و[Traefik](https://arabroot.io/articles/%D8%AA%D8%AB%D8%A8%D9%8A%D8%AA-traefik-reverse-proxy/)، وتأكد من النتيجة بأداة [Federation Tester](https://federationtester.matrix.org/?ref=arabroot.io) الرسمية.
- قائمة السيرفرات المسموحة: الإعداد `federation_domain_whitelist` قيمته الافتراضية `null`، أي أن سيرفرك يتحد مع كل سيرفرات العالم، ويستطيع أي شخص في أي سيرفر أن يرسل دعوة لموظفيك. والشركة في حالتنا تحتاج مكتب التدقيق فقط، فاجعل القائمة `[audit.example]`، ويذكر التوثيق أن القائمة الفارغة `[]` توقف الاتحاد كله.
- الدخول الموحد SSO: يدعم Synapse [الدخول عبر OpenID Connect](https://element-hq.github.io/synapse/latest/openid.html?ref=arabroot.io) مباشرة، والاتجاه الجديد في Matrix هو خدمة Matrix Authentication Service التي تأتي مع حزمة ESS، وكلاهما يربطك بـ [Keycloak](https://arabroot.io/articles/%D8%AA%D8%AB%D8%A8%D9%8A%D8%AA-keycloak-%D9%85%D8%B2%D9%88%D8%AF-%D8%A7%D9%84%D9%87%D9%88%D9%8A%D8%A9-%D9%84%D9%84%D9%85%D8%A4%D8%B3%D8%B3%D8%A7%D8%AA/) أو [authentik](https://arabroot.io/articles/%D8%AA%D8%AB%D8%A8%D9%8A%D8%AA-authentik-%D9%84%D9%84%D8%AF%D8%AE%D9%88%D9%84-%D8%A7%D9%84%D9%85%D9%88%D8%AD%D8%AF/)، فيدخل الموظف بحساب الشركة ويتوقف دخوله عندما يغادر.
- الاحتفاظ Retention: يدعم Synapse [سياسات الاحتفاظ بالرسائل](https://element-hq.github.io/synapse/latest/message%5Fretention%5Fpolicies.html?ref=arabroot.io) على مستوى السيرفر والغرفة، ولكن تذكر أنها تحذف من سيرفرك فقط، والنسخة على سيرفر المكتب تحكمها سياسة المكتب.
- النسخ الاحتياطي Backup: قاعدة البيانات، ومجلد الوسائط `media_store`، ومفتاح التوقيع `signing.key`. وتذكر أن النسخة الاحتياطية لا تحمل مفاتيح الرسائل المشفرة، فاستعادتها لا تعيد إلى موظف فقد مفتاحه رسائله.

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

أوضح مثال موثق على Matrix بين مؤسسات مستقلة هو نظام المحادثة في القطاع الصحي الألماني. فقد اشترطت gematik، وهي الجهة المسؤولة عن البنية الرقمية للرعاية الصحية في ألمانيا، أن يستخدم [TI-Messenger](https://www.gematik.de/anwendungen/ti-messenger?ref=arabroot.io) البروتوكول المفتوح من Matrix.org Foundation، وتقول صفحتها إن هذا هو ما جعل التواصل بين تطبيقات من مزودين مختلفين ممكناً، فيستطيع الطبيب في عيادة أن يكلم الصيدلي أو المستشفى أو شركة التأمين، كل منهم على تطبيق ومزود مختلف. وتذكر الصفحة نفسها أن تطبيقات مبنية على Matrix تستخدمها جهات حكومية في فرنسا والجيش الألماني وأنظمة تعليم في بعض الولايات الألمانية، ومنها [Tchap](https://www.tchap.gouv.fr/?ref=arabroot.io) للموظفين الحكوميين في فرنسا. وما يجمع هذه الحالات هو ما يجمع حالتنا: مؤسسات كثيرة مستقلة، كل منها يريد أن يملك سيرفره وبياناته، وتحتاج أن تتكلم مع بعضها دون أن تكون كلها على خدمة شركة واحدة.

## نقاط القوة ونقاط الضعف 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 لأن مقال المقارنة في آخر السلسلة يحتاجهما:

```bash
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، فنرى كيف تجمع أداة واحدة محادثة الفريق مع محادثة العملاء من الموقع، ونتحقق من حدود نسختها المجانية من صفحاتها الرسمية. والمقالات المرتبطة بهذا المقال:

[![](https://arabroot.io/content/images/2026/11/chat-terms-cover-cover.webp)دليلمصطلحات المحادثة للمبتدئين، من Threads إلى E2EEقبل أن تختار بديلاً لـ Slack أو Teams، افهم ما تعنيه القنوات والخيوط والاتحاد والتشفير من طرف إلى طرف، وجرب بنفسك كيف يتفق جهازان على مفتاح عبر سيرفر لا يثقان به.](https://arabroot.io/articles/%D9%85%D8%B5%D8%B7%D9%84%D8%AD%D8%A7%D8%AA-%D8%A7%D9%84%D9%85%D8%AD%D8%A7%D8%AF%D8%AB%D8%A9-%D9%84%D9%84%D9%85%D8%A8%D8%AA%D8%AF%D8%A6%D9%8A%D9%86-%D9%85%D9%86-threads-%D8%A7%D9%84%D9%89-e2ee/)[![](https://arabroot.io/content/images/2026/10/mattermost-cover-cover.webp)دليلتثبيت Mattermost Team Edition مع PostgreSQL وترقيته بأمانمساحة محادثة لفريقك على سيرفرك مع Mattermost، تبقى فيها الرسائل والملفات كاملة، فلا يحذفها حد للرسائل ولا خطة مجانية.](https://arabroot.io/articles/%D8%AA%D8%AB%D8%A8%D9%8A%D8%AA-mattermost-%D9%88%D8%AA%D8%B1%D9%82%D9%8A%D8%AA%D9%87/)[![](https://arabroot.io/content/images/2026/10/crypto-for-devs-cover-cover.webp)دليلالتشفير للمطورين: ماذا تستخدم ولماذا لا تخترع خوارزميتكأي هاش تستخدم لكلمات المرور، ومتى تحتاج التشفير المتماثل أو غير المتماثل، وأين تحفظ المفاتيح بأمان في تطبيقك.](https://arabroot.io/articles/%D8%A7%D9%84%D8%AA%D8%B4%D9%81%D9%8A%D8%B1-%D9%84%D9%84%D9%85%D8%B7%D9%88%D8%B1%D9%8A%D9%86-%D8%A7%D9%84%D9%87%D8%A7%D8%B4-%D9%88%D9%83%D9%84%D9%85%D8%A7%D8%AA-%D8%A7%D9%84%D9%85%D8%B1%D9%88%D8%B1-%D9%88%D8%A7%D9%84%D9%85%D9%81%D8%A7%D8%AA%D9%8A%D8%AD/)[![](https://arabroot.io/content/images/2026/10/certificates-cover-cover.webp)دليلالشهادات الرقمية TLS للمبتدئين وصيغ ملفاتهاكيف يعرف المتصفح أنه يتحدث مع الموقع الحقيقي، وماذا يوجد داخل الشهادة، ولماذا تأتي ملفاتها بأكثر من صيغة.](https://arabroot.io/articles/%D8%A7%D9%84%D8%B4%D9%87%D8%A7%D8%AF%D8%A7%D8%AA-%D8%A7%D9%84%D8%B1%D9%82%D9%85%D9%8A%D8%A9-tls-%D9%88-x509-%D9%88%D8%B5%D9%8A%D8%BA-pem-%D9%88-der/)[![](https://arabroot.io/content/images/2026/10/keycloak-cover-cover.webp)دليلتثبيت Keycloak مزود الهوية IdP الأشهر في المؤسساتنثبت Keycloak مع PostgreSQL، ونربط به تطبيقاً عبر OIDC، ونفرض المصادقة الثنائية على الجميع، ونقيس ما يحتاجه من ذاكرة.](https://arabroot.io/articles/%D8%AA%D8%AB%D8%A8%D9%8A%D8%AA-keycloak-%D9%85%D8%B2%D9%88%D8%AF-%D8%A7%D9%84%D9%87%D9%88%D9%8A%D8%A9-%D9%84%D9%84%D9%85%D8%A4%D8%B3%D8%B3%D8%A7%D8%AA/)[![](https://arabroot.io/content/images/2026/10/caddy-cover-cover.webp)دليلتثبيت Caddy على خادمك: Reverse Proxy بشهادات HTTPS تلقائيةكيف تثبت Caddy على سيرفرك ليمنح كل موقع شهادة HTTPS تلقائياً، وتربط به تطبيقاتك بملف إعداد من بضعة أسطر.](https://arabroot.io/articles/%D8%AA%D8%AB%D8%A8%D9%8A%D8%AA-caddy-reverse-proxy/)

## سجل التحديثات 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.