S3 Compatible¶
כל שירות שמממש את ה-API של S3 ניתן לעגן ככונן Windows. שדות החיבור תמיד זהים — כתובת נקודת קצה, מזהה מפתח גישה, מפתח גישה סודי ו-Bucket — כך שמדריך אחד זה מכסה את כל משפחת S3.
רבים מהשירותים האלה מופיעים כרשומה משלהם בעלת שם בכרטיסייה Enterprise של RaiDrive (Amazon S3, Cloudflare R2, Wasabi, Backblaze B2, ...). בחר את הרשומה בעלת השם כשהיא קיימת — RaiDrive יודע אז את תבנית נקודת הקצה ואת רשימת האזורים בשבילך. השתמש ברשומה הגנרית S3 Compatible עבור כל דבר אחר, כולל שרתים באירוח עצמי (self-hosted).
לפני שמתחילים¶
הכן מראש את הפרטים הבאים:
- מזהה מפתח גישה ומפתח גישה סודי שהונפקו על ידי השירות — לכל שירות תואם S3 יש עמוד לניהול מפתחות במסוף שלו; עמודי הספקים הייעודיים במקטע הזה אומרים לך בדיוק היכן, לכל שירות בעל שם.
- כתובת נקודת הקצה של S3 של השירות (ראה הטבלה למטה).
- חלק מהשירותים דורשים מזהה נוסף אחד — לדוגמה Cloudflare R2 דורש את מזהה חשבון שלך ו-Oracle דורש את מרחב השמות של אחסון העצמים שלך.
חיבור¶
- לחץ על הוסף בסרגל הכלים.
- בחר Enterprise → השירות בעל השם, או S3 Compatible אם הוא אינו ברשימה.
- עבור הרשומה הגנרית, הקלד את כתובת נקודת הקצה (ואם השירות דורש זאת, את האזור).
- הזן את מזהה מפתח גישה ומפתח גישה סודי, ולאחר מכן לחץ על הלחצן רענן שליד השדה Bucket.
- בחר את ה-Bucket ולחץ על חבר.
הזנה ידנית של Bucket
אם המפתח שלך אינו מורשה להציג את רשימת ה-Bucket-ים, סמן את תיבת הסימון שמימין לשדה Bucket והקלד את שם ה-Bucket ישירות.
טבלת נקודות קצה¶
| שירות | תבנית נקודת הקצה | אזורים |
|---|---|---|
| Akamai Linode | https://<region>.linodeobjects.com |
Use URLs for access |
| Alibaba Cloud | https://oss-<region>.aliyuncs.com |
Regions and endpoints |
| Amazon S3 | https://s3.<region>.amazonaws.com |
Amazon Simple Storage Service endpoints and quotas |
| Backblaze B2 | https://s3.<region>.backblazeb2.com |
Where are the Backblaze Cloud Storage Data Centers |
| Ceph (באירוח עצמי) | כתובת ה-URL של ה-RADOS Gateway שלך | — |
| Cloudflare R2 | https://<account-id>.r2.cloudflarestorage.com |
Data location |
| Cloudian (באירוח עצמי) | כתובת ה-URL של השרת שלך | — |
| DigitalOcean Spaces | https://<region>.digitaloceanspaces.com |
Spaces Availability |
| DreamHost | https://objects-us-east-1.dream.io או https://s3.us-east-005.dream.io (לפי אשכול) |
What DreamObjects hostname should I use to connect? |
| Garage (באירוח עצמי) | כתובת ה-URL של השרת שלך | — |
| IBM Cloud | https://s3.<region>.cloud-object-storage.appdomain.cloud |
Endpoints and storage locations |
| IDrive e2 | https://<host>.<region>.idrivee2-XX.com (מוצג במסוף ה-e2 שלך) |
נקודות קצה לפי אזור |
| IONOS | https://s3.<region>.ionoscloud.com |
Endpoints |
| Leviia | https://s3.<region>.leviia.com |
— |
| MEGA S4 | https://s3.<region>.megas4.com |
MEGA S4 endpoint URLs |
| MinIO (באירוח עצמי) | כתובת ה-URL של השרת שלך | — |
| Naver Cloud Platform | https://<region>.object.ncloudstorage.com — אזור: kr, us, sg, de; jp: https://jp.object.ncpstorage.com |
Object Storage overview |
| Oracle Cloud | https://<namespace>.compat.objectstorage.<region>.oraclecloud.com |
Regions and Availability Domains |
| Storj | https://gateway.storjshare.io (נקודת קצה גלובלית יחידה) |
Storj-hosted S3 Compatible Gateway |
| Synology C2 | https://<region>.s3.synologyc2.net |
How to use development tools with C2 Object Storage |
| Tencent Cloud | https://cos.<region>.myqcloud.com |
Regions and Access Endpoints |
| Wasabi | https://s3.<region>.wasabisys.com |
Service URLs for Wasabi's Storage Regions |
| Scaleway ואחרים | https://s3.<region>.scw.cloud — דרך הרשומה הגנרית S3 Compatible |
Object Storage - Concepts |
הגדרות¶
| הגדרה | תיאור | ברירת מחדל |
|---|---|---|
| נקודת קצה | כתובת ה-API של S3 של השירות | — |
| אזור | אזור האימות; נדרש בחלק מהשירותים (למשל Garage, Scaleway) | ריק |
| מזהה מפתח גישה / מפתח גישה סודי | אישורים שהונפקו על ידי השירות | — |
| Bucket | ה-Bucket לעיגון (מהרשימה או בהזנה ידנית) | — |
| לקריאה בלבד | חוסם כתיבה לכונן המעוגן | כבוי |
התנהגות ומגבלות¶
- RaiDrive מאמת את נקודת הקצה עבור שרתים שמזהים את עצמם: MinIO, Cloudian, Ceph ו-Garage מזוהים לפי תגובות השרת; IDrive e2, Akamai Linode ו-Synology C2 לפי תבנית שם המארח. נקודת קצה שאינה תואמת נדחית כ-"invalid endpoint".
- שרתים באירוח עצמי (MinIO, Cloudian, Ceph, Garage) ניגשים בכתובת מסוג path-style, ותעודות TLS פרטיות/חתומות-עצמית מתקבלות.
- סמנטיקת S3 חלה בכל מקום: אין תיקיות אמיתיות — "תיקיות" הן קידומות של מפתחות — ראה AWS: organizing objects using folders.
פתרון בעיות¶
| תסמין | סיבה | פתרון |
|---|---|---|
| "invalid endpoint" | נקודת הקצה אינה תואמת לשירות שנבחר | בדוק את התבנית בטבלה, או השתמש ברשומה הגנרית S3 Compatible |
| רשימת ה-Bucket-ים ריקה | המפתח אינו יכול להציג רשימת Bucket-ים | השתמש בהזנה ידנית של Bucket |
| שגיאות חתימה / הרשאה | השירות דורש אזור מפורש | מלא את שדה האזור בערך ממסוף השירות שלך |
| שגיאות TLS בשרת ברשת מקומית | תעודה חתומה-עצמית ברשומת שירות ציבורי בעל שם | השתמש ברשומות באירוח עצמי (MinIO/Cloudian/Ceph/Garage) או ב-S3 Compatible |