انقل الملفات والنصوص من الطرفية باستخدام Relayium CLI

آخر تحديث: 2026-09-01

‏Relayium CLI ملف ثنائي صغير لنقل الملفات والنص المؤقت من الطرفية — مشفّر من الطرف إلى الطرف، قابل للاستضافة الذاتية، ومجاني. انسخ الملفات إلى خادم، أو انقل نسخة بناء، أو أرسل رابطًا أو أمرًا أو مقطع كود دون حفظه أولًا كملف.

أيًا كانت الطريقة التي تستخدمها بها، تنتقل بايتات الملف مباشرة بين الطرفين ولا تمر أبدًا عبر خوادم Relayium. يوصلك هذا الدليل إلى التثبيت وإتمام أول عملية نقل لك، ثم يوجّهك إلى الأدلة الأعمق لكل وضع.

التثبيت بأمر واحد

ما تحتاج إليه

جهاز فيه طرفية يعمل بنظام macOS أو Linux أو Windows. تغطي الملفات الثنائية مُسبقة البناء معماريتَي x86-64 وarm64 على الأنظمة الثلاثة.
الأداة curl من أجل التثبيت بسطر واحد على macOS وLinux، ويطبع curl --version رقم الإصدار. أما على Windows فنزّل ملف zip. من صفحة الإصدارات.
مجلد تثبيت قابل للكتابة. يستخدم السكربت المسار /usr/local/bin إن كان يستطيع الكتابة فيه، وإلا فالمسار ~/.local/bin، وتذكر أسطره الأخيرة أيّهما اختار.
ولا شيء غير ذلك من أجل push وpull وdaemon direct. أما الحساب المجاني على Relayium فلا يلزم إلا لإصدار رمز اقتران عبر send أو text، وللرفع عبر up.

على macOS أو Linux، يُنزّل أمر واحد ملفًا ثنائيًا مُسبق البناء لنظام تشغيلك ويضعه في PATH لديك:

curl -fsSL https://relayium.com/install.sh | sh

تفضّل اختيار الملف بنفسك؟ نزّل ملفًا ثنائيًا من صفحة الإصدارات.
لديك Go مثبّت؟ استنسخ المستودع ونفّذ: go build -o relayium ./cmd/relayium (من مجلد server).
ثم نفّذ relayium --help لرؤية كل أمر، وrelayium version للتحقق من نسخة البناء.

الطرق الثلاث التي ينقل بها الملفات

‏Relayium ينقل الملفات بثلاث طرق. تختار حسب موقع الطرف الآخر، لا بتعلّم ثلاث أدوات مختلفة — فجميعها تتشارك محرك نقل واحدًا يتحقق من كل ملف ينقله بتجزئة SHA-256. وما لا تتشاركه هو الاستئناف: sync هو الوضع الذي يُكمل ملفًا جزئيًا في تشغيل لاحق، أما push وpull وsend وreceive فلا تستأنف إطلاقًا.

‏push / pull — إلى خادم يمكنك بالفعل الدخول إليه عبر SSH. تنتقل البايتات عبر اتصال SSH لديك؛ بدون حساب Relayium.
‏send / receive — إلى شخص آخر عبر الشبكات، باستخدام رمز اقتران قصير تُصدره واجهة CLI لدى المُرسِل (سجِّل الدخول مرة واحدة عبر relayium login؛ أما المُستقبِل فلا يسجّل الدخول أبدًا). والرمز المُولَّد صالح خمس دقائق، فشغِّل الأمر على الجهاز المُستقبِل خلال هذه المدة.
تعمل أوامر send/receive وtext في Relayium CLI باتصال P2P مباشر فقط: فلا تُمرَّر بايتات الملفات أو الرسائل عبر TURN أو أي خادم Relayium آخر. وإذا تعذّر على الطرفين إنشاء اتصال مباشر، تفشل الجلسة بدل الرجوع إلى مُرحِّل.
‏serve + push relayium:// (daemon direct) — مباشرة بين خادمين تملكهما، عبر TLS مثبَّت. بدون مُرحِّل، بدون SSH، بدون رمز.

إرسال نص مؤقت

شغّل relayium text على جهاز لإصدار رمز اقتران، ثم انضم من الجهاز الآخر بالرمز المطبوع:

relayium text

relayium text 483920

