חיבור 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.