> ## 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.

# نقل البريد والتقويم من Exchange أو Gmail مع imapsync
- URL: https://arabroot.io/articles/نقل-البريد-والتقويم-من-exchange-او-gmail-مع-imapsync/
- Published: 2026-11-05T21:44:43.000Z
- Updated: 2026-11-05T22:32:51.000Z
- Description: ننقل صناديق بنمط Exchange أو Gmail مع تقويمها وجهات اتصالها إلى سيرفرات مفتوحة بأرقام حقيقية، ونكشف ثلاث مشكلات لا تظهر كخطأ: تكرار التصنيفات، ورسائل تتخطى بصمت، واجتماعات متكررة تختفي.
- Author: فريق عرب رووت
- Tags: الأدلة التقنية, الاستضافة الذاتية والتطبيقات, البريد الإلكتروني, الاستضافة الذاتية, imapsync

في خطة الانتقال لمؤسستنا المتوسطة، 150 موظفاً تترك Microsoft 365، وصلنا إلى الجزء الذي يلمسه كل موظف كل صباح: البريد. فالموظفة في المالية عندها ثلاث سنوات من المراسلات مع الموردين، وفيها مرفقات عقود وفواتير لا توجد في أي مكان آخر، ومديرها يفتح تقويمه فيجد اجتماعات أسبوعية تمتد إلى نهاية السنة، وفي هاتفه مئتا جهة اتصال لا يعرف أرقامها من دون هذه القائمة. وإذا وصلت هذه الموظفة صباح الأحد إلى السيرفر الجديد فوجدت مجلد العقود ناقصاً، أو اختفى اجتماع الأسبوع من تقويم مديرها، فلن يهم أحداً أن الانتقال نجح في 99% من الرسائل.

