الهجرة من ‎Rocket.Chat‎ إلى ‎Mattermost‎ على خادم ‎VPS‎

ما الذي يتغيّر في ‎Rocket.Chat 9.0‎

لماذا ‎Mattermost Community‎ بديل موثوق

• ‎LDAP‎ و‎SAML‎ مضمّنان بلا ترخيص — يشمل ‎Mattermost‎ مصادقة ‎Active Directory‎ و‎SAML‎ في إصداره مفتوح المصدر، برخصة ‎MIT‎ للخادم و‎Apache 2.0‎ للمساهمات، دون أي اشتراط لخطة مدفوعة.
• ‎PostgreSQL‎ أصلي — يعتمد ‎Mattermost‎ على ‎PostgreSQL‎، موثَّق بشكل جيد وسهل النسخ الاحتياطي عبر ‎pg_dump‎ وأكثر شيوعاً من ‎MongoDB‎ في بيئات ‎Docker‎ المستضافة ذاتياً.
• ‎mmetl‎، أداة هجرة رسمية — تحوّل أداة ‎mmetl‎ من فريق ‎Mattermost‎ نتيجة ‎mongodump‎ من ‎Rocket.Chat‎ إلى ملف استيراد ‎JSONL‎ متوافق مع ‎mmctl import‎، يشمل القنوات والمستخدمين والرسائل.
• بصمة ذاكرة أخف — يمكن لـ‎Mattermost‎ البدء بـ‎2 GB‎ من الذاكرة لفرق أقل من خمسين مستخدماً؛ يتطلّب ‎Rocket.Chat‎ مجموعة نسخ ‎MongoDB‎ تستهلك موارد أكبر عند حجم مكافئ.
• تطبيقات رسمية لسطح المكتب والهاتف — تشير تطبيقات ‎iOS‎ و‎Android‎ و‎macOS‎ و‎Windows‎ إلى نطاقك الخاص فور التثبيت.
• سجل وملفات مرفقة بلا حدود — لا نافذة زمنية منزلقة، ولا قطع عند حجم رسائل معيّن، كل شيء مخزَّن على قرصك أو في ‎bucket S3‎ الخاص بك.

المتطلبات التقنية

نسخ ‎Rocket.Chat‎ احتياطياً

1. 01

   وضع ‎Rocket.Chat‎ في وضع القراءة فقط

   قبل أي نسخ احتياطي، أخطر مستخدميك وانقل النظام إلى وضع الصيانة. في إدارة ‎Rocket.Chat‎، انتقل إلى الإدارة ← عام ← وضع الصيانة وفعّل وضع القراءة فقط. يمنع هذا كتابة رسائل جديدة بعد التفريغ وضياعها عند التحويل.

   بدلاً من ذلك، إذا لم يتوفر هذا الوضع، أوقف حاوية ‎Rocket.Chat‎ ببساطة:

   docker compose stop rocketchat

2. 02

   تصدير قاعدة ‎MongoDB‎ باستخدام ‎mongodump‎

   تتوقع ‎mmetl‎ مجلداً منتجاً بواسطة ‎mongodump‎، لا ملفاً مضغوطاً. شغّل التفريغ من المضيف أو من داخل حاوية ‎MongoDB‎:

   # من المضيف إذا كان mongodump مثبَّتاً
   mongodump --uri="mongodb://localhost:27017/rocketchat" --out /tmp/rc-dump
   
   # أو من حاوية Docker
   docker exec <mongo-container> mongodump \
     --db rocketchat --out /dump
   docker cp <mongo-container>:/dump /tmp/rc-dump

   تحقّق من أن ‎/tmp/rc-dump/rocketchat/‎ يحتوي على ملفات ‎.bson‎ و‎.json‎ لمجموعات ‎rocketchat_message‎ و‎users‎ و‎rocketchat_room‎ وغيرها.

3. 03

   تصدير الملفات المرفقة (المرفوعات)

   الملفات المرفقة المخزّنة في ‎GridFS‎ أو نظام الملفات المحلي ليست جزءاً من تفريغ ‎MongoDB‎ — يجب نسخها بشكل منفصل.

   إذا كنت تستخدم التخزين المحلي (الخيار الافتراضي):

   docker cp <rocketchat-container>:/app/uploads /tmp/rc-uploads

   إذا كنت تستخدم ‎bucket S3‎ متوافقاً، سجّل معاملات الاتصال — ستعيد تهيئتها في ‎Mattermost‎. تُشير ‎mmetl‎ إلى الملفات المرفقة لكنها لا تنقلها.

