تصفّح Civo Object Storage عبر S3 على macOS.
نقطة النهاية الإقليمية، وإعدادات عاملة لـ s3cmd وrclone وAWS CLI، وما يفعله العميل الأصلي بشكل مختلف.
يتحدث Civo Object Storage بلغة S3، فأي عميل S3 تقريبًا يستطيع التخاطب معه متى صحّ أمران: نقطة نهاية المنطقة التي يقع فيها المتجر، وبيانات اعتماد أُنشئت في المنطقة نفسها. تشرح وثائق Civo نفسها s3cmd وتترك بقية الأدوات لك. هذه الصفحة تعطيك الإعداد الخام لـ s3cmd وrclone وAWS CLI، ثم تعرض المسار الذي يسلكه CivoCloudManager، وهو قراءة نقطة النهاية ومفاتيح الوصول مباشرة من Civo API فلا يبقى شيء تضبطه بيدك.
ضبط عميل S3 لـ Civo
-
01
اعرف نقطة النهاية الخاصة بمنطقتك.
تبني Civo نقاط نهاية المتاجر على الشكل
https://objectstore.<region>.civo.comمع رمز المنطقة بحروف صغيرة، فمتجر في لندن يُوصل عبرhttps://objectstore.lon1.civo.comوآخر في فرانكفورت عبرhttps://objectstore.fra1.civo.com. وكل متجر يطبع نقطة نهايته في لوحة Civo ويعيدها في حقلobjectstore_endpointفي REST API. وبحسب نظرة Civo العامة على ميزات المناطق، تتوفر المتاجر في LON1 وFRA1 وNYC1 وMUM1، ولا تتوفر في PHX1. -
02
أنشئ بيانات اعتماد في المنطقة نفسها.
كل Object Store في Civo خاص ويحتاج معرّف مفتاح وصول ومفتاحًا سريًا. أنشئ بيانات الاعتماد في لوحة Civo تحت Object Stores ومنتقي المنطقة مضبوط على منطقة المتجر، أو عبر Civo CLI. والأمر civo objectstore credential export
-a<access_key>يطبع الزوج بصيغةAWS_ACCESS_KEY_IDوAWS_SECRET_ACCESS_KEY وAWS_DEFAULT_REGION وAWS_HOST، جاهزة للصق في الصدفة. -
03
s3cmd: الحقلان host_base وhost_bucket.
في
~/.s3cfg، تحت [default]، اضبطhost_base=objectstore.fra1.civo.comوhost_bucket =objectstore.fra1.civo.comوbucket_location = fra1 وuse_https = True وsignature_v2 = False، إضافة إلىaccess_keyوsecret_key. وإعطاءhost_bucketالاسم المضيف نفسه الذي فيhost_baseيبقي s3cmd على العنونة بنمط المسار، وهو ما تجيب عليه Civo. بعدها يسرد s3cmd ls متاجرك، وs3cmd ls s3://STORENAME يسرد واحدًا، وs3cmd put file.tar s3://STORENAME/backups/ يرفع، وs3cmd get-rs3://STORENAME/backups/ ينزّل بادئة كاملة. ومن دون ملف إعدادات تذهب القيمتان نفساهما إلى سطر الأوامر كـ--host=و--host-bucket=. -
04
rclone: بعيد من نوع s3 ومزود Other.
شغّل rclone config واختر s3، أو اكتب الكتلة في
~/.config/rclone/rclone.confمباشرة: تحت [civo] اضبط type = s3 وprovider = Other وenv_auth = false وaccess_key_id وsecret_access_key من بيانات الاعتماد، وregion = fra1، وendpoint =https://objectstore.fra1.civo.com، وacl = private. بعدها يسرد rclone lsd civo: المتاجر، وrclone ls civo:STORENAME يسرد الملفات، وrclone copy ./dir civo:STORENAME/dir -P يزامن مجلدًا صعودًا مع تقدم مرئي، وrclone ncdu civo:STORENAME يعطيك متصفحًا نصيًا. والإعدادات نفسها تعمل كرايات لمرة واحدة:--s3-providerOther--s3-endpointhttps://objectstore.fra1.civo.com--s3-regionfra1. -
05
AWS CLI: الراية --endpoint-url مع كل استدعاء.
لا تحتاج AWS CLI أي إضافة خاصة بـ Civo، بل نقطة النهاية في كل أمر: aws s3 ls
--endpoint-urlhttps://objectstore.fra1.civo.com، ثم aws s3 ls s3://STORENAME--endpoint-url... وaws s3 cp file.tar s3://STORENAME/--endpoint-url... . وتأتي بيانات الاعتماد منAWS_ACCESS_KEY_IDوAWS_SECRET_ACCESS_KEY أو من ملف تعريف مسمى، مع ضبطAWS_DEFAULT_REGIONعلى رمز منطقة Civo كي يطابق نطاق Signature V4. وهامش للإصدارات الحديثة: تضيف AWS CLI 2.23 وما بعدها مجموع تحقق CRC64NVME إلى عمليات الرفع افتراضيًا، وليست كل نقطة نهاية متوافقة مع S3 تقبله، فإن فشل رفع بخطأ مجموع تحقق اضبط AWS_REQUEST_CHECKSUM_CALCULATION=when_required وAWS_RESPONSE_CHECKSUM_VALIDATION=when_required.
المصيدة التي تكلفك ساعة: المفاتيح مقيدة بمنطقة واحدة
وثائق Civo صريحة في جملتين يسهل تجاوزهما بالنظر: المتاجر خاصة بالمناطق، وبيانات الاعتماد لإدارة المتاجر والوصول إليها مرتبطة بالمنطقة التي أُنشئت فيها. مفتاح صُنع واللوحة على FRA1 لن يُصادق عليه مقابل نقطة نهاية LON1، رغم أنه الحساب نفسه والفوترة نفسها. والعرض خطأ مصادقة أو توقيع يشبه خطأ مطبعيًا في المفتاح السري، فيكون رد الفعل الطبيعي إعادة توليد المفتاح، وهو ما ينتج مفتاحًا آخر في المنطقة الخاطئة نفسها. راجع منتقي المنطقة أولًا، وأنشئ بيانات الاعتماد بجوار المتجر، ثم بعد ذلك فقط اشتبه بالإعدادات.
ما لا يغطيه سطر الأوامر
للسكربتات والنسخ الاحتياطي وCI، تبقى s3cmd وrclone وAWS CLI الجواب الصحيح ولا شيء هنا يحل محلها. أما ما لا تعطيك إياه فهو نظرة إلى المتجر: شجرة مجلدات، وأحجام تراها بلمحة، وتحديد تسحبه خارجًا. عملاء S3 العامون على Mac مثل Cyberduck أو Transmit يسدّون تلك الفجوة، لكنهم لا يعرفون شيئًا عن Civo، فتدخل نقطة النهاية وتلصق المفتاحين لكل متجر وتبقيهما متزامنين بيدك كلما دُوِّرت بيانات اعتماد.
مسار التطبيق: لا نقطة نهاية تدخلها أصلًا
يصادق CivoCloudManager مرة واحدة بمفتاح Civo API ويقرأ قائمة Object Stores من Civo REST API v2، وهي تحمل أصلًا نقطة النهاية وبيانات الاعتماد المرتبطة بكل متجر. ومن ذلك يبني عميل S3، فلا حقل نقطة نهاية ولا لصق مفاتيح ولا ملف إعدادات. وطبقة S3 هي Swift خالصة: AWS Signature V4 محسوبة بـ HMAC-SHA256 من CryptoKit، بلا AWS SDK وبلا Electron. تقوم بـ ListObjects v2 مع رموز المتابعة، وتنقّل بمسار تنقل فوق البادئات المشتركة، وتحديد متعدد، وتنزيل مجلدات بشكل متكرر مع سطر تقدم متحرك. وبصراحة عن شكلها: المتصفح يقرأ وينزّل. أما الرفع والحذف فيبقيان لـ s3cmd أو rclone. ويتطلب التطبيق macOS 15 أو أحدث.
مفاتيح الوصول خلف Touch ID بدل ملف مخفي
هذا الجزء يستحق التثبيت وحده حتى لو أبقيت الـ CLI. إعداد s3cmd عامل يعني أن المفتاح السري يجلس في ~/.s3cfg كنص صريح، والأمر نفسه ينطبق على rclone.conf و~/.aws/credentials. وأي عملية تعمل باسم مستخدمك تستطيع قراءة الثلاثة، وكذلك أي شيء يمشي في مجلدك الشخصي. يحفظ CivoCloudManager مفتاح Civo API في macOS Keychain، وكشف مفتاح الوصول السري لأي Object Store في الواجهة يتطلب Touch ID أو كلمة سر النظام أولًا. والحد واضح ويستحق القول: لحظة نسخك مفتاحًا إلى الطرفية، يعود ملفًا بنص صريح.
الإيقاف والاستئناف للمتاجر التي لا تستخدمها
المتجر الخامل يظل يُحتسب عليك بحجمه المخصص. ينسخ الإيقاف كل ملف إلى Object Store مركزي اسمه civo-cloud-manager، ويوسّع تلك الخزنة أولًا إن لم تتسع البيانات، ويقارن المفاتيح والأحجام المنسوخة بالمصدر، ولا يحذف المتجر الأصلي إلا حين تتطابق. فيختفي البند من فاتورة Civo. ويعيد الاستئناف إنشاء المتجر بالاسم نفسه وبيانات الاعتماد نفسها، وينسخ الملفات عائدة، ويتحقق من المفاتيح والأحجام من جديد، ثم يفرّغ الخزنة. وتتحرك أربعة ملفات في وقت واحد على الأكثر. والحدود الصريحة: التحقق يقارن الأسماء والأحجام لا تجزئة المحتوى، والنقل يخزّن الملفات كاملة في الذاكرة، وملف manifest البعيد يُكتب بعد حذف المصدر، مع manifest محلي كبديل احتياطي.
أي عميل لأي مهمة
الأربعة يتحدثون إلى S3 API نفسها على نقطة النهاية نفسها. والفرق في مكان الإعدادات، وأين ينتهي المفتاح السري، وما الذي تستطيع رؤيته.
| المهمة | s3cmd | rclone | AWS CLI | CivoCloudManager |
|---|---|---|---|---|
| إعداد نقطة النهاية | host_base وhost_bucket في ~/.s3cfg | endpoint داخل البعيد | --endpoint-url مع كل استدعاء | تُقرأ من Civo API |
| أين ينتهي المفتاح السري | ~/.s3cfg، نص صريح | rclone.conf، نص صريح | ~/.aws/credentials، نص صريح | macOS Keychain، وTouch ID للكشف |
| تصفح متجر بصريًا | لا | rclone ncdu، بوضع نصي | لا | نعم، متصفح ملفات بمسار تنقل |
| رفع الملفات وحذفها | نعم | نعم | نعم | ليس في المتصفح |
| تنزيل مجلد بشكل متكرر | s3cmd get -r | rclone copy | aws s3 cp --recursive | نعم، مع تقدم مرئي |
| إيقاف متجر خامل للتوقف عن الدفع | لا | لا | لا | نعم، خزنة مع تحقق قبل الحذف |
| يعمل في CI | نعم | نعم | نعم | لا، هو تطبيق Mac |
Civo Object Storage عبر S3، بإجابات
- ما عنوان نقطة نهاية Civo Object Storage؟
- تتبع نقاط نهاية متاجر Civo النمط
https://objectstore.<region>.civo.comمع رمز المنطقة بحروف صغيرة، مثلhttps://objectstore.lon1.civo.comفي لندن أوhttps://objectstore.fra1.civo.comفي فرانكفورت. وتعتمد نقطة النهاية على المنطقة التي أُنشئ فيها المتجر. وكل متجر يعرض نقطة نهايته في لوحة Civo ويعيدها في حقلobjectstore_endpointفي Civo REST API. - هل أستطيع استخدام s3cmd أو rclone مع Civo Object Storage؟
- نعم، الاثنان يعملان، وكذلك AWS CLI وأي عميل آخر متوافق مع S3. لـ s3cmd، اضبط
host_baseوhost_bucket في~/.s3cfgعلى الاسم المضيف الإقليمي مثلobjectstore.fra1.civo.comواملأaccess_keyوsecret_key. ولـ rclone، أنشئ بعيدًا بـ type = s3 وprovider = Other وendpoint =https://objectstore.fra1.civo.comوزوج المفاتيح نفسه. ولـ AWS CLI، مرّر--endpoint-urlhttps://objectstore.fra1.civo.comمع كل أمر. - لماذا لا يعمل مفتاح الوصول إلى Civo Object Storage عندي؟
- السبب المعتاد هو المنطقة. تقول Civo إن المتاجر خاصة بالمناطق وإن بيانات الاعتماد مرتبطة بالمنطقة التي أُنشئت فيها، فمفتاح أُنشئ في FRA1 لن يُصادق عليه مقابل نقطة نهاية LON1 رغم انتمائه إلى الحساب نفسه. أنشئ بيانات الاعتماد واللوحة مضبوطة على منطقة المتجر. والسبب الشائع الثاني عميل لم يتلقَّ نقطة النهاية أصلًا، أو
host_bucketفي s3cmd تُرك على قيمته الافتراضية، فيذهب الطلب إلى Amazon بدل Civo. - هل توجد واجهة رسومية لـ Civo Object Storage على Mac؟
- CivoCloudManager تطبيق macOS أصلي، لـ macOS 15 أو أحدث، على Mac App Store، وهو يعرف Civo: يقرأ نقطة النهاية ومفاتيح الوصول لكل متجر من Civo API فلا يبقى شيء تضبطه. يتصفح بمسار تنقل وينزّل ملفات مفردة أو تحديدًا متعددًا أو مجلدًا كاملًا بشكل متكرر، بينما يبقى الرفع والحذف للـ CLI. وعملاء S3 العامون مثل Cyberduck أو Transmit يتصلون بـ Civo أيضًا متى كتبت نقطة النهاية ولصقت المفتاحين لكل متجر.
- ماذا يفعل الإيقاف ببياناتي في Civo Object Store؟
- ينسخ الإيقاف كل ملف إلى Object Store مركزي اسمه civo-cloud-manager داخل حساب Civo الخاص بك، ويقارن المفاتيح والأحجام المنسوخة بالمصدر، ثم يحذف المتجر الأصلي فيتوقف عن التكلفة. ويعيد الاستئناف إنشاء المتجر بالاسم نفسه وبيانات الاعتماد نفسها، وينسخ الملفات عائدة، ويتحقق من المفاتيح والأحجام قبل تفريغ الخزنة. والبيانات لا تغادر حساب Civo الخاص بك، والتحقق بالاسم والحجم لا بتجزئة المحتوى.
أدلة
خطوة بخطوة، ومقارنات صادقة.
- 01 توصيل مفتاح Civo API أنشئ المفتاح في لوحة Civo، والصقه مرة واحدة، ودع macOS Keychain يحتفظ به بعد ذلك.
- 02 فتح جدار حماية لعنوانك الإجراء اليدوي، ومصيدة الـ IP المتغير التي يخلّفها، ومسار مجاني من شريط القوائم يغلق القاعدة عند موعد.
- 03 مقابل Lens وOpenLens وk9s ثلاث أدوات لا تعرف مزودًا بعينه، وواحدة مخصصة لـ Civo. والفرق هو ما يحدد أيها تريد مفتوحًا.
- 04 Civo DNS على Mac وجّه نطاقًا إلى خوادم أسماء Civo، ثم أبقِ المنطقة في تطبيق أصلي بدل تبويب متصفح.
- 05 سجل التغييرات كل إصدار مشحون، الأحدث أولًا، بالتفصيل الذي تضيق عنه ملاحظة إصدار في المتجر.
تعمّق
قراءات موجّهة لكل منتج من Civo.
لكل مجال في Civo يلمسه CivoCloudManager صفحة خاصة فيها التفاصيل والمقايضات وبنية التنفيذ. اختر الأقرب إلى ما تعمل عليه اليوم.
- 01 بديل Civo CLI لـ Mac أين تتفوق الواجهة الرسومية على الـ CLI، وأين لا تتفوق، وكيف يتعايشان.
- 02 واجهة Civo Kubernetes الرسومية لـ Mac لوحة عنقود حية، وسجلات pod لحظية، بلا حاجة إلى kubectl.
- 03 متصفح Civo Object Storage لـ Mac متصفح أصلي متوافق مع S3. أوقف الـ buckets الخاملة في خزنة مركزية.
- 04 جدار حماية Civo من شريط قوائم Mac فتح وإغلاق بنقرة واحدة لكل جدار حماية، وكشف تلقائي للـ IP، ومؤقت إغلاق.
- 05 لوحة تكاليف Civo لـ Mac رسوم حقيقية من Civo charges API. منتقي فترة وتوقع لنهاية الشهر.
تخطَّ ضبط نقطة النهاية.
يقرأ CivoCloudManager نقطة النهاية ومفاتيح الوصول من حساب Civo الخاص بك، فيفتح المتجر بدل أن يطلب ملف إعدادات. طبقة شريط قوائم مجانية، وشراء لمرة واحدة للوحة الكاملة على Mac App Store.