دليل · سطر الأوامر (CLI)

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

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

macOS · Linux · Windowsمفتوح المصدرGo

تثبيت

Homebrew (macOS و Linux)

Shell

$ brew install storageto/tap/storageto

Go

Shell

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

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

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

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

عرض على GitHub ↗إصدارات GitHub ↗

الاستخدام

ملف واحد

Shell

$ storageto upload photo.jpg

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

عدة ملفات

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

Shell

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

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

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

Output

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

Shell

$ storageto upload photo.jpg --json
{
  "url": "https://storage.to/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 لتخطي ملف الرمز بالكامل.

نصيحةعمليات الرفع المجهولة عبر CLI محدودة بـ 50 ملفًا يوميًا وتنتهي صلاحيتها بعد 3 أيام. استخدم رمز حساب مجاني لإزالة الحدود، أو رمز مدفوع للاحتفاظ بالملفات إلى الأبد.

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

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

Shell

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

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

Shell

$ storageto version

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

← السابق

تطبيق سطح المكتب

ShareX