يتطلب إصدار الرمز relayium login؛ أما الانضمام بالرمز فلا يحتاج إلى تسجيل دخول.
يجب أن يبقى الجهازان متصلين. تُشفَّر الرسائل من الطرف إلى الطرف، ولا تخزّن خوادم Relayium متنها.
تعمل أوامر send/receive وtext في Relayium CLI باتصال P2P مباشر فقط: فلا تُمرَّر بايتات الملفات أو الرسائل عبر TURN أو أي خادم Relayium آخر. وإذا تعذّر على الطرفين إنشاء اتصال مباشر، تفشل الجلسة بدل الرجوع إلى مُرحِّل.
ومع ذلك يمكن لأي طرف نسخ النص المستلم أو الاحتفاظ به.
الرسالة الواحدة 65,536 بايت UTF-8 كحد أقصى. استخدم relayium send للمحتوى الأكبر.

أول عملية نقل لك

أسرع شيء يمكنك تجربته هو نسخ مجلد إلى خادم يمكنك الدخول إليه عبر SSH. يستخدم Relayium وصول SSH الموجود لديك، فلا شيء لتهيئته على الطرف البعيد ولا حساب لإنشائه:

تأكّد من أن واجهة CLI موجودة في PATH لديك. ستطبع سطر إصدار لا عبارة «command not found».
```
relayium version
```
تأكّد من أنك تصل إلى الخادم أصلًا بالطريقة المعتادة. يعيد push استخدام هذا الوصول نفسه، فنجاح ssh يستوفي شرط الاتصال والمصادقة. لكنه ليس وعدًا بنجاح النقل نفسه، إذ يظل push بحاجة إلى صلاحية الكتابة ومساحة كافية في user@your-server:backups/.
```
ssh user@your-server true
```
ادفع المجلد. المُعامِل الأخير هو host:path، والنقطتان هما ما يجعله بعيدًا، والشرطة المائلة في النهاية تعني «إلى داخل هذا المجلد».
```
relayium push ./photos user@your-server:backups/
```
تأكّد من وصول الملفات إلى حيث توقّعت. يعيد push ./photos بناء المجلد photos تحت الوجهة، فيأتي اسم المجلد معه.
```
ssh user@your-server ls backups/photos
```

كيف يبدو التشغيل الناجح

إن كان relayium على الطرف البعيد، يطبع push سطرًا لكل ملف اكتمل وينتهي بالرمز 0. وأمام خادم عارٍ يطبع بدلًا من ذلك سطر ملخّص بث tar، وكلاهما نجاح.

relayium push ./photos user@your-server:backups/
  photos/IMG_0413.jpg (2314518 bytes)
  photos/IMG_0414.jpg (1998233 bytes)
echo $?
# 0

إذا كان relayium مثبّتًا على الطرف البعيد أيضًا، يستخدم push البروتوكول الأصلي: تُفحَص الدفعة بحثًا عن التعارضات قبل إرسال أي بايت، ويُتحقَّق من كل ملف بـ SHA-256 ويوضع في منطقة مؤقتة قبل تثبيته. ومع ذلك لا يستأنف — فإعادة التشغيل بعد انقطاع تُرفَض لأن الملفات التي وصلت صارت موجودة. استخدم relayium sync حيث تحتاج ذلك.
يتراجع push إلى بث tar بسيط عندما لا يكون relayium على الطرف البعيد، فيعمل حتى مع خادم عارٍ — وهذا التراجع خاص بـ push وحده.
استرجع الملفات نفسها بـ: relayium pull user@your-server:backups/ ./restore — يحتاج pull دائمًا إلى relayium على الطرف البعيد (لا يملك تراجع tar)، فثبّته هناك أولًا.

حين لا يمر الأمر الأول

أربعة أمور تتعثر في أول تشغيل أكثر من كل ما عداها مجتمعًا. ولا يحتاج أي منها إلى تخمين، فلكل واحد أمر يحسم المسألة بمخرجاته.

العَرَض، الفحص، الإصلاح

تظهر «relayium: command not found» مباشرة بعد أن أعلن سكربت التثبيت نجاحه.

command -v relayium
# (لا يطبع شيئًا)

الملف الثنائي مثبَّت، لكن مجلده ليس ضمن PATH لديك. تذكر أسطر السكربت الأخيرة المجلد الذي استُخدم وتطبع سطر export PATH المطلوب إضافته بالضبط؛ نفّذه، ثم افتح صَدَفة جديدة وجرّب relayium version من جديد.

