نقل الملفات إلى تخزين الكائنات.
انقل الملفات من Amazon S3 أو Google Cloud Storage أو أي تخزين متوافق مع S3 أو من مجلد على خادمك إلى حاوية: انسخ كل شيء دفعة واحدة، أو انقل تدريجيًا دون توقف.
هل تحفظ ملفاتك في مكان آخر؟ انقلها إلى حاوية في تطبيقك بإحدى طريقتين. تبدأ كلتاهما من لوحة التحكم: التطبيق ← التخزين ← الحاوية ← نقل الملفات إليها.
| نسخ كل شيء الآن | النقل التدريجي دون توقف | |
|---|---|---|
| ما الذي يحدث | تُنسخ كل الملفات دفعة واحدة | يُنسخ الملف في أول مرة يقرؤه فيها تطبيقك |
| متى تحوّل تطبيقك | بعد اكتمال النسخ | فورًا |
| التقدم | الملفات التي عُثر عليها ونُسخت وتُخطيت ولم تُنسخ؛ إيقاف مؤقت واستئناف وإيقاف | يعمل حتى توقفه |
| التخزين القديم | Amazon S3 وGoogle Cloud Storage والمتوافق مع S3 | Amazon S3 وGoogle Cloud Storage |
يعمل النسخ من جهتنا — لا يلزم أن يبقى حاسوبك قيد التشغيل. عند انتهائه (أو إذا توقف قبل النهاية) تصلك رسالة بريد إلكتروني ورسالة Telegram.
نقل الملفات متاح لمالك الحساب ولمسؤولي التطبيق (راجع وصول الفريق)، وكذلك عبر API وCLI وMCP.
قبل أن تبدأ: مفتاح للقراءة فقط
أنشئ في التخزين القديم مفتاحًا منفصلًا لهذا النقل لا يستطيع إلا عرض محتويات تلك الحاوية وقراءتها. لا تلصق مفاتيحك الرئيسية أبدًا. يُستخدم المفتاح لهذا النقل فقط، ولا نحتفظ به، ولا يُعرض مجددًا. احذفه لدى المزود القديم بعد انتهاء النقل.
Amazon S3
في IAM، أنشئ مستخدمًا (أو دورًا مع مفتاح وصول) بهذه السياسة — استبدل my-old-bucket باسم حاويتك:
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": ["s3:List*", "s3:Get*"],
"Resource": ["arn:aws:s3:::my-old-bucket", "arn:aws:s3:::my-old-bucket/*"]
}
]
}ثم أنشئ له مفتاح وصول. تحتاج في لوحة التحكم إلى معرّف مفتاح الوصول ومفتاح الوصول السري واسم الحاوية ومنطقتها (مثل eu-central-1، وتظهر بجانب الحاوية في وحدة تحكم S3).
Google Cloud Storage
أنشئ حساب خدمة بصلاحية قراءة الحاوية ونزّل مفتاح JSON الخاص به:
gcloud iam service-accounts create rivervo-move --display-name="Move files to Rivervo"
gcloud storage buckets add-iam-policy-binding gs://my-old-bucket \
--member="serviceAccount:rivervo-move@MY-PROJECT.iam.gserviceaccount.com" --role="roles/storage.objectViewer"
gcloud storage buckets add-iam-policy-binding gs://my-old-bucket \
--member="serviceAccount:rivervo-move@MY-PROJECT.iam.gserviceaccount.com" --role="roles/storage.legacyBucketReader"
gcloud iam service-accounts keys create key.json \
--iam-account="rivervo-move@MY-PROJECT.iam.gserviceaccount.com"يقرأ Storage Object Viewer الملفات، ويتيح Storage Legacy Bucket Reader لعملية النسخ قراءة الحاوية نفسها. الصق في لوحة التحكم محتوى key.json كاملًا. واحذف ملف المفتاح من حاسوبك بعد ذلك.
تخزين آخر متوافق مع S3
يعمل أي تخزين لديه S3 API بالطريقة نفسها: أنشئ مفتاحًا لا يستطيع إلا عرض محتويات الحاوية وقراءتها (يسميه معظم المزودين مفتاح «read-only» أو «restricted»)، وابحث عن عنوان S3 لمنطقة الحاوية — مثل https://s3.eu-central-003.backblazeb2.com. أدخل العنوان دون اسم الحاوية.
نسخ كل شيء الآن
- التطبيق ← التخزين ← الحاوية ← نقل الملفات إليها.
- اختر نسخ كل شيء الآن، والتخزين القديم، والحاوية فيه، والمنطقة أو عنوان S3، والصق المفتاح.
- اختياري: مجلد — لنسخ
photos/فقط مثلًا. - الملفات الموجودة هنا مسبقًا: افتراضيًا، يُحتفظ بالملف الموجود في الحاوية بالاسم نفسه ويُتخطى الملف القادم من التخزين القديم. فعّل استبدالها للكتابة فوقها.
- بدء النسخ وأكّد.
تعرض البطاقة عدد الملفات التي عُثر عليها ونُسخت وتُخطيت ولم تُنسخ، مع شريط تقدم، ويذكر عرض السجل الملفات التي تُخطيت أو تعذّر نسخها. يمكنك الإيقاف المؤقت أو الاستئناف أو إيقاف النسخ — وتبقى الملفات المنسوخة. بعد اكتمال النسخ، حوّل تطبيقك إلى الحاوية (لديه مسبقًا متغيرات S3_*).
تحتفظ الملفات بأسمائها (مفاتيحها). وتشغيل النسخ مجددًا لاحقًا ينسخ ما هو ناقص فقط (عندما يكون استبدالها متوقفًا).
النقل التدريجي دون توقف
مفيد عندما يجب أن يستمر التطبيق في العمل وتُضاف الملفات باستمرار:
- نقل الملفات إليها ← النقل التدريجي دون توقف، والتخزين القديم والحاوية والمفتاح ← تفعيل النقل التدريجي.
- حوّل تطبيقك إلى هذه الحاوية فورًا (متغيرات
S3_*الخاصة بها) وانشر. - عندما يقرأ التطبيق ملفًا غير موجود في الحاوية بعد، يُنسخ من التخزين القديم في تلك اللحظة ويُقدَّم. وتذهب الملفات المرفوعة الجديدة مباشرةً إلى الحاوية.
- للإنهاء: شغّل نسخ كل شيء الآن للملفات التي لم يقرأها أحد بعد (مع إيقاف استبدالها لتبقى الملفات الأحدث)، وانتظر حتى يكتمل، ثم إيقاف النقل التدريجي.
إلى أن توقفه، يجب أن يبقى التخزين القديم متاحًا بالمفتاح نفسه. والملفات التي لم تُقرأ قط ولم تُنسخ لا تُجلب بعد إيقافه.
من مجلد على خادمك
لنقل الملفات من VPS أو أي خادم آخر (مثل storage/app/public في موقع Laravel)، استخدم rclone بمفاتيح الحاوية نفسها. تجدها في علامة التبويب المتغيرات في التطبيق: S3_ENDPOINT وS3_BUCKET وS3_KEY وS3_SECRET (الحاوية الثانية يسبقها اسمها: MEDIA_S3_KEY …).
# تثبيت rclone (Linux)
curl https://rclone.org/install.sh | sudo bash
# مفاتيح الحاوية كمتغيرات بيئة — لا تُحفظ في ملف إعدادات
export RCLONE_CONFIG_RIVERVO_TYPE=s3
export RCLONE_CONFIG_RIVERVO_PROVIDER=Other
export RCLONE_CONFIG_RIVERVO_REGION=auto
export RCLONE_CONFIG_RIVERVO_ENDPOINT='قيمة S3_ENDPOINT'
export RCLONE_CONFIG_RIVERVO_ACCESS_KEY_ID='قيمة S3_KEY'
export RCLONE_CONFIG_RIVERVO_SECRET_ACCESS_KEY='قيمة S3_SECRET'
# نسخ المجلد إلى الحاوية (قيمة S3_BUCKET) مع الحفاظ على بنية المجلدات
rclone copy /var/www/shop/storage/app/public rivervo:BUCKET/public --progress --transfers 16
# التحقق من وصول كل الملفات
rclone check /var/www/shop/storage/app/public rivervo:BUCKET/public --one-wayلا يحذف rclone copy أي شيء في الحاوية أبدًا، ويتخطى الملفات الموجودة فيها دون تغيير، لذا يمكنك تشغيله مجددًا بعد انقطاع. شغّله داخل tmux أو screen على الخادم للنسخ الطويل — فيستمر حتى إذا انقطع اتصال SSH.
التكلفة
لا رسوم على النقل نفسه. تُحتسب الملفات في الحاوية بـ أسعار تخزين الكائنات المعتادة، وتُدفع من رصيدك:
- التخزين: 0.025 US$ لكل GB شهريًا — تكلف 50 GB نحو 1.25 US$ شهريًا؛
- الكتابة: 6.00 US$ لكل مليون — كل ملف منسوخ يعادل نحو عملية كتابة واحدة، فتكلف 100 000 ملف نحو 0.60 US$ (الملف الكبير جدًا يُرفع على أجزاء ويُحتسب بعدة عمليات كتابة)؛
- القراءات أثناء النقل التدريجي قراءات عادية (0.50 US$ لكل مليون).
يفرض معظم مزودي التخزين السحابي رسومًا على البيانات الخارجة منهم (egress). راجع قائمة أسعار مزودك القديم قبل نقل كمية كبيرة من البيانات.
يتطلب نقل الملفات رصيدًا موجبًا، كما هو الحال عند إضافة حاوية. وهو غير متاح خلال التجربة المجانية، ولا إلى حاوية للقراءة فقط (تجاوزت حد حجمها، أو تجاوزت ما يغطيه الرصيد) — وتوضح لوحة التحكم السبب وتعرض شحن الرصيد حيث يفيد ذلك. إذا أصبحت الحاوية للقراءة فقط أثناء النسخ، يتوقف النسخ مؤقتًا ثم يستأنف تلقائيًا بمجرد أن تصبح الكتابة ممكنة مجددًا.
الحدود
- عملية نسخ واحدة ونقل تدريجي واحد في وقت واحد لكل حاوية.
- تتخطى عملية النسخ الملفات الأكبر من 1 TB.
- تُتخطى الملفات في فئات الأرشفة التي يجب استعادتها قبل القراءة (S3 Glacier Flexible Retrieval وGlacier Deep Archive)، فاستعدها أولًا.
- تنتقل مع الملف بياناتك الوصفية الخاصة فقط (
x-amz-meta-*)، وقد يختلف ETag للملف عن القديم. - الملف المحذوف من الحاوية أثناء تفعيل النقل التدريجي يُنسخ مجددًا في المرة التالية التي يُقرأ فيها.