Orb — أداة نفق المجلدات بدون ثقة

Orb هي أداة آمنة تعمل من خلال الطرفية (terminal) تتيح لك مشاركة مجلد محلي عبر الإنترنت باستخدام تشفير من طرف إلى طرف. لا حسابات، لا تخزين سحابي، لا حاجة لإعادة توجيه المنافذ.

عرض توضيحي

مشاركة مجلد

مشاركة مجلد بأمر واحد - مشفرة من طرف إلى طرف

تصفح الملفات المشتركة

متصفح ملفات تفاعلي بواجهة طرفية (TUI) للوصول الآمن إلى الملفات

الميزات

• بنية عدم الثقة: لا يرى خادم الترحيل أبدًا البيانات النصية (plaintext)
• تشفير قوي: Argon2id لاستخلاص المفاتيح، بروتوكول Noise للمصافحة، ChaCha20-Poly1305 لتشفير النقل
• متعدد المنصات: يعمل على Linux و macOS و Windows
• آمن عبر NAT: جميع الاتصالات خارجية، يعمل خلف جدران الحماية
• متصفح ملفات بواجهة طرفية تفاعلية: واجهة طرفية تفاعلية لتصفح الملفات وتنزيلها
• بدون أسرار طويلة الأمد: تنتهي الجلسات تلقائياً
• آمن بالتصميم: تنظيف المسارات، حماية الروابط الرمزية، حماية من إعادة التشغيل

بداية سريعة

تثبيت

# تحميل الملف الثنائي لمنصتك
curl -L https://github.com/Zayan-Mohamed/orb/releases/latest/download/orb-$(uname -s)-$(uname -m) -o orb
chmod +x orb
sudo mv orb /usr/local/bin/

أو ابني من المصدر.

مشاركة مجلد

orb share ./myfolder

المخرجات:

Session ID: abc123def456
Passcode: secure-random-passcode
Relay: ws://localhost:8080

شارك هذه البيانات مع المستلم بشكل آمن.
في انتظار الاتصال...

الاتصال بمجلد مشارك

orb connect 7F9Q2A

يطلب رمز المرور، ثم يفتح متصفح ملفات تفاعلي.

الأوامر

orb share <path>

مشاركة دليل محلي عبر نفق مشفر.

الخيارات:

