استضافة ‎Garage على خادم ‎VPS: مساحة تخزين ‎S3 خاصة بك

ما هو ‌Garage وما ليس عليه

ما يتميز به ‌Garage على خادم ‌VPS

• واجهة ‌S3 قياسية: متوافقة مع ‌aws ‌CLI و‌rclone و‌mc و‌restic وحزم ‌SDK لـ‌Python/Go/Rust وجميع عملاء ‌S3 تقريباً.
• بصمة ذاكرة ضئيلة: بضعة ميغابايتات في وضع الاستعداد — تتعايش دون احتكاك مع خادم ويب أو قاعدة بيانات أو بروكسي عكسي على نفس الـ‌VPS.
• لا اعتمادية خارجية: لا ‌PostgreSQL ولا ‌Redis ولا ‌etcd. محرك البيانات الوصفية مدمج (‌LMDB أو ‌SQLite).
• نسخ احتياطي اختياري: في وضع العقدة الواحدة يكفي قرص واحد؛ في الوضع متعدد العقد يُكرر ‌Garage الكائنات بين الأجهزة وعبر المواقع.
• رخصة ‌AGPLv3 بلا قيود: لا ميزة محجوبة خلف إصدار مدفوع ولا حد على الحجم أو عدد الدلاء.
• نطاقات فرعية افتراضية: يدير ‌Garage توجيه <bucket>.s3.your-domain.com، وهو ما تتطلبه بعض عملاء ‌S3 وحزم ‌SDK.

المتطلبات الأولية: تحديد حجم الـ‌VPS لـ‌storage bucket

curl -fsSL https://get.docker.com | sh

الإعداد الأدنى لـ‌storage bucket

metadata_dir = "/var/lib/garage/meta"
data_dir = "/var/lib/garage/data"
db_engine = "sqlite"
replication_factor = 1

rpc_bind_addr = "[::]:3901"
rpc_public_addr = "127.0.0.1:3901"
rpc_secret = "<64 حرفاً سداسي عشري>"

[s3_api]
s3_region = "garage"
api_bind_addr = "[::]:3900"
root_domain = ".s3.your-domain.com"

[admin]
api_bind_addr = "[::]:3903"
admin_token = "<رمز الإدارة>"

نشر ‌Garage وإنشاء أول ‌bucket تخزين ‌S3

1. 01

   إنشاء هيكل المجلدات

   أنشئ مجلد عمل وملف الإعداد:

   mkdir -p /opt/garage/config
   openssl rand -hex 32   # → الصقه في rpc_secret
   openssl rand -base64 32 | tr -d '=' | head -c 40  # → admin_token

   aكتب garage.toml في /opt/garage/config/ مع استبدال الرمزين المولَّدَين.

2. 02

   كتابة ملف ‌Compose وتشغيله

   منذ الإصدار 2.3، يستطيع ‌Garage تهيئة مجموعة عقدة واحدة وإنشاء أول دلو تلقائياً من متغيرات البيئة. هذا يتجنب تسلسل الأوامر اليدوية layout assign / layout apply / bucket create / key create:

   services:
     garage:
       image: dxflrs/garage:v2.3.0
       restart: unless-stopped
       command: ["/garage", "-c", "/etc/garage/garage.toml", "server", "--single-node", "--default-bucket"]
       environment:
         GARAGE_DEFAULT_BUCKET: my-bucket
         GARAGE_DEFAULT_ACCESS_KEY: GK<30 hex>
         GARAGE_DEFAULT_SECRET_KEY: <64 hex>
       ports:
         - "127.0.0.1:3900:3900"
         - "127.0.0.1:3903:3903"
       volumes:
         - ./config:/etc/garage
         - garage-meta:/var/lib/garage/meta
         - garage-data:/var/lib/garage/data
   
   volumes:
     garage-meta:
     garage-data:

   الصورة ‌distroless: لا توجد قشرة أوامر ونقطة الدخول فارغة. يجب أن تُسمّي الأمرُ الملفَّ الثنائيَّ بمساره المطلق (/garage) وتمرّر ملف الإعداد (-c).

   مفتاح الوصول ‌S3 يجب أن يكون GK يليه بالضبط 30 حرفاً سداسي عشري.

   docker compose up -d