ينتهي push فورًا برسالة «push destination must be remote (host:path)».

relayium push ./photos user@your-server backups/
# push destination must be remote (host:path)

سقطت النقطتان من الوجهة، فقرأها relayium مسارًا محليًا. اكتبها على طريقة scp، بلا مسافة بين المضيف والمسار: user@your-server:backups/

يفشل pull على خادم كان push يعمل معه بلا مشكلة.

ssh user@your-server command -v relayium
# (لا يطبع شيئًا)

لا يملك pull تراجعًا إلى tar، لأن الطرف البعيد هو المُرسِل في هذا الاتجاه، فلا بد من وجود relayium هناك. ثبّته على الخادم بالأمر ذي السطر الواحد نفسه ثم أعِد تشغيل pull.

ينضم جهازان إلى الرمز نفسه فيطبع أحدهما «the other side is running `relayium text`, not `relayium send`/`relayium receive`».

# جلسة رسائل: كلا الطرفين يشغّل text
relayium text
relayium text 483920

شغّل الطرفان أمرين مختلفين. للرسائل استخدم relayium text على الجهازين، وللملفات استخدم relayium send على أحدهما وrelayium receive على الآخر. يُرفض هذا التعارض قبل أي محاولة اتصال، فلم يُرسَل شيء.

مجاني، وخاص بحكم التصميم

لا شيء تدفعه. ومن بين الطرق الثلاث أعلاه، تسجيل الدخول الوحيد هو تسجيل المُرسِل في وضع send / receive، كي تتمكن واجهة CLI لديه من إصدار رمز اقتران (كما يستخدم up السحابي حسابك أيضًا، لتخزين الملف). يصل CLI بين الطرفين مباشرة، فلا تُرفع ملفاتك أبدًا إلى خادم في الوسط — الشيء الوحيد الذي يلمس Relayium على الإطلاق هو مصافحة تعارف صغيرة جدًا في وضع send / receive، تُستخدم للتعريف بين الطرفين، وليست الملف نفسه أبدًا.

كل عملية نقل مشفّرة من الطرف إلى الطرف، وعلى البروتوكول الأصلي يُتحقق من كل ملف ينقله التشغيل بتجزئة SHA-256 عند الوصول — والاستثناء هو تراجع tar بلا اعتماديات، فهو لا يتحقق من شيء لكل ملف. أما الاستئناف فأضيق من ذلك: يُكمل relayium sync ملفًا جزئيًا في تشغيل لاحق، ويعيد relayium down الاتصال ويُكمل داخل التشغيل نفسه، بينما لا تستأنف push وpull وsend وreceive إطلاقًا. يعمل على macOS وLinux وWindows، والمشروع كله مفتوح المصدر وقابل للاستضافة الذاتية.

الأسئلة الشائعة

هل يكلّف CLI أي شيء؟

لا. إن CLI مجاني تمامًا. لا تمر بايتات الملفات والنصوص المنقولة مباشرة عبر مُرحِّل Relayium، فلا شيء لقياسه ولا شيء لدفعه.

هل أحتاج إلى حساب Relayium؟

لإصدار رمز اقتران عبر send أو text، ولـ up السحابي. لا يحتاج push / pull ولا daemon direct إلى حساب. لا يصدر الخادم الرموز إلا لحساب مسجّل الدخول، لذا يشغّل منشئ الرمز relayium login مرة واحدة. أما الانضمام برمز مستلَم وreceive فلا يحتاجان إلى تسجيل دخول.

ما أنظمة التشغيل المدعومة؟

تُنشر ملفات ثنائية مُسبقة البناء لـ macOS وLinux وWindows على معماريتَي x86-64 وarm64. يغطي سكربت التثبيت macOS وLinux؛ على Windows، نزّل ملف .zip من صفحة الإصدارات.

هل تمر ملفاتي عبر خوادم Relayium؟

لا. في كل وضع، تنتقل بايتات الملف مباشرة بين الطرفين. وحده send / receive يتصل بخوادمنا أصلًا، ولمصافحة تعارف صغيرة فقط — وليس محتوى الملف أبدًا.

ثبّت Relayium CLI ونفّذ أول عملية نقل لك — مجاني تمامًا.

احصل على CLI