وقد شرحنا في [ترحيل البريد بين خادمي mailcow](https://arabroot.io/articles/%D8%AA%D8%B1%D8%AD%D9%8A%D9%84-%D8%A7%D9%84%D8%A8%D8%B1%D9%8A%D8%AF-%D8%A8%D9%8A%D9%86-%D8%AE%D8%A7%D8%AF%D9%85%D9%8A-mailcow/) كيف تنقل الصناديق بين سيرفرين تملكهما بمهام imapsync من ال API، وفي [دليل استضافة البريد للمؤسسات](https://arabroot.io/articles/%D8%AF%D9%84%D9%8A%D9%84-%D8%A7%D8%B3%D8%AA%D8%B6%D8%A7%D9%81%D8%A9-%D8%A7%D9%84%D8%A8%D8%B1%D9%8A%D8%AF-%D8%A7%D9%84%D8%A5%D9%84%D9%83%D8%AA%D8%B1%D9%88%D9%86%D9%8A-%D9%84%D9%84%D9%85%D8%A4%D8%B3%D8%B3%D8%A7%D8%AA/) المراحل العامة وسجلات DNS، فلن نعيدهما. وهذا المقال عن الحالة الأصعب: أن يكون المصدر Exchange Online أو Gmail، أي سيرفراً لا تملكه، له طريقته في المصادقة، وطريقته في تنظيم الرسائل، وحدوده على سرعة القراءة، وأن تنقل معه التقويم وجهات الاتصال التي لا يحملها IMAP أصلاً. وسوف نبني مختبراً فيه صندوق بنمط Exchange وصندوق بنمط Gmail، وننقلهما بأرقام حقيقية، ونقع في ثلاث مشكلات لا يظهر أي منها كخطأ.

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

- ماذا ينتقل وبأي أداة، وما الذي لا ينقله أي أداة.
- القراءة من Exchange Online بعد تعطيل المصادقة الأساسية، والقراءة من Gmail مع حدوده اليومية.
- مختبر حقيقي: imapsync 2.326 بين سيرفرين، وصندوق بنمط Exchange، وتشغيل ثان يثبت أن النسخ لا يكرر، ونسخ الفرق بعد رسائل جديدة.
- تصنيفات Gmail: لماذا صارت ألف رسالة 2170، وماذا تخسر إذا منعت التكرار.
- ثلاثون رسالة لم تنتقل وimapsync يقول «Detected 0 errors».
- التقويم وجهات الاتصال: استيراد ملفات Outlook وGoogle إلى CalDAV وCardDAV، واجتماعات متكررة اختفت في النسخة الأولى من السكربت.
- التحقق قبل بوابة الدفعة، وأخطاء شائعة، وقائمة تحقق.

## ماذا ينتقل، وبأي أداة؟ What Moves

الخطأ الأول في أغلب خطط نقل البريد أنها تعامل «صندوق البريد» كأنه شيء واحد، بينما هو في Exchange وGmail ثلاث بيانات مختلفة يجمعها حساب واحد: الرسائل، والتقويم، وجهات الاتصال، ولكل منها بروتوكول. فالرسائل تقرأ وتكتب بـ IMAP، وهو بروتوكول قديم ومعيار يدعمه المصدر والهدف، ولذلك فأداة واحدة مثل imapsync تكفي لها، وقد شرحنا البروتوكول في [كيف يعمل البريد الإلكتروني](https://arabroot.io/articles/%D9%83%D9%8A%D9%81-%D9%8A%D8%B9%D9%85%D9%84-%D8%A7%D9%84%D8%A8%D8%B1%D9%8A%D8%AF-%D8%A7%D9%84%D8%A7%D9%84%D9%83%D8%AA%D8%B1%D9%88%D9%86%D9%8A-smtp-%D9%88-imap/). وأما التقويم وجهات الاتصال فلا يحملهما IMAP، والمعيار المفتوح لهما CalDAV وCardDAV، ولكن Exchange لا يقدمهما، وGoogle يقدمهما بطريقته، فالطريق العملي في الانتقال هو ملف تصدير بصيغة iCalendar للتقويم وvCard لجهات الاتصال، ثم استيراده في سيرفر CalDAV وCardDAV الجديد، وقد شرحنا البروتوكولين بتجربة كاملة في [التقويم وجهات الاتصال CalDAV وCardDAV](https://arabroot.io/articles/%D8%A7%D9%84%D8%AA%D9%82%D9%88%D9%8A%D9%85-%D9%88%D8%AC%D9%87%D8%A7%D8%AA-%D8%A7%D9%84%D8%A7%D8%AA%D8%B5%D8%A7%D9%84-caldav-%D9%88-carddav/).

![أربعة أعمدة: البريد والتقويم وجهات الاتصال وما لا ينتقل بأداة](https://arabroot.io/content/images/2026/11/mail-migration-01-what-moves.webp)

ثلاث بيانات بثلاث طرق تحقق، وعمود رابع يحتاج عملاً يدوياً أو إعادة إعداد

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

### لماذا imapsync وليس ملفات التصدير؟ Why IMAP to IMAP

الحل البسيط الذي يقترحه بعض الناس أن يصدر كل موظف بريده من Outlook إلى ملف PST، ثم يفتحه في برنامجه الجديد ويسحب المجلدات إلى السيرفر الجديد. وهذا يعمل لموظف واحد، وهو غير مناسب إطلاقاً لمئة وخمسين، والسبب أن العمل يدوي على كل جهاز، وأن الموظف هو من يقرر ما ينقل، وأنه لا يوجد شيء اسمه «نقل الفرق»، فالرسائل التي تصل بعد التصدير تحتاج تصديراً ثانياً، ولا أحد يعرف في النهاية هل انتقل كل شيء. والحل الثاني أن يصدر المدير الصناديق كلها من Microsoft بأدوات البحث والتصدير في لوحة الامتثال، وهذا أفضل لأنه مركزي، ولكنه يعطيك ملفات PST تحتاج بعدها أداة تحولها وترفعها إلى السيرفر الجديد، وهو أيضاً لقطة من لحظة واحدة لا تتحدث. والحل الأنسب هو النقل من IMAP إلى IMAP مباشرة بأداة مثل imapsync، لأنها تعمل من سيرفر واحد لكل الصناديق، وتعيد التشغيل دون تكرار، وتنقل الفرق فقط، وتطبع لكل صندوق أرقاماً تقارنها، وكل هذا سنراه في المختبر. وأما ملفات PST فيبقى لها دور واحد في المشروع، وهو أرشيف الإغلاق الذي تحتفظ به المؤسسة بعد انتهاء الاشتراك كما سيأتي.

## القراءة من المصدر: Exchange Online أو Gmail

### Exchange Online: لا توجد كلمة مرور OAuth 2.0

الحل البسيط الذي يجربه الجميع هو أن يعطي imapsync اسم الموظف وكلمة مروره، كما فعلنا بين سيرفري mailcow، وهذا لا يعمل مع Exchange Online منذ سنوات، فقد عطلت Microsoft المصادقة الأساسية Basic Authentication لبروتوكول IMAP وغيره، وتقول في [صفحة إيقاف المصادقة الأساسية](https://learn.microsoft.com/en-us/exchange/clients-and-mobile-in-exchange-online/deprecation-of-basic-authentication-exchange-online?ref=arabroot.io) إنها معطلة الآن في كل الحسابات، وإن أحداً لا يستطيع إعادة تفعيلها، لا أنت ولا الدعم الفني. والطريق الرسمي هو OAuth 2.0: تسجل تطبيقاً في Microsoft Entra، وتحصل على رمز وصول Access Token، ويرسله imapsync بصيغة SASL XOAUTH2 بدلاً من كلمة المرور، كما في [توثيق المصادقة لتطبيقات IMAP](https://learn.microsoft.com/en-us/exchange/client-developer/legacy-protocols/how-to-authenticate-an-imap-pop-smtp-application-by-using-oauth?ref=arabroot.io).

ولمشروع نقل لا تريد أن يدخل فيه كل موظف ويوافق على التطبيق بنفسه، فالطريقة المناسبة هي صلاحية التطبيق Application Permission المسماة `IMAP.AccessAsApp` بتدفق بيانات اعتماد العميل Client Credentials، وتحتاج موافقة مدير الحساب، ثم تسجيل التطبيق في Exchange بالأمر `New-ServicePrincipal`، ثم إعطاءه صلاحية الوصول الكامل لكل صندوق بالأمر `Add-MailboxPermission`. والصورة التالية تبين الخطوات:

![أربع خطوات للقراءة من Exchange Online عبر OAuth: تسجيل التطبيق ثم Exchange ثم الرمز ثم imapsync](https://arabroot.io/content/images/2026/11/mail-migration-02-exchange-oauth.webp)

imapsync يقرأ الرمز من ملف، فتجدده دون أن توقف النقل

في الخطوات أعلاه لاحظ التالي:

- أعط الصلاحية لصناديق الدفعة الحالية فقط، وليس للمؤسسة كلها مرة واحدة، والسبب أن هذا التطبيق يقرأ كل صندوق تعطيه له، فإذا تسرب سره فأقل ما تريده أن يكون نطاقه أربعين صندوقاً وليس مئة وخمسين.
- imapsync يأخذ الرمز بالخيار `--oauthaccesstoken1`، ويقبل مسار ملف بدلاً من الرمز نفسه، فيعيد قراءته عند إعادة الاتصال كما في [أسئلة imapsync عن XOAUTH2](https://imapsync.lamiral.info/FAQ.d/FAQ.XOAUTH2.txt?ref=arabroot.io)، وهذا مهم لأن صلاحية الرمز محدودة والصندوق الكبير قد يأخذ ساعات.
- بعد آخر دفعة احذف صلاحيات الصناديق والتطبيق نفسه، واكتب ذلك في قائمة الإغلاق مع إيقاف التجديد.

### Gmail: حدود يومية وتصنيفات Labels

وإذا كانت المؤسسة على Google Workspace فالمصادقة إما OAuth كذلك، أو كلمة مرور التطبيق App Password لحساب فيه التحقق بخطوتين، كما في [صفحة كلمات مرور التطبيقات](https://support.google.com/accounts/answer/3024190?ref=arabroot.io) إذا كانت سياسة المؤسسة تسمح بها. ولكن المشكلة الأكبر في Gmail شيئان. الأول حدود القراءة: فتقول [أسئلة imapsync عن Gmail](https://imapsync.lamiral.info/FAQ.d/FAQ.Gmail.txt?ref=arabroot.io) إن Gmail يسمح بتنزيل 2500 MB في اليوم عبر IMAP لكل حساب، وإذا وصلت الحد قطع الاتصال أو أبطأه حتى يصبح أقل من كيلوبايت في الثانية، وصفحة Google عن [حدود Gmail](https://support.google.com/a/answer/1071518?ref=arabroot.io) تضع حدود الحساب بشكل عام. وهذا يعني أن صندوقاً بحجم 12 GB يحتاج خمسة أيام على الأقل، وهذا بالضبط سبب النسخ المسبق Pre-seed الذي وضعناه في خطة الدفعات، فلا يمكن أن تنقل صندوقاً كهذا في عطلة أسبوع. والثاني أن Gmail لا يعرف المجلدات، وإنما التصنيفات Labels، والرسالة الواحدة قد يكون لها ثلاثة تصنيفات، وفي IMAP يعرض كل تصنيف كمجلد، وهذا ما سنرى أثره بالأرقام في المختبر.

## قبل النقل: ما الذي لا تراه في IMAP؟ Mailbox Inventory

الجرد الذي بنينا عليه الدفعات في خطة الانتقال فيه حجم صندوق كل موظف، ولكن حجم الصندوق في لوحة الإدارة لا يقول كل شيء، وفي البريد تحديداً هناك ثلاثة أشياء يجب أن تبحث عنها قبل أول دفعة. الأول ملفات PST، وهي أرشيفات يصنعها Outlook على كمبيوتر الموظف عندما يمتلئ صندوقه أو عندما يطلب منه أحد أن «يؤرشف بريده القديم»، فهي ليست في Exchange أصلاً، ولا يراها IMAP ولا imapsync، وكثير من الموظفين القدامى عندهم سنوات من البريد فيها. والطريقة العملية أن يسأل الجرد كل موظف هل عنده ملفات أرشيف، وأن يستوردها إلى صندوقه في Exchange قبل النقل، أو أن تفتح في برنامج بريد متصل بالسيرفر الجديد وتسحب منها المجلدات إليه، وفي الحالتين هذا عمل يدوي يجب أن تحسب وقته في الدفعة.

والثاني الصناديق المشتركة Shared Mailboxes مثل `info@` و`hr@`، فهذه ليس لها موظف واحد يملكها، وإنما يفتحها عدة أشخاص بصلاحيات، وفي Exchange Online تقرؤها بالتطبيق نفسه وبرمز وصول باسم الصندوق المشترك، كما يشرح توثيق Microsoft في قسم الصناديق المشتركة. وعلى السيرفر الجديد تصبح صندوقاً عادياً يعطى أصحابه صلاحية عليه، أو مجلداً مشتركاً، حسب ما يدعمه سيرفرك، وانقلها مع القسم الذي يستخدمها أكثر، والسبب أن من يرد على العملاء من `info@` يجب أن يجد الصندوق في مكانه الجديد في اليوم نفسه الذي ينتقل فيه.

والثالث العناوين الإضافية Aliases، فالموظفة سارة قد يصلها البريد على `sara.alharbi@` وعلى `s.alharbi@` وعلى عنوان قسم قديم، وكلها في Exchange عناوين لصندوق واحد. فصدر قائمة العناوين لكل صندوق مع الجرد، وأنشئها على السيرفر الجديد قبل الدفعة، وإلا سيرد السيرفر الجديد على رسائل العنوان القديم بأنه غير موجود بعد أن تغير MX، ولن يعرف المرسل لماذا.

## المختبر: نقل حقيقي بأرقام Lab

لا نستطيع أن ننقل من Exchange Online أو Gmail حقيقيين في مختبر منشور، لأن ذلك يحتاج حسابات مؤسسة وبيانات موظفين، ولذلك بنينا المصدر سيرفر Dovecot 2.4.5 نضع فيه صناديق مولدة بالشكل الذي تراه في Exchange وGmail: صندوق بأسماء مجلدات Exchange مثل `Sent Items` و`Deleted Items` ومجلد فرعي باسم عربي، وصندوق بأسلوب Gmail فيه `[Gmail]/All Mail` والتصنيفات كمجلدات تتكرر فيها الرسائل نفسها. والهدف سيرفر Dovecot ثان، وهو قلب IMAP في mailcow كما شرحنا في [مقارنة سيرفرات البريد](https://arabroot.io/articles/%D9%85%D9%82%D8%A7%D8%B1%D9%86%D8%A9-mailcow-%D9%88-stalwart-%D9%88-postfix/)، وأداة النقل imapsync 2.326، وهي الأداة التي يستخدمها mailcow نفسه في مهام المزامنة. والفرق الوحيد عن الواقع هو المصادقة، فبدلاً من رمز OAuth نستخدم كلمة مرور، وأما سلوك imapsync مع المجلدات والتكرار والمعرفات فهو نفسه.

```yaml
name: wr-mig-mail
services:
  src:                       # plays the old mailbox host (Exchange Online or Gmail) in the lab
    image: dovecot/dovecot:2.4.5
    container_name: wr-mig-src
    environment: { USER_PASSWORD: "Src-Lab-Pass-41" }
    volumes: [ "wr-mig-mail-src:/srv/vmail" ]
    networks: [ mail ]
  dst:                       # the new mail server
    image: dovecot/dovecot:2.4.5
    container_name: wr-mig-dst
    environment: { USER_PASSWORD: "Dst-Lab-Pass-73" }
    volumes: [ "wr-mig-mail-dst:/srv/vmail" ]
    networks: [ mail ]
  dav:                       # CalDAV/CardDAV server for calendars and contacts
    image: tomsquest/docker-radicale:3.9.0.0
    container_name: wr-mig-dav
    volumes: [ "./radicale-config:/config:ro", "wr-mig-mail-dav:/data" ]
    ports: [ "127.0.0.1:47231:5232" ]
    networks: [ mail ]
volumes:
  wr-mig-mail-src: { name: wr-mig-mail-src }
  wr-mig-mail-dst: { name: wr-mig-mail-dst }
  wr-mig-mail-dav: { name: wr-mig-mail-dav }
networks:
  mail: { name: wr-mig-mail-net }
```

والسكربت `seed_mail.py` يولد الرسائل بعناوين عربية وإنجليزية، و8% منها بمرفقات، ويكتب أسماء المجلدات العربية بالترميز الذي يطلبه IMAP، وهو UTF-7 المعدل Modified UTF-7 من [المواصفة RFC 3501](https://www.rfc-editor.org/rfc/rfc3501?ref=arabroot.io)، ولذلك يظهر مجلد «العقود» في المخرجات هكذا: `INBOX/&BicGRAY5BkIGSAYv-`. وهذا ما سيظهر لك أيضاً في سجلات أي أداة نقل عندما تقابل مجلداً عربياً، فلا تظنه تلفاً. وأحجام الصندوقين في المصدر:

```text
  sara.alharbi     Archive                             300
  sara.alharbi     Deleted Items                       120
  sara.alharbi     Sent Items                          400
  sara.alharbi     INBOX/&BicGRAY5BkIGSAYv-             80
  sara.alharbi     INBOX/Clients                       150
  sara.alharbi     INBOX                               900
  omar.alqahtani   &BicGRAY5BkIGSAYv-                  120
  omar.alqahtani   Projects                            200
  omar.alqahtani   [Gmail]                          (no messages: container folder)
  omar.alqahtani   [Gmail]/Sent Mail                   250
  omar.alqahtani   [Gmail]/All Mail                   1000
  omar.alqahtani   INBOX                               600
```

صندوق سارة 1950 رسالة، وصندوق عمر 2170 نسخة، ولكنها في الحقيقة 1000 رسالة فقط، لأن كل رسالة موجودة في `All Mail` وفي مجلد أو اثنين من التصنيفات، وهذا شكل كل صندوق Gmail حقيقي.

وقد يتساءل البعض: إذا كان السيرفر الجديد mailcow، فلماذا لا نستخدم مهام المزامنة من واجهته كما فعلنا في مقال ترحيل mailcow؟ والإجابة أنك تستطيع، فتلك المهام تشغل imapsync نفسه في الخلفية، ولكنها تحتاج بيانات دخول الصندوق القديم في الواجهة لكل مهمة، والقراءة من Exchange Online تحتاج رمز OAuth يتجدد أثناء النقل، وهذا أسهل في سكربت تتحكم فيه، والأهم أنك تحتاج المخرج الكامل لكل تشغيل لكي تقرأ منه سطري void وFinal difference كما سيأتي. وإذا كان السيرفر الجديد Stalwart فله أداة استيراد خاصة به كما في [توثيق الاستيراد والتصدير في Stalwart](https://stalw.art/docs/migration/import-export/?ref=arabroot.io)، وهي مفيدة إذا كان المصدر ملفات، ولكن النقل من سيرفر حي يتحدث كل يوم أسهل بأداة واحدة تعمل مع أي مصدر وأي هدف. ولذلك نستخدم imapsync مباشرة من Container مستقل في كل الحالات، فيبقى السكربت نفسه، وطريقة التحقق نفسها، أياً كان السيرفر الذي اخترته في النهاية.

### النسخ الأول لصندوق بنمط Exchange First Sync

نشغل imapsync من Image الرسمية بسكربت صغير يأخذ اسم المستخدم وأي خيارات إضافية، وكلمات المرور من ملفات وليس من سطر الأوامر، والسبب أن سطر الأوامر يظهر في قائمة العمليات وفي سجل ال Shell:

```bash
#!/bin/sh
# One imapsync run for one user from the old server (wr-mig-src) to the new one (wr-mig-dst).
#   sh sync.sh <user> [extra imapsync options]
u="$1"; shift
MSYS_NO_PATHCONV=1 docker run --rm --name wr-mig-imapsync --network wr-mig-mail-net -v "$(cygpath -w "$PWD" 2>/dev/null || pwd):/lab" \
  gilleslamiral/imapsync:2.326 imapsync \
  --host1 wr-mig-src --port1 31993 --ssl1 --user1 "$u" --passfile1 /lab/.pass-src \
  --host2 wr-mig-dst --port2 31993 --ssl2 --user2 "$u" --passfile2 /lab/.pass-dst \
  --nolog "$@"
```

```bash
sh sync.sh sara.alharbi
```

والمخرج طويل، أكثر من ألفي سطر، وأهم ما فيه ثلاثة أجزاء. الأول ربط المجلدات:

```text
Turned on automapping folders ( use --noautomap to turn off automapping )
Host1: Sent Items not \Sent because set to Sent
Host1: Trash not \Trash because set to Deleted Items

Folders mapping from --automap feature (use --f1f2 to override any mapping, or --noautomap):
[Deleted Items]                          -> [Trash]
[Sent]                                   -> [Sent]
[Junk]                                   -> [Junk]
[Drafts]                                 -> [Drafts]
[Sent Items]                             -> [Sent]
[Trash]                                  -> [Trash]
```

لاحظ أن imapsync ربط `Sent Items` بالمجلد `Sent` على السيرفر الجديد، و`Deleted Items` بالمجلد `Trash`، والسبب أن السيرفر الجديد يعلن مجلداته الخاصة Special-Use بعلامات مثل `\Sent` و`\Trash`، وأن الربط التلقائي Automap يعرف أسماء Exchange الشائعة. وهذا ما تريده، لأن برنامج البريد على هاتف الموظف سيحفظ الرسائل المرسلة الجديدة في المجلد الذي يحمل العلامة `\Sent`، فإذا انتقلت رسائله القديمة إلى مجلد آخر اسمه `Sent Items` سيجد بريده المرسل في مكانين. والجزء الثاني الإحصاءات:

```text
Transfer time                           : 32.0 sec
Folders synced                          : 10/10 synced
Messages transferred                    : 1950
Messages skipped                        : 0
Messages found duplicate on host1       : 0
Messages found duplicate on host2       : 0
Messages void (noheader) on host1       : 0
Total bytes transferred                 : 46287074 (44.143 MiB)
Message rate                            : 60.9 messages/s
Average bandwidth rate                  : 1410.9 KiB/s
Memory consumption at the end           : 181.1 MiB (*time 1.6 MiB*h) (started with 163.6 MiB)
Final difference host2 - host1          : 0 messages, 0 bytes (0.000 KiB)
The sync looks good, all 1950 identified messages in host1 are on host2.
There is no unidentified message on host1.
Detected 0 errors
```

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

- 1950 رسالة و44.1 MiB في 32 ثانية، أي نحو 61 رسالة في الثانية، وهذا بين سيرفرين على الشبكة نفسها، فلا تأخذ هذه السرعة رقماً لتخطيطك، لأن Exchange Online وGmail يحدان سرعة القراءة، وقس السرعة الحقيقية على صناديق المجموعة التجريبية.
- imapsync استهلك 181 MiB من الذاكرة، فإذا شغلت عشر نسخ منه بالتوازي لعشرة صناديق فاحسب نحو 2 GB.
- السطر `Messages void (noheader) on host1 : 0` مهم جداً، وسنعود إليه بعد قليل عندما لا يكون صفراً.
- السطر `Final difference host2 - host1 : 0 messages` هو السطر الذي تقرؤه أولاً في كل صندوق، فهو يقارن العدد في الطرفين بعد النقل.

### التشغيل الثاني ونسخ الفرق Incremental

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

```text
Transfer time                           : 2.7 sec
Messages transferred                    : 0
Messages skipped                        : 1950
Total bytes transferred                 : 0 (0.000 KiB)
Final difference host2 - host1          : 0 messages, 0 bytes (0.000 KiB)
```

صفر رسائل منقولة في 2.7 ثانية، فـ imapsync قارن ترويسات الرسائل في الطرفين ووجد أنها كلها موجودة، ولم يكرر شيئاً. ثم أضفنا 25 رسالة جديدة إلى صندوق سارة في المصدر، كأنها وصلت بعد النسخ المسبق، وشغلنا مرة ثالثة:

```text
Transfer time                           : 2.9 sec
Messages transferred                    : 25
Messages skipped                        : 1950
Total bytes transferred                 : 137876 (134.645 KiB)
Final difference host2 - host1          : 0 messages, 0 bytes (0.000 KiB)
```

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

### تصنيفات Gmail: لماذا صارت ألف رسالة 2170؟

شغلنا صندوق عمر، بنمط Gmail، بالأمر نفسه دون خيارات إضافية:

```text
Transfer time                           : 33.7 sec
Messages transferred                    : 2170
Messages found crossduplicate on host2  : 0
Total bytes transferred                 : 51928793 (49.523 MiB)
Final difference host2 - host1          : 0 messages, 0 bytes (0.000 KiB)
Detected 0 errors
```

ونجح النقل بلا أخطاء، ولكن على السيرفر الجديد الآن 2170 رسالة لألف رسالة فقط، وكل رسالة في `All Mail` لها نسخة ثانية في INBOX أو `Sent Mail`، وبعضها نسخة ثالثة في تصنيف. وهذا يعني مساحة 49.5 MiB بدلاً من نحو 23 MiB، وفي البحث يجد عمر كل رسالة مرتين أو ثلاثاً. والسبب أن السيرفر الجديد لا يعرف أن هذه نسخ من رسالة واحدة، فلكل مجلد في IMAP رسائله المستقلة.

والحل الذي يقترحه imapsync لمن ينقل من Gmail هو مجموعة خيارات، أهمها `--skipcrossduplicates` الذي يمنع نقل رسالة موجودة في مجلد آخر سبق نقله، و`--folderlast "[Gmail]/All Mail"` لكي يأتي `All Mail` آخراً فلا يأخذ منه إلا الرسائل التي ليس لها تصنيف آخر. فحذفنا ما نقلناه وشغلنا من جديد:

```bash
sh sync.sh omar.alqahtani --skipcrossduplicates --useheader Message-Id --regextrans2 's,\[Gmail\].,,' --exclude '\[Gmail\]$' --folderlast '[Gmail]/All Mail'
```

```text
Transfer time                           : 15.8 sec
Messages transferred                    : 1000
Messages skipped                        : 1170
Messages found crossduplicate on host2  : 1170
Total bytes transferred                 : 24252071 (23.129 MiB)
The sync looks good, all 1000 identified messages in host1 are on host2.
```

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

```text
  omar.alqahtani   All Mail                            150
  omar.alqahtani   Sent Mail                           230
  omar.alqahtani   Projects                              0
  omar.alqahtani   &BicGRAY5BkIGSAYv-                  120
  omar.alqahtani   INBOX                               500
```

صندوق الوارد فيه 500 رسالة بدلاً من 600، ومجلد Projects فارغ. والسبب أن imapsync مر على المجلدات بترتيب معين، فمر على تصنيف «العقود» قبل INBOX، فوضع فيه 120 رسالة، منها 100 كانت أيضاً في INBOX، فلما وصل إلى INBOX وجدها منقولة فتخطاها. ومجلد Projects كله رسائل موجودة في INBOX، فجاء فارغاً. فلو ذهب عمر صباح الأحد إلى صندوق الوارد لوجد مئة رسالة مفقودة، وهي ليست مفقودة فعلاً، وإنما في مجلد آخر. فأضفنا `--folderfirst INBOX --folderfirst '[Gmail]/Sent Mail'` لكي يأخذ صندوق الوارد والمرسل الأولوية:

```text
  omar.alqahtani   All Mail                            150
  omar.alqahtani   Projects                              0
  omar.alqahtani   &BicGRAY5BkIGSAYv-                    0
  omar.alqahtani   Sent Mail                           250
  omar.alqahtani   INBOX                               600
```

![جدول عدد الرسائل في كل مجلد لصندوق Gmail في ثلاث طرق نقل](https://arabroot.io/content/images/2026/11/mail-migration-03-gmail-labels.webp)

منع التكرار يوفر نصف المساحة، ولكن كل رسالة تبقى في مجلد واحد، والخيار folderfirst يقرر أيها

والآن INBOX والمرسل كما هما في Gmail، ولكن تصنيفي Projects و«العقود» فارغان. وهذا هو الاختيار الحقيقي الذي يجب أن تتخذه المؤسسة قبل نقل صناديق Gmail، فلا يوجد خيار يحفظ كل شيء: إما أن تبقي التكرار، فتحفظ التصنيفات كمجلدات وتضاعف المساحة، وإما أن تمنعه، فتحفظ كل رسالة مرة واحدة في أهم مجلد لها، وتضيع التصنيفات الإضافية. والأنسب لأغلب المؤسسات الخيار الثاني مع INBOX والمرسل أولاً، ثم يبحث الموظف عن الرسالة بالبحث وليس بالتصنيف، ولكن إذا كان قسم يعتمد على تصنيف معين في عمله، مثل «العقود» في الشؤون القانونية، فضعه في `--folderfirst` قبل INBOX لهذا القسم تحديداً، والسبب أن ما يبحث عنه الموظف بالتصنيف كل يوم أهم مما يبحث عنه بالتاريخ. ولاحظ أيضاً أن مجلد `Sent Mail` لم يرتبط بـ `Sent` على السيرفر الجديد، لأن المصدر في المختبر لا يحمل علامات Gmail الخاصة، فأضف `--f1f2 '[Gmail]/Sent Mail=Sent'` لكي يجد عمر بريده المرسل القديم والجديد في مكان واحد.

### ثلاثون رسالة لم تنتقل، و«Detected 0 errors»

imapsync يعرف أن الرسالة في المصدر هي نفسها في الهدف بترويسة معرف الرسالة Message-ID، وأغلب البريد الحقيقي فيه هذه الترويسة، ولكن ليس كله، فبعض الأنظمة الداخلية القديمة والطابعات التي ترسل المسح الضوئي بالبريد وبعض أدوات الأرشفة تكتب رسائل دونها. فوضعنا في صندوق ثالث، صندوق ريم، ثلاثين رسالة دون Message-ID، وشغلنا النقل:

```text
Messages transferred                    : 0
Messages skipped                        : 30
Messages void (noheader) on host1       : 30  in order to sync those 30 unidentified messages, add option --addheader
Messages void (noheader) on host2       : 0
Final difference host2 - host1          : -30 messages, -193165 bytes (-188.638 KiB)
Detected 0 errors
Exiting with return value 0 (EX_OK: successful termination) 0/50 nb_errors/max_errors PID 1
```

اقرأ هذا المخرج مرتين. صفر رسائل منقولة، وثلاثون متخطاة، والفرق في الآخر سالب ثلاثين، ومع ذلك يقول «Detected 0 errors» ويخرج برمز النجاح 0\. فأي سكربت يشغل imapsync لمئة وخمسين صندوقاً ويعتمد على رمز الخروج وحده سيكتب في تقريره أن صندوق ريم انتقل بنجاح، وهو لم ينقل منه شيئاً. والمخرج نفسه يقول الحل: الخيار `--addheader` يضيف ترويسة معرف لكل رسالة لا تملكها في نسختها على الهدف:

```text
Messages transferred                    : 30
Messages skipped                        : 0
Messages void (noheader) on host1       : 0
Final difference host2 - host1          : 0 messages, 801 bytes (0.782 KiB)
Detected 0 errors
```

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

```text
Messages transferred                    : 0
Messages skipped                        : 30
```

![ثلاث مراحل لصندوق فيه رسائل دون Message-ID: تخط صامت ثم نقل ثم تشغيل دون تكرار](https://arabroot.io/content/images/2026/11/mail-migration-04-silent-skip.webp)

رمز الخروج صفر في الحالات الثلاث، والفرق بينها في سطري void وFinal difference

والقاعدة من هذه التجربة: شغل كل الصناديق بالخيار `--addheader` من أول مرة، وفي سكربت الدفعة لا تعتمد على رمز الخروج، وإنما اقرأ من مخرج كل صندوق سطر `Final difference` وسطر `void`، وأي صندوق لا يكون فيهما صفراً يدخل قائمة المراجعة قبل الصباح. وهذا تفسير واقعي لشرط «عدد الرسائل في الهدف يساوي المصدر» في بوابة القرار التي وضعناها في خطة الانتقال، فالشرط لا يكتب لأنه جميل، وإنما لأن الأداة نفسها لا تعتبر هذا خطأ.

## التقويم وجهات الاتصال عبر CalDAV مع CardDAV

من Outlook يصدر الموظف تقويمه كملف iCalendar بامتداد ics، ومن Google يأتي التقويم ملفاً بالصيغة نفسها من التصدير، كما في [صفحة تصدير تقويم Google](https://support.google.com/calendar/answer/37111?ref=arabroot.io)، وجهات الاتصال من الاثنين بصيغة vCard بامتداد vcf. وفي المختبر ولدنا ثلاثة ملفات بالشكل الذي يخرج من البرنامجين: تقويم سارة من Outlook فيه 120 موعداً وعشرة اجتماعات أسبوعية متكررة، أربعة منها فيها موعدان تغير وقتهما، واسم المنطقة الزمنية فيه بأسلوب Windows `Arab Standard Time`، وتقويم عمر من Google باسم المنطقة `Asia/Riyadh`، و200 جهة اتصال بأسماء عربية:

```text
omar-google.ics      VEVENT=  80  VCARD=   0  UIDs=  80
sara-contacts.vcf    VEVENT=   0  VCARD= 200  UIDs= 200
sara-outlook.ics     VEVENT= 138  VCARD=   0  UIDs= 130
```

لاحظ أن ملف Outlook فيه 138 مكوناً VEVENT ولكن 130 معرفاً UID فقط، وسنعرف بعد قليل لماذا هذا الفرق هو كل القصة. والهدف سيرفر Radicale 3.9 لأنه الأصغر والأسهل في المختبر، والطريقة نفسها مع أي سيرفر CalDAV، مثل SOGo في mailcow أو Nextcloud أو Stalwart.

### المشكلة: اجتماعات متكررة اختفت Recurring Meetings

بروتوكول CalDAV يحفظ كل موعد كعنصر مستقل بعنوان، فالنسخة الأولى من سكربت الاستيراد كانت بسيطة: تقرأ الملف، وتأخذ كل VEVENT، وترسله بطلب PUT إلى عنوان اسمه معرف الموعد UID:

```python
events = re.findall(r"BEGIN:VEVENT.*?END:VEVENT", text, re.S)
col = f"{base}/{user}/{cal}/"
print("MKCALENDAR", req("MKCALENDAR", col))
codes = {}
for ev in events:
    uid = re.search(r"^UID:(.+)$", ev, re.M).group(1).strip()
    body = f"BEGIN:VCALENDAR\nVERSION:2.0\nPRODID:-//arabroot lab//EN\n{tz}\n{ev}\nEND:VCALENDAR\n".replace("\n", "\r\n").encode()
    c = req("PUT", col + uid + ".ics", body); codes[c] = codes.get(c, 0) + 1
print(f"VEVENTs in file: {len(events)}, PUT results: {codes}")
```

```text
MKCALENDAR 201
VEVENTs in file: 138, PUT results: {201: 130, 204: 8}
```

130 طلباً أنشأت عنصراً جديداً بالرمز 201، وثمانية طلبات ردت بالرمز 204، أي أنها استبدلت عنصراً موجوداً. وعدد العناصر على السيرفر 130، وهو عدد المعرفات في الملف، فلو كان التحقق بالعدد وحده لنجح. ولكننا فتحنا ملفات الاجتماعات المتكررة على السيرفر:

```text
objects: 130
040000008200E00074C5B7101A82E00800000000SERIES00.ics RRULE=0 RECURRENCE-ID=1
040000008200E00074C5B7101A82E00800000000SERIES01.ics RRULE=0 RECURRENCE-ID=1
040000008200E00074C5B7101A82E00800000000SERIES02.ics RRULE=0 RECURRENCE-ID=1
040000008200E00074C5B7101A82E00800000000SERIES03.ics RRULE=0 RECURRENCE-ID=1
040000008200E00074C5B7101A82E00800000000SERIES04.ics RRULE=1 RECURRENCE-ID=0
```

والسبب في صيغة iCalendar نفسها: الاجتماع المتكرر مكون فيه قاعدة التكرار RRULE، وإذا تغير وقت موعد واحد منه، يكتب Outlook وGoogle هذا الموعد كمكون VEVENT ثان بالمعرف UID نفسه، ومعه RECURRENCE-ID يقول أي موعد من السلسلة تغير. والاثنان يجب أن يكونا في عنصر واحد على السيرفر. فالسكربت الأول أرسل السلسلة، ثم أرسل الموعد المعدل إلى العنوان نفسه فاستبدلها، ثم الموعد المعدل الثاني فاستبدل الأول. والنتيجة أن أربعة اجتماعات أسبوعية، كل منها عشرون أسبوعاً، أي ثمانون موعداً، اختفت من تقويم سارة، وبقي من كل سلسلة موعد واحد معدل. ولن يلاحظ أحد هذا يوم الانتقال، وإنما في الأسبوع التالي عندما لا يحضر نصف الفريق اجتماعه الأسبوعي.

### الحل: عنصر واحد لكل UID

النسخة الثانية تجمع كل المكونات بحسب المعرف قبل الإرسال، وتستورد جهات الاتصال بالطريقة نفسها إلى دفتر عناوين CardDAV:

```python
    print("MKCALENDAR", req("MKCALENDAR", col))
    tz = "\n".join(re.findall(r"BEGIN:VTIMEZONE.*?END:VTIMEZONE", text, re.S))
    for ev in re.findall(r"BEGIN:VEVENT.*?END:VEVENT", text, re.S):
        groups.setdefault(re.search(r"^UID:(.+)$", ev, re.M).group(1).strip(), []).append(ev)
    wrap = lambda parts: "BEGIN:VCALENDAR\nVERSION:2.0\nPRODID:-//arabroot lab//EN\n" + (tz + "\n" if tz else "") + "\n".join(parts) + "\nEND:VCALENDAR\n"
```

```text
MKCALENDAR 201
components in file: 138, objects (UIDs): 130, multi-component objects: 4, PUT results: {201: 130}
MKCOL addressbook 201
components in file: 200, objects (UIDs): 200, multi-component objects: 0, PUT results: {201: 200}
MKCALENDAR 201
components in file: 80, objects (UIDs): 80, multi-component objects: 0, PUT results: {201: 80}
```

```text
objects: 130
040000008200E00074C5B7101A82E00800000000SERIES00.ics RRULE=1 RECURRENCE-ID=2
040000008200E00074C5B7101A82E00800000000SERIES01.ics RRULE=1 RECURRENCE-ID=2
040000008200E00074C5B7101A82E00800000000SERIES02.ics RRULE=1 RECURRENCE-ID=2
040000008200E00074C5B7101A82E00800000000SERIES03.ics RRULE=1 RECURRENCE-ID=2
040000008200E00074C5B7101A82E00800000000SERIES04.ics RRULE=1 RECURRENCE-ID=0
contacts: 200
```

كل الطلبات أنشأت عناصر جديدة، ولا يوجد 204، والسلاسل الأربع فيها قاعدة التكرار ومعها الموعدان المعدلان. وفي واجهة Radicale تظهر مجموعتا سارة: دفتر عناوين فيه 200 جهة اتصال، وتقويم فيه 130 عنصراً:

![واجهة Radicale تعرض مجموعتي سارة: جهات الاتصال 200 عنصر والتقويم 130 عنصراً](https://arabroot.io/content/images/2026/11/mail-migration-05-radicale-collections.webp)

واجهة Radicale 3.9 بعد الاستيراد، والعدد وحده لا يكشف مشكلة الاجتماعات المتكررة

![مقارنة بين النسخة الأولى التي فقدت أربع سلاسل والنسخة الثانية التي جمعت المكونات بالمعرف](https://arabroot.io/content/images/2026/11/mail-migration-06-recurring.webp)

التحقق الصحيح للتقويم: عدد المعرفات، ثم أن كل سلسلة ما زالت فيها RRULE

### المنطقة الزمنية بأسماء Windows Time Zones

لاحظ أن Outlook كتب المنطقة الزمنية في الملف باسم Windows `Arab Standard Time`، بينما Google كتبها باسم قاعدة بيانات المناطق `Asia/Riyadh`. والملف من Outlook يحمل معه تعريف المنطقة VTIMEZONE بإزاحة +0300، ولذلك قبله Radicale وحفظه كما هو، ولكن بعض البرامج على الهواتف تعرف المنطقة بالاسم وليس بالتعريف المرفق، فتعرض المواعيد بإزاحة خاطئة أو بتوقيت UTC. ومراجعة هذا سهلة في المجموعة التجريبية: افتح مواعيد شخص من تقويم Outlook المستورد على iPhone وAndroid وThunderbird، وتأكد أن الساعة نفسها. وإذا ظهرت المشكلة فالحل تحويل أسماء Windows إلى أسماء IANA قبل الاستيراد، وجدول التحويل الرسمي بينهما في [ملف windowsZones من مشروع CLDR](https://github.com/unicode-org/cldr/blob/main/common/supplemental/windowsZones.xml?ref=arabroot.io). ولاحظ أن المملكة لا تعمل بالتوقيت الصيفي، فالمشكلة عندنا أخف منها في الدول التي تغير ساعتها، ولكن المؤسسة التي لها اجتماعات مع شركاء في أوروبا ستراها في مواعيد هؤلاء.

## التحقق قبل بوابة الدفعة Verification

سطر `Final difference` في imapsync يقارن الأعداد في المجلدات المنقولة، ولكنه لا يعرف قرارك في صناديق Gmail أن الهدف يجب أن يكون فيه عدد الرسائل الفريدة وليس عدد النسخ، ولذلك كتبنا سكربت تحقق مستقلاً يقرأ الطرفين بنفسه، ويعد الرسائل والمعرفات الفريدة والرسائل التي لا معرف لها، ويقارن:

```bash
docker run --rm --name wr-mig-verify --network wr-mig-mail-net -v "$PWD:/lab" -w /lab python:3.13-slim python verify.py wr-mig-src <src pass> wr-mig-dst <dst pass> sara.alharbi omar.alqahtani reem.alzahrani
```

```text
user              src msgs  src ids  no id  dst msgs  dst ids  result
sara.alharbi          1975     1975      0      1975     1975  OK
omar.alqahtani        2170     1000      0      1000     1000  OK
reem.alzahrani          30        0     30        30       30  OK
```

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

- صندوق سارة 1975 رسالة بعد الخمس والعشرين الجديدة، والمعرفات كلها فريدة، والهدف مطابق.
- صندوق عمر 2170 نسخة في المصدر و1000 معرف، والهدف 1000 رسالة بالمعرفات نفسها، وهذا هو النجاح بعد قرار منع التكرار.
- صندوق ريم 30 رسالة بلا معرف في المصدر، وفي الهدف 30 رسالة لها معرفات، وهي التي أضافها `--addheader`.

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

![جدول أرقام تشغيلات imapsync في المختبر: الرسائل المنقولة والمتخطاة والحجم والوقت](https://arabroot.io/content/images/2026/11/mail-migration-07-numbers.webp)

النسخ الأول هو الأطول، وكل تشغيل بعده ينقل الفرق فقط

## كم يستغرق النقل فعلاً؟ Throughput Planning

أرقام المختبر بين سيرفرين على الشبكة نفسها، 1.4 MiB في الثانية وصندوق كامل في نصف دقيقة، ولا علاقة لها بما ستراه من Exchange Online أو Gmail، والسبب أن المزود يحد سرعة القراءة لكل حساب، وأن رابط المؤسسة إلى السيرفر الجديد له سرعته أيضاً. والطريقة الصحيحة أن تحسب من القيد الأشد. ففي Gmail القيد معروف: 2500 MB في اليوم لكل حساب، فصندوق بحجم 5 GB، وهو الوسيط في جرد مؤسستنا التجريبي، يحتاج يومين على الأقل، والصندوق بحجم 20 GB يحتاج ثمانية أيام، وهذا لا يتغير إذا كان رابطك أسرع، لأن الحد على الحساب. ولكن الحد لكل حساب وليس للمؤسسة، فتستطيع أن تشغل عشرين صندوقاً بالتوازي، وحينها يصبح القيد هو رابطك والذاكرة على جهاز النقل، فكل نسخة من imapsync استهلكت في المختبر نحو 180 MiB.

وفي Exchange Online الحدود أقل وضوحاً، فالخدمة تبطئ الاتصالات الكثيفة لحماية نفسها، ولا يوجد رقم واحد تخطط عليه، ولذلك قس في المجموعة التجريبية: انقل صناديقها السبعة عشر، وسجل لكل صندوق حجمه ووقت نسخه الأول، فيصبح عندك رقم MB في الساعة لكل صندوق من مؤسستك أنت، وضعه في مخطط الدفعات مكان الافتراض. وإذا ظهر أن صندوقاً أو اثنين أكبر بكثير من الباقين، وهذا يحدث دائماً مع المدراء القدامى، فابدأ نسخهم المسبق قبل دفعتهم بأسابيع، لا بأيام.

وانتبه إلى أن الأرقام تشمل المرفقات، وأن المرفقات هي أغلب الحجم في أي صندوق مؤسسي، ففي المختبر كانت 8% من الرسائل فقط بمرفقات، ومع ذلك كانت أكبر رسالة 405 KiB والمتوسط أقل من 25 KiB. وفي صندوق حقيقي فيه عقود وعروض أسعار ستجد رسائل بعشرين ميجابايت، وبعض سيرفرات البريد ترفض الرسالة الأكبر من حدها عند الاستقبال، فتأكد أن حد حجم الرسالة على السيرفر الجديد لا يقل عن حده في المصدر، وإلا ستظهر الرسائل الكبيرة في المخرج كأخطاء نسخ.

## ليلة الانتقال: الترتيب Cutover Order

في خطة الانتقال يبقى سجل MX على Exchange Online حتى آخر دفعة، وكل موظف ينتقل يصله بريده بتحويل إلى عنوان توجيه على السيرفر الجديد. وبناء على ما رأيناه في المختبر، هذا هو الترتيب لكل دفعة:

1. قبل أسبوعين أو أكثر: تشغيل imapsync لكل صندوق في الدفعة، بـ `--addheader`، وبخيارات Gmail إذا كان المصدر Gmail، وتشغيله كل ليلة بعد ذلك لكي يبقى الفرق صغيراً.
2. في ليلة الانتقال: وضع التحويل على صناديق الدفعة في المصدر، فيبدأ البريد الجديد يصل إلى السيرفر الجديد مباشرة.
3. بعد التحويل: تشغيل أخير لـ imapsync ينقل ما وصل في الساعات بين آخر تشغيل والتحويل.
4. تصدير التقويم وجهات الاتصال واستيرادهما بالسكربت الذي يجمع المكونات بالمعرف.
5. سكربت التحقق لكل الصناديق، وفحص السلاسل المتكررة، وأي صندوق فيه فرق يدخل قائمة المراجعة.
6. صباح الأحد: الموظفون يفتحون البريد الجديد، والدعم المباشر جاهز، والصناديق القديمة كما هي حتى نهاية فترة الرجوع.

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

ولاحظ أن الترتيب يضع التحويل قبل التشغيل الأخير وليس بعده، والسبب أنك إذا شغلت النسخ الأخير ثم وضعت التحويل، فكل رسالة تصل بين الخطوتين تبقى في المصدر ولا ينقلها أحد. وتذكر أن الموظف سيرسل من السيرفر الجديد منذ الصباح، فسجلات SPF وDKIM يجب أن تشمله قبل ليلة الانتقال، كما شرحنا في [شرح SPF وDKIM وDMARC](https://arabroot.io/articles/%D8%B4%D8%B1%D8%AD-spf-%D9%88-dkim-%D9%88-dmarc-%D9%84%D9%84%D9%85%D8%A8%D8%AA%D8%AF%D8%A6%D9%8A%D9%86/).

## ماذا يرى الموظف صباح الأحد؟ Mail Clients

البريد انتقل، ولكن الموظف لا يرى السيرفر، وإنما يرى برنامجه، وهنا ثلاث حالات. الأولى برنامج Outlook على Windows، وهو يعمل مع Exchange ببروتوكول خاص به MAPI، ومع السيرفر الجديد سيعمل عبر IMAP وSMTP كأي برنامج بريد، والتقويم وجهات الاتصال تحتاج إضافة للمزامنة مع CalDAV وCardDAV كما شرحنا في [مقال التقويم](https://arabroot.io/articles/%D8%A7%D9%84%D8%AA%D9%82%D9%88%D9%8A%D9%85-%D9%88%D8%AC%D9%87%D8%A7%D8%AA-%D8%A7%D9%84%D8%A7%D8%AA%D8%B5%D8%A7%D9%84-caldav-%D9%88-carddav/)، ولن يجد الموظف فيه التقويم المشترك والتفويض كما كان. والثانية Thunderbird أو برنامج البريد في المتصفح الذي يأتي مع سيرفرك، مثل SOGo في mailcow، وهما يعرفان IMAP وCalDAV دون إضافات. والثالثة الهاتف، وبرامج البريد في iPhone وAndroid تعرف IMAP، والتقويم وجهات الاتصال في iPhone تعرف CalDAV وCardDAV مباشرة، وفي Android تحتاج تطبيقاً مثل DAVx⁵.

وفي كل الحالات يجب أن يحذف الموظف الحساب القديم من برنامجه أو يوقفه، والسبب أن البرنامج الذي ما زال متصلاً بـ Exchange سيستمر في إظهار الصندوق القديم، فيرد الموظف من الحساب القديم دون أن ينتبه، وتصل الرسالة من سيرفر المؤسسة القديم الذي نريد إغلاقه. والأفضل أن يجهز الفريق ملفات إعداد جاهزة للبرامج، أو أن يدعم السيرفر الجديد الإعداد التلقائي Autoconfig، فيكتب الموظف عنوانه وكلمة مروره فقط. ولاحظ أن البرنامج يبني فهرس البحث من جديد بعد إضافة الحساب، فالبحث في البريد القديم يكون بطيئاً أو ناقصاً في الساعات الأولى، وقل ذلك في رسالة صباح الأحد قبل أن يفتح أحد تذكرة عنه.

## الأرشفة بعد الإغلاق Retention

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

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

- الاعتماد على رمز خروج imapsync: رأينا صندوقاً لم ينقل منه شيء ورمز الخروج صفر.
- نقل صناديق Gmail دون قرار في التصنيفات: إما مساحة مضاعفة ونتائج بحث مكررة، أو صندوق وارد ناقص.
- التحقق من التقويم بعدد العناصر: العدد كان صحيحاً وأربع سلاسل أسبوعية مفقودة.
- تخطيط وقت النقل بسرعة المختبر: Gmail يحد القراءة بنحو 2500 MB في اليوم، فالصندوق الكبير يحتاج أياماً.
- إعطاء تطبيق OAuth صلاحية كل الصناديق ونسيانه بعد الانتقال.
- نسيان ما لا ينقل: القواعد والرد الآلي والتفويض والتوقيع، فيكتشفها الموظف واحداً بعد الآخر.
- آخر نسخ قبل التحويل: الرسائل التي تصل بين الخطوتين لا تنتقل.

## قائمة تحقق لكل دفعة Checklist

| البند           | جاهز عندما                                                                                |
| --------------- | ----------------------------------------------------------------------------------------- |
| المصادقة        | تطبيق OAuth بصلاحية صناديق الدفعة فقط، والرمز في ملف يجدد                                 |
| خيارات imapsync | \--addheader لكل الصناديق، وخيارات Gmail مع \--folderfirst مقرر لكل قسم                   |
| النسخ المسبق    | اكتمل لكل صناديق الدفعة، والتشغيل الليلي ينقل الفرق                                       |
| المجلدات الخاصة | المرسل والمحذوف يرتبطان بـ Sent وTrash على السيرفر الجديد                                 |
| التقويم         | الاستيراد يجمع المكونات بالمعرف، وكل سلسلة فيها RRULE، والمناطق الزمنية مجربة على الهواتف |
| جهات الاتصال    | العدد في دفتر العناوين يساوي البطاقات في الملف                                            |
| التحقق          | سكربت المعرفات لكل الصناديق دون MISSING                                                   |
| ما لا ينقل      | قائمة القواعد والردود الآلية والتفويضات أرسلت للموظفين، وأعيد إنشاء المهم منها            |
| الإرسال         | SPF وDKIM يشملان السيرفر الجديد قبل الليلة                                                |

## الخلاصة Summary

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

- صندوق البريد ثلاث بيانات: الرسائل تنتقل بـ imapsync عبر IMAP، والتقويم وجهات الاتصال بملفات ics وvcf إلى CalDAV وCardDAV، والقواعد والتفويض والتوقيع لا تنقلها أي أداة.
- Exchange Online لا يقبل كلمة المرور في IMAP، فالنقل يحتاج تطبيق OAuth بصلاحية IMAP.AccessAsApp، وGmail يحد القراءة بنحو 2500 MB في اليوم، ولذلك فالنسخ المسبق ضروري.
- imapsync لا يكرر عند إعادة التشغيل، ونقل الفرق بعد 25 رسالة جديدة أخذ أقل من ثلاث ثوان، وهذا ما يجعل خطة الدفعات ممكنة.
- تصنيفات Gmail صنعت 2170 نسخة لألف رسالة، ومنع التكرار يحفظ كل رسالة في مجلد واحد، والخيار folderfirst يقرر أيها.
- الرسائل دون Message-ID تخطاها imapsync وقال «Detected 0 errors»، فشغل بـ `--addheader` واقرأ سطري void وFinal difference.
- الاجتماعات المتكررة ذات المواعيد المعدلة تحتاج عنصراً واحداً لكل UID، وإلا تختفي السلسلة والعدد يبقى صحيحاً.
- ابحث قبل أول دفعة عن ملفات PST على الأجهزة، والصناديق المشتركة، والعناوين الإضافية، لأن أياً منها لا يظهر في حجم الصندوق ولا في مخرج imapsync، ويظهر فقط عندما يسأل عنه موظف بعد الانتقال.

وفي المقال التالي من المرحلة بإذن الله ننقل الجزء الأكبر حجماً من بيانات المؤسسة: الملفات من OneDrive وSharePoint وGoogle Drive إلى Nextcloud، ومعها الصلاحيات والنسخ، وما لا ينتقل منها.

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

- نوفمبر 2026: كتابة المقال، ونقل صناديق مولدة بنمط Exchange وGmail بـ imapsync 2.326 بين سيرفري Dovecot 2.4.5، واستيراد التقويم وجهات الاتصال إلى Radicale 3.9.0.