ربط TrekMail Drive مع rclone عبر WebDAV

rclone أداة لسطر الأوامر تعمل مع WebDAV. تفيد في عمليات الرفع والتنزيل وعرض القوائم والنسخ الاحتياطي المجدول عبر البرامج النصية. قبل الاعتماد عليها في مهمة كبيرة، اختبر رفع ملف صغير وتنزيله أولا. يقبل TrekMail Drive ملفات يصل حجمها إلى 10 TB، وفقا لمساحة التخزين المتاحة وحدود إصدار rclone والكمبيوتر المستخدم.

تفاصيل الاتصال

يحتاج إعداد rclone إلى ما يلي:

استخدم rclone obscure dsync_… عند كتابة كلمة المرور يدويا في ملف إعداد. يخفي rclone شكلها لكنه لا يشفرها، لذلك يستطيع أي شخص يملك الملف استخدام بيانات الاعتماد.

إذا لم تنشئ كلمة مرور جهاز بعد، فابدأ باتباع Sync devices.

قبل البدء

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

1. افتح Sync devices في لوحة تحكم TrekMail.
2. انقر على + Add new device.
3. امنحه اسما، مثل Laptop, rclone.
4. اترك View files وEdit files محددين إذا كان rclone يحتاج إلى رفع الملفات أو نقلها أو حذفها. للوصول المخصص للتنزيل، حدد View files فقط.
5. انقر على Generate password وانسخ كلمة المرور (dsync_...).

يتطلب النسخ الاحتياطي إلى Drive صلاحية Edit files. أما الاستعادة بالتنزيل فقط من Drive فتحتاج إلى View files وحدها.

تثبيت rclone

• macOS: brew install rclone
• Linux: curl https://rclone.org/install.sh | sudo bash
• Windows: نزّل البرنامج من rclone.org/downloads وأضفه إلى PATH.

إعداد remote

شغّل أداة الإعداد التفاعلية:

rclone config

ثم اتبع الخطوات التالية:

1. أدخل n لإنشاء remote جديد.
2. سمّه trekmail-drive أو اختر أي اسم.
3. اختر WebDAV من القائمة. يتغير الرقم حسب الإصدار، فابحث عن كلمة "Webdav".
4. URL: ألصق Drive server URL من صفحة Sync devices، مع إبقاء الشرطة المائلة الأخيرة.
5. Vendor: اختر other.
6. User: ألصق اسم المستخدم الظاهر في الصفحة نفسها.
7. Password: اختر y (yes, type my own password)، ثم ألصق كلمة مرور الجهاز dsync_....
8. Bearer token: اتركه فارغا.
9. Edit advanced config: أدخل n.
10. Confirm: أدخل y.

يمكنك أيضا كتابة ملف الإعداد مباشرة. افتح ~/.config/rclone/rclone.conf وأضف:

[trekmail-drive]
type = webdav
url = <copy the Drive server URL from Sync devices>
vendor = other
user = you@example.com
pass = <obscured-password>

أنشئ كلمة المرور المخفية باستخدام rclone obscure dsync_....

الأوامر اليومية

عرض الملفات

rclone ls trekmail-drive:
rclone lsd trekmail-drive:        # directories only

رفع ملف

rclone copy ./backup.zip trekmail-drive:Backups/

تمنع نقطة النهاية هذه rclone عمدا من استبدال ملف موجود في Drive داخل موقعه. استخدم اسما أو مجلدا جديدا للوجهة، مثل مجلد نسخ احتياطي مؤرخ. إذا احتاج الأمر إلى الكتابة فوق ملف، فنزّل النسخة الحالية أولا أو ارفع البديل عبر واجهة Drive.

رفع مجلد في اتجاه واحد مع عرض التقدم

rclone copy ./Documents trekmail-drive:Documents \
  --progress --transfers 8

يطلب --transfers 8 من rclone رفع ما يصل إلى ثمانية ملفات بالتوازي. ابدأ بقيمة صغيرة ولا ترفعها إلا بعد نجاح اختبار.

تتطلب أوامر النسخ المتطابق عناية خاصة

rclone sync ./Documents trekmail-drive:Documents --progress

تنبيه: يحذف sync الملفات البعيدة غير الموجودة محليا، ويتوقع عادة تحديث الملفات القائمة. لا تستخدمه مع بيانات Drive في بيئة الإنتاج قبل اختبار سلوكه الدقيق على مجلد مؤقت. للنسخ الاحتياطي العادي، فضّل copy إلى مجلد جديد مؤرخ.

التركيب كمجلد

mkdir ~/trekmail
rclone mount trekmail-drive: ~/trekmail \
  --vfs-cache-mode writes --daemon

يظهر Drive بعد ذلك باسم ~/trekmail. ويمكن لأدوات لا تدعم WebDAV، مثل Photos وLightroom، استخدامه كمجلد محلي عادي.

إلغاء التركيب

fusermount -u ~/trekmail           # Linux
umount ~/trekmail                  # macOS

النسخ الاحتياطي المجدول

في Linux أو macOS، أضف إلى crontab (crontab -e):

# Back up ~/Documents nightly at 2 AM
0 2 * * * /usr/local/bin/rclone copy ~/Documents trekmail-drive:Documents --quiet

في Windows، استخدم Task Scheduler لتشغيل أمر rclone copy نفسه.

ضبط عمليات النقل الكبيرة

للملفات الكبيرة، مثل مقاطع الفيديو ومجموعات البيانات متعددة GB:

rclone copy ./big.iso trekmail-drive:ISOs/ \
  --transfers 4 \
  --multi-thread-streams 4 \
  --buffer-size 64M \
  --progress

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

حل المشكلات

• 401 Unauthorized: كلمة المرور خاطئة أو ملغاة. أنشئ كلمة جديدة في Sync devices.
• 403 أو خطأ صلاحيات: تأكد من أن كلمة مرور الجهاز تملك صلاحية Edit files عند رفع الملفات أو تغييرها. أنشئ كلمة جديدة عند الحاجة.
• 429 Too Many Requests أو أخطاء اتصال متكررة: اخفض --transfers وانتظر قليلا، ثم أعد تنفيذ أمر صغير قبل استئناف المهمة.
• 507 Insufficient Storage: مجمع Drive ممتلئ. غيّر حجم Add-on أو أفرغ Trash.
• يعرض المجلد المركب ملفات قديمة: امسح ذاكرة rclone المؤقتة بخيارات rclone mount و--vfs-cache-mode writes --dir-cache-time 1m.

للمشكلات الأوسع في المزامنة، راجع حل مشكلات Drive Sync.