4. 04

   تصدير المستخدمين عبر ‎REST API‎ (اختياري)

   للحصول على جرد بالحسابات قبل الهجرة، يسمح ‎API‎ الخاص بـ‎Rocket.Chat‎ بتصدير قائمة المستخدمين النشطين:

   curl -H "X-Auth-Token: <token>" \
        -H "X-User-Id: <admin-id>" \
        "https://chat.yourdomain.com/api/v1/users.list?count=200" \
     | python3 -c "import sys,json; [print(u['username'], u.get('emails',[{}])[0].get('address','')) for u in json.load(sys.stdin)['users']]"

   احتفظ بهذه القائمة للتحقق من أن جميع الحسابات أُنشئت بشكل صحيح في ‎Mattermost‎ بعد الاستيراد الجماعي.

تثبيت ‎Mattermost‎ على خادم ‎VPS‎

1. 05

   الحصول على إعداد ‎Docker Compose‎ الرسمي

   يُبقي فريق ‎Mattermost‎ على مستودع ‎docker‎ يحتوي إعداد ‎Compose‎ جاهزاً للاستخدام:

   git clone https://github.com/mattermost/docker /opt/mattermost
   cd /opt/mattermost
   cp env.example .env

   افتح ‎.env‎ وأدخل على الأقل:

   DOMAIN=chat.yourdomain.com
   MM_SERVICESETTINGS_SITEURL=https://chat.yourdomain.com
   POSTGRES_USER=mmuser
   POSTGRES_PASSWORD=<كلمة-مرور-قوية>
   POSTGRES_DB=mattermost

