انتقل إلى المحتوى
شعار أوراباسي
aurabase

التخزين

REST API لكل مشروع على مساحة تخزين S3 (SeaweedFS S3)، وتحويلات الصور أثناء التنقل باستخدام ذاكرة التخزين المؤقت المشتقة، وعناوين URL الموقعة HMAC، والمجموعات العامة أو الخاصة، والمهملات والاستعادة.

شرح6 د قراءةالمستوى وسيطةتمت المراجعة في 15‏/04‏/2026

تمت ترجمة هذه الصفحة تلقائيًا. النسخة الإنجليزية موثوقة.

دلو واحد، أصل واحد، CDN واحد#

تدير خدمة aura-storage ملفاتك الثنائية: التحميل والتنزيل وتحويلات الصور وعناوين URL الموقعة والمهملات. إنه يعرض REST API الخاص به ضمن /v1/storage/{project_id} ويعتمد على تخزين S3 (SeaweedFS S3) داخليًا - أدوات S3 (rclone، boto3) لا تتصل به مباشرة.

يتم تنظيم الكائنات في مجموعات . تحتوي كل مجموعة على سياسة (عامة أو خاصة)، وحدود الحجم، وTTL اختيارية، ومجموعة من سياسات RLS التي تتحكم في من يمكنه قراءة/كتابة كل مسار.

معلومات

البيانات التعريفية موجودة في مخطط المشروع: storage_buckets, storage_objects, storage_derivatives, storage_project_settings, storage_audit_log. البايتات موجودة في مساحة تخزين S3.

المسار → RLS → CDN → الأصل#

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

schematext
                              ┌──── derivative cache ────┐
   GET /v1/storage/{pid}/… ─▶ │ derivative cached?       │
                              │ no  ⇢ origin             │
                              └──────────┬───────────────┘
                                         │
                              ┌──────────▼───────────────┐
                              │ aura-storage             │
                              │  ─ access control        │
                              │  ─ transforms            │
                              │  ─ derivative cache      │
                              └──────────┬───────────────┘
                                         │
                                  S3 storage (SeaweedFS S3)

ست قدرات أصلية#

  • REST API لكل مشروع. المسارات /v1/storage/{project_id}/... على تخزين S3 (SeaweedFS S3) - هذه ليست واجهة برمجة التطبيقات S3: S3 لا يتم توصيل SDKs بها.
  • يتحول بسرعة. العرض، الارتفاع، الملاءمة، التنسيق (jpeg/png/webp/gif)، الجودة، التدوير، الوجه. يتم تخزين كل مجموعة مؤقتًا كمشتق.
  • عناوين URL الموقعة. HMAC التوقيع على الطريقة + الجرافة + المفتاح + انتهاء الصلاحية. TTL 3600 ثانية بشكل افتراضي، التناوب السري لكل مشروع.
  • تحميل متعدد الأجزاء. تحميل بسيط في بيانات متعددة الأجزاء/النموذج، أو init/part/Complete للملفات الكبيرة.
  • سلة المهملات والترميم. الحذف البسيط: /trash يسرد الكائنات المحذوفة، /restore/{key} يستعيدها.
  • الدلاء العامة أو الخاصة. يحمل الجرافة سياسة الوصول وحدود الحجم وقائمة أنواع MIME المعتمدة.

أربع عمليات أساسية#

avatar.tstypescript
const { data, error } = await aura.storage.upload('avatars', `${user.id}/${file.name}`, file, {
    contentType: file.type,
    upsert: true,
})

// بدون upsert، يفشل المسار المشغول بالفعل في 409 (رمز CONFLICT)
نصيحة

عناوين URL للتحويل غير قابلة للتغيير بواسطة المعلمات. ?width=240&format=png و?width=240&format=webp هما عنوانا URL مختلفان، وبالتالي مشتقان مختلفان: يتم حساب كل مجموعة مرة واحدة فقط، ثم يتم إعادة قراءتها من ذاكرة التخزين المؤقت المشتقة.

RLS على مسارات الكائنات#

توجد بيانات تعريف الكائن في جدول storage_objects لمخطط المشروع (الأعمدة bucket_name, key, owner_id, metadata, deleted_at)، مع تمكين RLS. لا يوجد مخطط storage ولا وظيفة storage.foldername(): السياسات مكتوبة على الأعمدة.

السياسات المقدمة بشكل افتراضيsql
-- القراءة: كائن خاص، أو أي كائن من مجموعة عامة
create policy storage_objects_select on storage_objects for select
  using (
    owner_id = auth.uid()
    or exists (select 1 from storage_buckets b
                  where b.name = storage_objects.bucket_name and b.public)
  );

-- الكتابة: الأشياء الخاصة بك فقط
create policy storage_objects_insert on storage_objects for insert
  with check (owner_id = auth.uid());

للذهاب أبعد من ذلك#