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

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

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

في daemon direct — أي relayium serve مع push أو sync — تنتقل بايتات الملف مباشرة بين جهازيك ولا تمر أبدًا عبر خوادم Relayium، فلا يُحتسب شيء. أما جلسات رمز الاقتران (send / receive وtext وpair) فمشفّرة من الطرف إلى الطرف، لكن كلما أصدر الخادم مُرحِّلًا للرمز مرّ كل بايت عبر هذا المُرحِّل المُشفَّر واحتُسب ضمن حصة حركة البيانات الشهرية للحساب الذي أنشأ الرمز. أما up فليس مباشرًا: إنه يخزّن نسخة مُشفَّرة تحت حسابك. يوصلك هذا الدليل إلى التثبيت وإتمام أول عملية نقل لك، ثم يوجّهك إلى الأدلة الأعمق لكل وضع.

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

ما تحتاج إليه

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

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

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

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

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

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

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

إرسال نص مؤقت

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

relayium text

relayium text 483920

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

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

أسرع شيء يمكنك تجربته هو نسخ مجلد إلى جهاز تديره. شغّل هناك مستمع Relayium، واعتمد هذا المُرسِل، ثم انقل مباشرة دون حساب:

تأكّد من أن واجهة CLI موجودة في PATH لديك. ستطبع سطر إصدار لا عبارة «command not found».
```
relayium version
```
على جهاز الاستقبال، أنشئ المجلد واعتمد بصمة المُرسِل وشغّل المستمع. يجب أن يستخدم authorize وserve قيمة --config-dir نفسها.
```
mkdir -p ~/inbox && relayium authorize <sender-fingerprint> && relayium serve --dir ~/inbox
```
ادفع المجلد بـ push إلى عنوان relayium:// الخاص بالمستمع.
```
relayium push ./photos relayium://receiver.example
```
تأكّد على جهاز الاستقبال من ظهور photos/ تحت مجلد --dir الخاص بالمستمع.
```
find ~/inbox/photos -maxdepth 1 -type f
```

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

يطبع push سطرًا لكل ملف مكتمل، وينتهي برمز 0 بعد أن يتحقق المستمع من الدفعة ويثبّتها.

relayium push ./photos relayium://receiver.example
  photos/IMG_0413.jpg (2314518 bytes)
  photos/IMG_0414.jpg (1998233 bytes)
echo $?
# 0

يفحص push الدفعة بحثًا عن التعارضات قبل الإرسال، ويتحقق من كل ملف بـ SHA-256 ويضعه في منطقة مؤقتة قبل تثبيته. ولا يستأنف؛ استخدم relayium sync حين قد ينقطع التشغيل.
يجب أن يكون المستمع قابلًا للوصول، وأن يكون قد اعتمد بصمة هذا المُرسِل مسبقًا.
أُوقفت وجهات SSH وrelayium pull والخياران -i و-p. للنقل في الاتجاه المعاكس، شغّل serve على هذا الجهاز وابدأ push جديدًا عبر daemon direct من الجهاز الآخر.

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

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

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

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

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

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

يطبع push الرسالة «SSH transfers are currently disabled».

relayium push ./photos <retired-ssh-destination>
# SSH transfers are currently disabled

يستخدم الأمر صيغة وجهة SSH الموقوفة. شغّل relayium serve على جهاز الاستقبال واستخدم relayium://receiver بدلًا منها.

يرفض المستمع المُرسِل لأنه غير معتمد.

relayium id
# sha256:...

شغّل relayium authorize <sender-fingerprint>‎ على جهاز الاستقبال بقيمة --config-dir نفسها التي يستخدمها serve. يقرأ المستمع العامل الاعتماد الجديد عند الاتصال التالي.

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

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

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

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

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

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

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

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

إن CLI نفسه مجاني ومفتوح المصدر، ولا تكلّف الأوضاع المباشرة — push/sync عبر daemon direct — شيئًا: لا تمر هذه البايتات أبدًا عبر خوادم Relayium، فلا يوجد ما يُقاس. أما send / receive وtext فتُحتسب حين تُرحَّل: كلما أصدر الخادم مُرحِّلًا للرمز، احتُسبت البايتات المُرحَّلة ضمن حصة حركة البيانات الشهرية للحساب الذي أنشأ الرمز. ويستهلك من خطتك كذلك الأمران up وdown، إذ يكتبان نسخة مشفّرة محفوظة تحت حسابك ويقرآنها. يُحتسب up ضمن أربعة حدود منفصلة — حصة حركة البيانات الشهرية، وحدّ التخزين لما تحتفظ به مُخزَّنًا في آنٍ واحد، ومدة الاحتفاظ القصوى في خطتك، وحدّ رفع يومي — ويُحتسب down ضمن حصة حركة البيانات عند قراءة النسخة. والخطط المدفوعة ترفعها جميعًا.

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

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

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

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

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

ليس مع push/sync عبر daemon direct: تنتقل بايتات الملف مباشرة بين جهازيك. يتصل send / receive وtext بخوادمنا لمصافحة تعارف صغيرة، وكلما أصدر الخادم مُرحِّل TURN للرمز مرّ كل بايت من الجلسة عبر هذا المُرحِّل — نصًا مُشفَّرًا من الطرف إلى الطرف لا يستطيع قراءته، يُحتسب ضمن حصة حركة البيانات الشهرية للحساب الذي أنشأ الرمز، ولا يُخزَّن أبدًا. أما up فمختلف: إنه يرفع نسخة مُشفَّرة إلى تخزين حسابك، يحتفظ بها الخادم لكنه لا يستطيع قراءتها.

ثبّت Relayium CLI المجاني والمفتوح المصدر ونفّذ أول عملية نقل مباشر لك.

احصل على CLI