أداة سطر الأوامر

ارفع من طرفك (terminal). أمر واحد، إخراج JSON للسكربتات، ورفع multipart قابل للاستئناف للملفات الكبيرة. الكود المصدر على GitHub.

تثبيت

Homebrew (macOS و Linux)

brew install storageto/tap/storageto

Go

go install github.com/storageto/cli/cmd/storageto@latest

تأكد من أن ~/go/bin موجود ضمن PATH.

ملفات ثنائية جاهزة (binaries) مُعدة مسبقًا

حمّل ملف tarball المناسب من إصدارات GitHub (macOS ARM/Intel، Linux ARM/Intel).

الاستخدام

ملف واحد

storageto upload photo.jpg

URL:     https://storage.to/FQxyz1234
Raw:     https://storage.to/r/FQxyz1234
Size:    2.1 MB
Expires: 2026-04-15T12:00:00Z

عدة ملفات

مرّر عدة مسارات أو نمط (glob) - سيتم تجميعها تلقائيًا في مجموعة:

storageto upload file1.txt file2.txt file3.txt
storageto upload *.log
storageto upload src/**/*.go

الملفات الكبيرة

يتم تقسيم الملفات التي تزيد عن 5 جيجابايت تلقائيًا إلى أجزاء (chunked) ورفعها بالتوازي باستخدام multipart قابل للاستئناف. يتم طباعة التقدم مباشرةً داخل الإخراج:

  1.2 GB / 10.0 GB (12.0%)

اضغط Ctrl+C للإلغاء - يتم تنظيف عمليات الرفع الجزئية تلقائيًا على الخادم.

الوسوم (Flags)

وسم (Flag)	الوصف
-c, --collection	فرض إنشاء مجموعة (collection) حتى لملف واحد.
-v, --verbose	عرض مخرجات تقدم مفصلة.
--json	إخراج نتيجة بصيغة JSON (قابلة للقراءة آليًا وممتازة للسكربتات).
--no-token	ارفع بشكل مجهول بالكامل - لا تقرأ ولا تكتب ملف رمز الهوية.
--api <url>	تجاوز نقطة نهاية الـ API (الافتراضي: https://storage.to).
-h, --help	عرض المساعدة.

إخراج JSON

storageto upload photo.jpg --json

{
  "url": "https://storage.to/FQxyz1234",
  "raw_url": "https://storage.to/r/FQxyz1234",
  "filename": "photo.jpg",
  "size": 2202009,
  "human_size": "2.1 MB",
  "expires_at": "2026-04-15T12:00:00Z"
}

رمز الهوية

يقوم CLI بتخزين قيمة عشوائية رمز الزائر (visitor token) عند الاستخدام الأول بحيث تشترك عمليات الرفع المتكررة من نفس الجهاز في الحصة والإسناد. هذا ليس تسجيل دخول لحساب - بل هو مجرد مُعرّف لكل جهاز.

نظام التشغيل (OS)	المسار
macOS	~/Library/Application Support/storageto/token
Linux	~/.config/storageto/token
Windows	%AppData%\storageto\token

استخدم --no-token لتخطي ملف الرمز بالكامل.

البرمجة النصية (Scripting)

مرّر ناتج --json إلى jq لاستخراج الرابط:

URL=$(storageto upload build.zip --json | jq -r '.url')
echo "Uploaded to $URL"

الإصدار والتحديثات

storageto version

مستخدِمو Homebrew: brew upgrade storageto. مستخدمو Go: أعد تشغيل go install باستخدام أحدث وسم.