• --relay <url>: عنوان خادم الترحيل (الافتراضي: http://localhost:8080)
• --readonly: مشاركة المجلد في وضع القراءة فقط

مثال:

orb share ./documents --readonly

orb connect <session-id>

الاتصال بجلسة مشتركة.

الخيارات:

• --relay <url>: عنوان خادم الترحيل
• --passcode <code>: رمز مرور الجلسة (يطلب إذا لم يتم تقديمه)
• --tui: استخدام متصفح الملفات بواجهة طرفية (الافتراضي: true)
• --mount <path>: نقطة التثبيت لـ FUSE (Linux/macOS فقط)

مثال:

orb connect 7F9Q2A --passcode 493-771 --tui

orb relay

بدء خادم الترحيل.

الخيارات:

• --listen <addr>: عنوان الاستماع (الافتراضي: :8080)

مثال:

orb relay --listen 0.0.0.0:8080

ميزات الأمان

التشفير

• استخلاص المفاتيح: Argon2id مع 64 ميغابايت من الذاكرة، 3 تكرارات
• المصافحة: إطار عمل بروتوكول Noise مع تبادل مفاتيح X25519
• النقل: تشفير مصادق عليه ChaCha20-Poly1305
• توليد عشوائي: أرقام عشوائية آمنة تشفيرياً

الحماية من

• هجمات القوة العمياء على رمز المرور (دالة كثيفة الاستخدام للذاكرة Argon2id)
• هجمات إعادة التشغيل (أرقام nonce فريدة لكل حزمة)
• الرجل في المنتصف (المصادقة المتبادلة لبروتوكول Noise)
• اختراق المسار (تنظيف المسار والتحقق منه)
• هجمات الروابط الرمزية (تحليل الروابط الرمزية والتحقق من الحدود)
• اختطاف الجلسة (تحديد المعدل وقفل الجلسة)
• اختراق المرحل (تشفير من طرف إلى طرف، المرحل أعمى)

أمان نظام الملفات

• جميع المسارات منظفة ومتحقق منها
• حظر الروابط الرمزية التي تشير إلى خارج الدليل المشترك
• لا تنفيذ للملفات عن بعد
• وضع القراءة فقط قابل للتكوين
• انتهاء صلاحية الجلسة تلقائياً

البنية

يتكون Orb من ثلاثة مكونات:

1. CLI: واجهة المستخدم للمشاركة والاتصال
2. خادم الترحيل: أنبوب بايت أعمى يعيد توجيه البيانات المشفرة
3. النفق المشفر: قناة اتصال مشفرة من طرف إلى طرف

┌─────────┐                  ┌───────────┐                  ┌─────────┐
│ مشارك   │◄────مشفر──────►│   مرحل    │◄────مشفر──────►│مستقبل   │
│  (CLI)  │                  │   خادم   │                  │  (CLI)  │
└─────────┘                  └───────────┘                  └─────────┘
     │                              │                              │
     │                              │                              │
     └──────────────────────────────┴──────────────────────────────┘
              كل التشفير يحدث على الأطراف
              المرحل لا يرى أبدًا البيانات النصية

البناء من المصدر

المتطلبات الأساسية

• Go 1.22 أو أحدث
• Make (اختياري، لكن موصى به)

البناء

# استنساخ المستودع
git clone https://github.com/Zayan-Mohamed/orb.git
cd orb

# تثبيت التبعيات
go mod download

# بناء للمنصة الحالية
make build-local

# أو بناء لجميع المنصات
./build.sh

البناء عبر المنصات

# بناء لجميع المنصات
./build.sh

# الملفات الثنائية ستكون في build/
ls build/
# orb-linux-amd64
# orb-linux-arm64
# orb-darwin-amd64
# orb-darwin-arm64
# orb-windows-amd64.exe

التطوير

تشغيل الاختبارات

make test

تغطية الكود

go test -cover ./...

تشغيل خادم الترحيل محلياً

make relay

تشغيل المشارك

make share

تشغيل المستقبل

SESSION=<session-id> make connect

التكوين

يستخدم Orb إعدادات افتراضية معقولة ولا يتطلب أي ملفات تكوين. جميع الإعدادات تمر عبر علامات سطر الأوامر.

التوثيق

للحصول على وثائق شاملة، زر وثائق Orb:

• بدء الاستخدام

  • دليل التثبيت
  • الخطوات الأولى
  • أمثلة الاستخدام

• أدلة المستخدم

  • مشاركة الملفات
  • الاتصال
  • متصفح TUI
  • استكشاف الأخطاء وإصلاحها

• الأمان

  • تفاصيل التشفير
  • أفضل الممارسات
  • نموذج التهديد

• النشر

  • خادم الترحيل
  • الإنتاج
  • Docker

• التطوير

  • البناء من المصدر
  • المساهمة
  • مرجع API

بناء موقع التوثيق

# تثبيت MkDocs
pip install -r requirements.txt

# التشغيل محلياً
mkdocs serve

# بناء الموقع الثابت
mkdocs build

ملاحظات خاصة بالنظام الأساسي

Linux

• وضع TUI يعمل مباشرة
• التثبيت: استخدم الملفات الثنائية المقدمة أو ابني من المصدر

macOS

• وضع TUI يعمل مباشرة
• التثبيت: استخدم الملفات الثنائية المقدمة أو ابني من المصدر

Windows

• وضع TUI يعمل مباشرة
• التثبيت: استخدم الملفات الثنائية المقدمة أو ابني من المصدر

القيود

• الحد الأقصى لحجم الملف: محدود بالذاكرة المتاحة (10 ميغابايت لكل عملية قراءة)
• تنتهي الجلسات بعد 24 ساعة
• الحد الأقصى لعدد محاولات رمز المرور الفاشلة هو 5 قبل قفل الجلسة
• وصول للقراءة فقط (لا رفع أو تعديل للملفات)

الإفصاح عن الأمان

إذا اكتشفت ثغرة أمنية، يرجى إرسال بريد إلكتروني إلى [email protected]. لا تنشئ مشكلات عامة للثغرات الأمنية.

الترخيص

رخصة MIT - انظر ملف LICENSE للتفاصيل

المساهمة

المساهمات مرحب بها! يرجى قراءة دليل المساهمة للإرشادات.

الشكر والتقدير

• إطار عمل بروتوكول Noise
• ChaCha20-Poly1305 (RFC 8439)
• Argon2id (RFC 9106)
• إطار عمل Bubble Tea للواجهات الطرفية
• مكتبات Go للتشفير