सामग्री पर जाएँ
ऑराबेस लोगो
aurabase

भंडारण

S3 स्टोरेज (SeaweedFS S3) पर प्रति प्रोजेक्ट REST API, व्युत्पन्न कैश के साथ ऑन-द-फ्लाई छवि परिवर्तन, HMAC हस्ताक्षरित URL, सार्वजनिक या निजी बकेट, ट्रैश और रिस्टोर।

व्याख्या6 मि॰ पढ़ेंस्तर मध्यवर्ती15 अप्रैल 2026 पर संशोधित

यह पृष्ठ स्वचालित रूप से अनुवादित किया गया था. अंग्रेजी संस्करण प्रामाणिक है.

एक बाल्टी, एक मूल, एक सीडीएन#

aura-storage सेवा आपकी बाइनरी फ़ाइलों का प्रबंधन करती है: अपलोड, डाउनलोड, छवि परिवर्तन, हस्ताक्षरित यूआरएल, ट्रैश। यह /v1/storage/{project_id} के अंतर्गत अपने स्वयं के REST API को उजागर करता है और आंतरिक रूप से S3 स्टोरेज (SeaweedFS S3) पर निर्भर करता है - S3 टूल (rclone, boto3) इससे सीधे कनेक्ट नहीं होते हैं।

वस्तुओं को बकेट में व्यवस्थित किया जाता है। प्रत्येक बकेट में एक नीति (सार्वजनिक या निजी), आकार सीमा, एक वैकल्पिक टीटीएल और 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/स्टोरेज/{project_id}/… S3 स्टोरेज पर (सीवीडएफएस S3) - यह S3 एपीआई नहीं है: S3 SDK इसमें प्लग नहीं करते हैं।
  • तुरंत रूपांतरित हो जाता है। चौड़ाई, ऊंचाई, फिट, प्रारूप (जेपीईजी/पीएनजी/वेबपी/जीआईएफ), गुणवत्ता, घुमाएं, फ्लिप करें। प्रत्येक संयोजन को व्युत्पन्न के रूप में कैश किया जाता है।
  • हस्ताक्षरित यूआरएल. HMAC विधि + बकेट + कुंजी + समाप्ति पर हस्ताक्षर। टीटीएल 3600 एस डिफ़ॉल्ट रूप से, प्रति प्रोजेक्ट गुप्त रोटेशन।
  • मल्टीपार्ट अपलोड। मल्टीपार्ट/फॉर्म-डेटा में सरल अपलोड, या बड़ी फ़ाइलों के लिए init/part/complete।
  • कचरा और पुनर्स्थापन। सॉफ्ट डिलीशन: /ट्रैश हटाए गए ऑब्जेक्ट को सूचीबद्ध करता है, /restore/{key} उन्हें पुनर्स्थापित करता है।
  • सार्वजनिक या निजी बाल्टियाँ। बकेट में पहुंच नीति, आकार सीमा और अधिकृत MIME प्रकारों की सूची होती है।

चार बुनियादी ऑपरेशन#

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

// अप्सर्ट के बिना, पहले से ही लिया गया पथ 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());

आगे जाने के लिए#