3. 03

   التحقق من استجابة الواجهة البرمجية

   يجب أن يُعيد استدعاء مجهول على واجهة ‌S3 البرمجية 403 — العلامة الصحيحة على أن الخدمة تعمل وترفض الطلب غير الموقَّع:

   curl -s -o /dev/null -w '%{http_code}\n' http://127.0.0.1:3900/
   # 403 → الواجهة البرمجية تستجيب

   واجهة الإدارة تُعيد 200 بالرمز:

   curl -H "Authorization: Bearer $ADMIN_TOKEN" http://127.0.0.1:3903/v2/ListBuckets

4. 04

   كشف الواجهة البرمجية خلف ‌nginx وشهادة ‌TLS

   لا تنشر المنفذ 3900 مباشرةً على الواجهة العامة. اربطه بالحلقة المحلية ودع ‌nginx يتولى البروكسي والشهادة. كتلة ‌nginx أدنى لـ s3.your-domain.com:

   server {
       listen 443 ssl;
       server_name s3.your-domain.com *.s3.your-domain.com;
       ssl_certificate /etc/letsencrypt/live/s3.your-domain.com/fullchain.pem;
       ssl_certificate_key /etc/letsencrypt/live/s3.your-domain.com/privkey.pem;
       location / {
           proxy_pass http://127.0.0.1:3900;
           proxy_set_header Host $host;
       }
   }

5. 05

   الاختبار بعميل ‌S3

   مع تعيين متغيرات البيئة، تعمل أداة ‌aws ‌CLI دون تعديل:

   export AWS_ACCESS_KEY_ID=GK...
   export AWS_SECRET_ACCESS_KEY=...
   export AWS_DEFAULT_REGION=garage
   
   aws --endpoint-url https://s3.your-domain.com s3 ls
   aws --endpoint-url https://s3.your-domain.com s3 cp myfile.txt s3://my-bucket/

   لـ‌restic، عيّن RESTIC_REPOSITORY=s3:https://s3.your-domain.com/my-bucket وشغّل restic init.

حالات الاستخدام الشائعة لـ‌storage bucket ذاتي الاستضافة

ما يُنشر خلف ‌Garage

• نسخ احتياطية ‌restic أو ‌Borg: عيّن RESTIC_REPOSITORY=s3:https://s3.your-domain.com/backups. التوافق مع ‌S3 في ‌restic أصيل ولا يتطلب إضافات.
• أصل موقع ثابت: خزّن أصول الواجهة الأمامية المُجمَّعة وقدّمها عبر ‌nginx أو ‌Cloudflare في وضع البروكسي.
• رفع ملفات التطبيقات: تكتب تطبيقات ‌Laravel أو ‌Django أو ‌Rails إلى ‌Garage عبر حزمة ‌SDK الخاصة بها — لا يتغير سوى نقطة النهاية.
• إنتاج ‌CI/CD: ترفع ‌GitHub Actions أو ‌GitLab CI نتائج البناء إلى ‌Garage بـ‌aws s3 cp تماماً كما مع ‌S3 الخاص بـ‌AWS.
• أرشفة السجلات والمقاييس: تستطيع ‌Loki وVector وFluentd الكتابة إلى مخزن كائنات متوافق مع ‌S3 للأرشفة طويلة الأمد.
• مشاركة الملفات بين الخدمات: تصل حاويتان على نفس الـ‌VPS أو على نظامَين مختلفَين إلى نفس الدلو عبر واجهة ‌S3 البرمجية.

‌Garage مقابل بدائل ‌S3 ذاتية الاستضافة

مرّر الجدول أفقيًا

نقاط يجب استيعابها