
موجه SSH مدرك للشبكة - يوجه الاتصالات إلى عناوين IP/منافذ/مفاتيح/مضيفات قفز مختلفة بناءً على VPN أو الشبكة النشطة.
| CI | Code | OpenSpec | Security |
|---|---|---|---|
|
|
|
|
|
موجّه SSH واعٍ بالشبكة. يكتشف شبكتك النشطة أو شبكة VPN الخاصة بك ويختار تلقائيًا المضيف والمنفذ وملف الهوية والمضيف الوسيط (jump host) الصحيح لكل اتصال SSH — دون المساس بـ ~/.ssh/config.
عرّف كل مضيف منطقي مرة واحدة باستخدام ملف تعريف default وتجاوزات اختيارية لكل شبكة. عند كل اتصال، يكتشف sshroute الشبكة التي أنت متصل بها (VPN، شبكة المكتب المحلية، نظير WireGuard، إلخ) ويحل معاملات SSH الصحيحة قبل تسليم الأمر إلى /usr/bin/ssh الحقيقي.
ssh myserver
→ sshroute detects: corp-vpn is active
→ resolves: 10.100.0.50:2222 via bastion.corp.internal
→ exec /usr/bin/ssh -p 2222 -i ~/.ssh/corp_key -J bastion.corp.internal 10.100.0.50
من المحتمل أن يكون لمختبرك واقعان على الأقل: إما أنك جالس في المنزل على الشبكة المحلية (LAN)، أو أنك بعيد وتتصل عبر WireGuard أو شبكة VPN أخرى. المشكلة أن ~/.ssh/config لا يعرف في أي منهما أنت — لذا ينتهي بك الأمر إلى أسماء مستعارة منفصلة (server-lan، server-vpn)، أو مضيف عبور (jump host) يعمل نصف الوقت فقط، أو أنك تحفظ عناوين IP عن ظهر قلب.
يحل sshroute هذه المشكلة عبر اكتشاف شبكتك الحالية قبل كل اتصال. عندما تكون واجهة WireGuard مفعّلة ومسار النظير (peer route) موجودًا، فإنه يتصل مباشرة بعنوان IP للنفق. وعندما تكون على الشبكة المحلية، فإنه يستخدم العنوان المحلي. وعندما لا يكون أي منهما قابلًا للوصول، فإنه يعود إلى اسم المضيف العام. اسم مستعار واحد، ثلاثة أوضاع، وتبديل يدوي صفري.
كما أنه يعترض SSH بشفافية — فـ git push وrsync وscp تمر جميعها عبره تلقائيًا بمجرد إعداد وضع الظل (shadow mode). لا أغلفة، ولا دوال shell، ولا تفكير.
شبكات المؤسسات أسوأ. لديك الإنترنت العام، وربما شبكة VPN من موقع إلى موقع، وربما VPN شخصي بنفق منقسم (split-tunnel)، وداخل ذلك لديك مضيفات عبور مختلفة اعتمادًا على البيئة التي تستهدفها — dev وstaging وprod، ولكل منها حصنها (bastion) ومفتاحها الخاص. الحفاظ على هذا مرتبًا في ~/.ssh/config يعني إما إعدادًا ضخمًا واحدًا ينكسر كلما تغيّرت البنية التحتية، أو كتابة سكربت يحتفظ به كل فرد في الفريق بطريقة مختلفة.
يتيح لك sshroute تعريف منطق التوجيه بشكل تصريحي، والاحتفاظ به في ملف YAML مُصدَّر بإصدارات، ومشاركته عبر الفريق. الإعداد نفسه يعمل للجميع — إذ تُكتشف الشبكة الصحيحة تلقائيًا بناءً على الواجهات أو المسارات النشطة على كل جهاز. تُحلّ المفاتيح والمنافذ والمستخدمون ومضيفات العبور دون أن يضطر المستخدم للتفكير في الأمر.
| الميزة | ~/.ssh/config | WireGuard فقط | Teleport / Boundary | sshroute |
|---|---|---|---|---|
| يكتشف شبكتك الحالية | ❌ | ❌ | ❌ | ✅ |
| يختار أفضل مسار تلقائيًا | ❌ | ❌ | ❌ | ✅ |
| يعود إلى بديل عند فشل الاتصال | ❌ | ❌ | ✅ | ✅ |
| إعادة اتصال تلقائية + إعادة توجيه عند الانقطاع | ❌ | ⚠️ النفق يتجول | ⚠️ عبر وكيل ثابت | ✅ |
| أمر واحد لكل مضيف، من أي موقع | ❌ | ⚠️ يجب أن يكون VPN مفعّلًا | ✅ | ✅ |
| حجم الإعداد لـ 10 مضيفات × 4 مسارات | 📄 ~600 سطر | 📄 ~600 سطر + إعداد VPN | 📄 إعداد من جهة الخادم | 📄 ~60 سطرًا |
| الأجهزة المحمولة المتجولة | ⚠️ أسماء مستعارة يدوية | ⚠️ يتطلب VPN | ✅ | ✅ |
| تسلسل مضيف العبور التلقائي | ⚠️ -J يدوي | ➖ لا ينطبق | ✅ | ✅ |
| يعمل مع scp / rsync / git / Ansible | ✅ | ✅ | ⚠️ جزئيًا | ✅ |
| لا تثبيت من جهة الخادم على الأهداف | ✅ | ❌ | ❌ | ✅ |
| لا خادم مصادقة أو خدمة (daemon) لتشغيلها | ✅ | ❌ | ❌ | ✅ |
| لا وكيل (agent) على العميل | ✅ | ❌ | ❌ | ✅ |
| مفتوح المصدر، مستضاف ذاتيًا بالكامل | ✅ | ✅ | ⚠️ نواة مفتوحة | ✅ |
Teleport وBoundary فئة مختلفة — فهما يضيفان التحكم في الوصول وسجلات التدقيق والمصادقة القائمة على الشهادات فوق التوجيه. إذا كان هذا ما تحتاجه، فاستخدمهما. sshroute مخصص للحالات التي تريد فيها ذكاء التوجيه دون العبء التشغيلي لتشغيل خادم مصادقة مركزي.
نزّل أحدث إصدار من GitHub Releases. الملفات التنفيذية متاحة لـ Linux وmacOS وAndroid على AMD64 وARM64.
go install github.com/thereisnotime/sshroute@latest
نزّل حزمة android_arm64 المضغوطة بصيغة tarball من إصدارات GitHub، ثم استخرجها وضع الملف التنفيذي في ~/.local/bin:
mkdir -p ~/.local/bin
curl -Lo "$TMPDIR/sshroute.tar.gz" \
https://github.com/thereisnotime/sshroute/releases/latest/download/sshroute_android_arm64.tar.gz
tar -xzf "$TMPDIR/sshroute.tar.gz" -C ~/.local/bin sshroute
chmod +x ~/.local/bin/sshroute
أضف ~/.local/bin إلى PATH في ~/.bashrc أو ~/.profile إذا لم يكن موجودًا بالفعل:
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
بدلاً من ذلك، قم بالترجمة البرمجية من المصدر باستخدام Go الخاص بـ Termux. نظرًا لأن سلسلة أدوات Go الرسمية لا تنشر ملفات ثنائية لـ android/arm64، فقم بتعيين GOTOOLCHAIN=local لاستخدام ما يوفره Termux:
GOTOOLCHAIN=local go install github.com/thereisnotime/sshroute@latest
بعد التثبيت، عيّن مسار SSH الثنائي لأن Termux لا يحتوي على /usr/bin/ssh: