ابدأ الآن

تخزين الكائنات للملفات والملفات المرفوعة.

تخزين متوافق مع S3 للمشروع: كيف تضيف حاوية (bucket)، ومتغيرات S3_* التي يحصل عليها تطبيقك، وكيف يُسعَّر التخزين والعمليات.

2 دقائق قراءة

يحفظ تخزين الكائنات الملفات خارج تطبيقك: ملفات المستخدمين المرفوعة، والتقارير المُنشأة، والوسائط، ونسخك الاحتياطية الخاصة. يعمل مع أي مكتبة أو أداة تدعم بروتوكول S3 — حزم AWS SDK، وقرص s3 في Laravel، وdjango-storages، وboto3، وrclone وغيرها الكثير.

إضافة تخزين

من التطبيق: نظرة عامة ← الخدمات ← تخزين الكائنات ← إضافة تخزين. امنح الحاوية اسمًا — أحرف لاتينية صغيرة وأرقام وشرطات، يبدأ بحرف — ثم أكّد. تصبح الحاوية جاهزة خلال لحظات.

يمكن أن يضم المشروع حتى 3 حاويات.

المتغيرات التي يحصل عليها تطبيقك

تُضاف بيانات الوصول إلى متغيرات المشروع تلقائيًا؛ ويلتقطها التطبيق مع نشره التالي:

المتغيرما هو
S3_ENDPOINTعنوان التخزين
S3_REGIONالمنطقة التي تستخدمها في عميل S3
S3_BUCKETاسم الحاوية
S3_KEYمفتاح الوصول
S3_SECRETالمفتاح السري

يعمل المفتاح مع هذه الحاوية فقط. وتحصل الحاوية الثانية في المشروع على متغيراتها مسبوقة باسمها: <NAME>_S3_ENDPOINT و<NAME>_S3_BUCKET وهكذا.

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

مثال: Laravel

في config/filesystems.php، وجّه قرص s3 إلى المتغيرات:

's3' => [
    'driver' => 's3',
    'key' => env('S3_KEY'),
    'secret' => env('S3_SECRET'),
    'region' => env('S3_REGION'),
    'bucket' => env('S3_BUCKET'),
    'endpoint' => env('S3_ENDPOINT'),
    'use_path_style_endpoint' => true,
],

ثم اضبط FILESYSTEM_DISK=s3 في تبويب المتغيرات.

مثال: Node.js

import { S3Client } from '@aws-sdk/client-s3'
 
const s3 = new S3Client({
  endpoint: process.env.S3_ENDPOINT,
  region: process.env.S3_REGION,
  credentials: { accessKeyId: process.env.S3_KEY, secretAccessKey: process.env.S3_SECRET },
})

السعر

السعر
التخزين0.025 US$ لكل GB شهريًا
حركة المرورمجانية — التنزيل من التخزين لا يكلّف شيئًا
عمليات الكتابة6 US$ لكل مليون عملية
عمليات القراءة0.50 US$ لكل مليون عملية

يُقاس التخزين كل يوم ويُحسب متوسطه على مدى الشهر، فالملف المحفوظ نصف شهر يكلّف النصف. ويُضاف استخدام الشهر الميلادي إلى الدفعة التالية للمشروع كبند واحد؛ ولا يوجد اشتراك منفصل.

نقل الملفات إليه

يمكن نقل الملفات الموجودة في Amazon S3 أو Google Cloud Storage أو تخزين آخر متوافق مع S3 أو مجلد على خادمك إلى حاوية — دفعة واحدة، أو تدريجيًا دون توقف. راجع نقل الملفات إلى تخزين الكائنات.

حذف حاوية

حذف الحاوية يزيل كل الملفات الموجودة فيها؛ ولا يمكن استعادتها، وتُزال متغيراتها من المشروع. حذف الحاوية متاح لمالك الحساب ولمسؤولي التطبيق.

ما زلت تحتاج إلى مساعدة؟

تحدّث معنا — يجيب AI فورًا وينضم مهندس عند الحاجة، في أي وقت من اليوم.

تواصل مع الدعم