2. 06

   إنشاء الأحجام وتشغيل المجموعة

   أنشئ مجلدات الأحجام قبل التشغيل الأول:

   mkdir -p ./volumes/app/mattermost/{config,data,logs,plugins,client/plugins,bleve-indexes}
   sudo chown -R 2000:2000 ./volumes/app/mattermost

   شغّل المجموعة الكاملة (‎Mattermost‎ + ‎PostgreSQL‎ + ‎nginx‎ مع شهادة ‎Let's Encrypt‎ مدمجة):

   docker compose -f docker-compose.yml -f docker-compose.nginx.yml up -d

   انتظر حتى تصبح حاوية ‎Mattermost‎ في حالة ‎healthy‎ قبل المتابعة.

3. 07

   إنشاء حساب المشرف

   افتح ‎https://chat.yourdomain.com‎ في متصفحك. عند أول تسجيل دخول، يطلب ‎Mattermost‎ إنشاء حساب مشرف. أدخل البريد الإلكتروني واسم المستخدم وكلمة المرور للمشرف الأوّلي — سيكون هذا الحساب منفصلاً عن الحسابات المستوردة من ‎Rocket.Chat‎.

نقل السجل والمستخدمين باستخدام ‎mmetl‎

1. 08

   تثبيت ‎mmetl‎

   نزّل الملف الثنائي لـ‎mmetl v0.6.0‎ (صدر في 11 سبتمبر 2026) من إصدارات ‎GitHub‎:

   curl -L https://github.com/mattermost/mmetl/releases/download/v0.6.0/mmetl-linux-amd64 \
     -o /usr/local/bin/mmetl
   chmod +x /usr/local/bin/mmetl
   mmetl version

   تغيير جوهري في ‎v0.6.0‎: حُذفت الأمر الفرعي ‎mmetl check‎. استخدم ‎mmetl transform ... --dry-run‎ للتحقق من صحة التفريغ قبل إنتاج ملف الاستيراد.

2. 09

   تحويل تفريغ ‎Rocket.Chat‎ إلى ملف استيراد ‎Mattermost‎

   شغّل عملية التحويل مشيراً إلى المجلد الذي يحتوي مجموعات ‎BSON‎ المُصدَّرة (المجلد الفرعي ‎rocketchat‎ من التفريغ) واسم فريق ‎Mattermost‎ المستهدف:

   mmetl transform rocketchat \
     --team my-team \
     --dump-dir /tmp/rc-dump/rocketchat \
     --output /tmp/mattermost-import

   تُنتج ‎mmetl‎ ملف ‎import.jsonl‎ ومجلد ‎bulk-export-attachments/‎. للاختبار دون إنتاج مخرجات:

   mmetl transform rocketchat \
     --team my-team \
     --dump-dir /tmp/rc-dump/rocketchat \
     --dry-run

3. 10

   تشغيل الاستيراد في ‎Mattermost‎ عبر ‎mmctl‎

   انسخ ملف الاستيراد إلى مجلد بيانات ‎Mattermost‎، ثم شغّل الاستيراد الجماعي:

   # نسخ إلى الحاوية
   docker cp /tmp/mattermost-import/import.jsonl \
     <mattermost-container>:/mattermost/data/import.jsonl
   
   # تشغيل الاستيراد من mmctl (داخل الحاوية)
   docker exec <mattermost-container> mmctl import bulk \
     /mattermost/data/import.jsonl --bypass-upload

   لمتابعة التقدم، راجع مهام الاستيراد في System Console → Bulk Import.

4. 11

   التحقق من النتائج والقيود المعروفة

   بعد الاستيراد، تحقّق من النقاط التالية:
   - يجب أن تكون القنوات العامة والخاصة موجودة في ‎Mattermost‎ مع سجلها التاريخي.
   - تُستورَد أسماء المستخدمين لكن كلمات المرور لا تُستورَد — يجب على كل مستخدم إعادة تعيين كلمة مروره أو تسجيل الدخول عبر ‎LDAP‎.
   - تتطلب الملفات المرفقة تمريراً ثانياً مع ‎--attachments-dir‎.
   - تُسطَّح خيوط المناقشة (الردود المتداخلة) إذا لم يُتعرَّف على بنيتها.

إعداد ‎LDAP‎ في ‎Mattermost Community‎

1. 12

   تفعيل ‎LDAP‎ في ‎System Console‎

   في ‎System Console → Authentication → AD/LDAP‎، فعّل ‎LDAP‎ وأدخل معاملات الاتصال:

   LDAP Server: ldap.yourdomain.com
   Port: 389 (LDAP) أو 636 (LDAPS)
   Bind Username: cn=mattermost-svc,ou=serviceaccounts,dc=yourdomain,dc=com
   Bind Password: <كلمة-مرور-حساب-الخدمة>
   Base DN: ou=users,dc=yourdomain,dc=com

   فعّل ‎LDAP over TLS (LDAPS)‎ أو ‎StartTLS‎ إذا كانت بنيتك التحتية تدعمه.

2. 13

   إعداد تعيينات السمات

   يقرأ ‎Mattermost‎ سمات ‎LDAP‎ لملء ملفات التعريف. التعيينات الشائعة لـ‎Active Directory‎:

   ID Attribute:        objectGUID
   Username Attribute:  sAMAccountName
   Email Attribute:     mail
   First Name:          givenName
   Last Name:           sn

   لـ‎OpenLDAP‎، استبدل ‎sAMAccountName‎ بـ‎uid‎ و‎objectGUID‎ بـ‎entryUUID‎.

   في ‎User Filter‎، قيّد المزامنة بأعضاء المجموعة المطلوبة:

   (memberOf=cn=mattermost-users,ou=groups,dc=yourdomain,dc=com)

3. 14

   اختبار الاتصال والمزامنة

   انقر على ‎AD/LDAP Test‎ في أسفل الصفحة للتحقق من صحة الاتصال والربط. في حالة حدوث خطأ ‎LDAP Result Code 49 'Invalid Credentials'‎، تحقّق من ‎DN‎ حساب الخدمة وكلمة مروره.

   شغّل أول مزامنة يدوية عبر ‎AD/LDAP Synchronize Now‎. سيُربط المستخدمون الذين يتطابق بريدهم الإلكتروني مع حساب مُستورَد عبر ‎mmetl‎ تلقائياً.

استكشاف الأخطاء الشائعة وإصلاحها

‎Rocket.Chat Community 9.0‎ مقابل ‎Mattermost Community‎

مرّر الجدول أفقيًا

‎Mattermost Community‎، منصة مستقرة على المدى البعيد