أرسل طرفيتك
يشغّل Termbridge خادمًا محليًا، ويمرّر الاتصال عبر Cloudflare، ويبث جلسة tmux إلى أي متصفح.
npx termbridgeأحدث إصدار 0.3.13 MIT Node 20+, tmux, cloudflared
# Create a tmux session and start the agent
tmux new-session -d -s claude "claude"
# Then attach Termbridge to it
termbridge --session claudeفي التطبيق العملي
ابدأ تشغيله على حاسوبك، ثم افتح الطرفية على جهاز آخر.
من حاسوبك المحمول إلى هاتفك
يشغّل npx termbridge خادمًا محليًا وجلسة tmux ونفقًا عبر Cloudflare، ثم يطبع رمز QR مع رابط تسجيل دخول لمرة واحدة.
يحوّل مسح الرمز إلى جلسة ملفات تعريف ارتباط باستخدام الرمز. أضف --proxy 5173 لعرض خادم التطوير في عرض المعاينة بجوار الطرفية.
npx termbridge# Start your Vite app first
cd my-app && npm run dev # runs on port 5173
# Then start Termbridge with proxy
termbridge --proxy 5173جاهز للهاتف
امسح رمز QR وافتح الطرفية في المتصفح على هاتفك.
طرفية حقيقية
يوصل tmux وnode-pty طرفية PTY حقيقية إلى xterm.js مع الألوان وواجهات TUI.
نفق Cloudflare
يتيح Quick Tunnel الوصول إلى خادمك المحلي دون إعادة توجيه المنافذ.
تسجيل الدخول بالرمز
يحتوي رابط QR على رمز يُستخدم مرة واحدة وصالح لمدة 90 ثانية. يؤدي استخدامه إلى تعيين ملف تعريف ارتباط للجلسة بسمات HttpOnly وSecure، مع فحوص CSRF وحد أقصى قدره 5 مرات استخدام في الدقيقة. لا تنتهي صلاحية الجلسات.
جلسات متعددة
يمكن لخادم واحد استضافة عدة جلسات tmux مع التبديل بينها داخل التطبيق.
أمر واحد
يشغّل npx termbridge الخادم ونفق Cloudflare ورمز QR. يتطلب Node 20+ وtmux وcloudflared على macOS أو Linux؛ ولا يدعم Windows.
CLI أولًا
صُمم كأداة تتمحور حول الطرفية، مع حالة TTY ومخرجات QR.
تسليم QR
يطبع كل تشغيل رمز QR واحدًا مع رابط تسجيل دخول يُستخدم مرة واحدة. امسحه ضوئيًا على الجهاز الذي تريد استخدامه.
معاينة خادم التطوير
مرّر تطبيق Vite المحلي عبر الوكيل واعرض معاينته بجوار الطرفية.
تمرير HMR
يحافظ تمرير WebSocket عبر الوكيل على عمل Hot Module Replacement في Vite.
التبديل بين طرق العرض
بدّل بين الطرفية والمعاينة من لوحة طرق العرض في الشريط السفلي.
سير عمل متكامل
شغّل أوامر الطرفية وشاهد تطبيقك يتحدث في الوقت الفعلي.
لماذا Termbridge؟
بلا إعادة توجيه منافذ أو VPN
يمنحك نفق Cloudflare Quick Tunnel الذي لا يتطلب حسابًا عنوان HTTPS URL عامًا لخادمك المحلي. يحتاج الجهاز الذي تتصل منه إلى متصفح فقط.
تشغيل البرامج بملء الشاشة
يتصل node-pty بـ tmux ويقدّم طرفية بألوان 256، لذا تعمل واجهات TUI مثل htop وvim كما تعمل محليًا.
تستمر الجلسات بعد انتهاء الاتصال
يغلق Ctrl+C النفق والخادم، لكنه يترك جلسات tmux قيد التشغيل. ابدأ من جديد باستخدام --session للاتصال بجلسة موجودة.
يعمل على جهازك
يعمل الخادم وWebSocket وسجل الطرفيات على حاسوبك، ويستمع افتراضيًا إلى 127.0.0.1. لا يشغّل Termbridge أي واجهة خلفية خاصة به.
مقارنة مع
طرق أخرى للوصول إلى طرفية من جهاز آخر، وما يميز Termbridge عنها.
| الأداة | مناسب لـ | الاختلاف عن Termbridge |
|---|---|---|
| ttyd | مناسب لـيتيح ttyd مشاركة أي أمر عبر الويب مع دعم إدخال CJK وIME ونقل الملفات عبر ZMODEM وtrzsz وصور Sixel وSSL والمصادقة الأساسية، ويعمل على macOS وLinux وأنظمة BSD وOpenWrt وWindows. | الاختلاف عن Termbridgeيضيف Termbridge النفق ورابط تسجيل دخول QR يُستخدم مرة واحدة وشريط تحكم للهاتف، ويحفظ shell في tmux ليستمر بعد إعادة التشغيل. وهو مصمم لـ macOS وLinux. |
| sshx | مناسب لـيتيح sshx مشاركة طرفية مع أي شخص بأمر واحد، على مساحة عمل لا نهائية يرى فيها المتعاونون مؤشرات بعضهم، مع تشفير تام بين الطرفين وملفات تنفيذية لـ Linux وmacOS وWindows. | الاختلاف عن Termbridgeيتيح Termbridge الوصول إلى طرفيتك الخاصة: يصدر كل تشغيل رابط تسجيل دخول واحدًا يعمل مرة واحدة، ويمر الاتصال عبر نفق Cloudflare إلى الخادم على جهازك. |
| Tailscale SSH | مناسب لـيتولى Tailscale SSH المصادقة والتفويض لاتصالات SSH في شبكة tailnet، مع تشفير WireGuard باستخدام مفاتيح العقد، من أي جهاز يشغّل Tailscale. | الاختلاف عن Termbridgeلا يحتاج Termbridge إلى عميل أو شبكة خاصة على الجهاز الآخر. يمنحك URL عامًا ورمز QR، وتُفتح الطرفية في المتصفح. |
المصادر، محدد
الأسئلة والأجوبة
إجابات موجزة من توثيق Termbridge.
في الوضع الافتراضي، تمر عبر نفق Cloudflare Quick Tunnel في طريقها إلى خادم Termbridge على حاسوبك. لا يشغّل Termbridge أي واجهة خلفية خاصة به. في وضع بيئة Daytona المعزولة، تعمل الطرفية في بيئة معزولة ضمن حساب Daytona الخاص بك؛ وفي الوضع المباشر تعمل هناك أيضًا وتتصل عبر رابط المعاينة في Daytona.
يحمل رابط QR رمزًا لمرة واحدة صالحًا لمدة 90 ثانية ويعمل مرة واحدة. يؤدي استخدامه إلى تعيين ملف تعريف ارتباط للجلسة بصفة HttpOnly، كما تتطلب اتصالات WebSocket بالطرفية رمز CSRF. لا تشارك رمز QR أو URL مع أشخاص لا تثق بهم.
نعم. عيّن TERMBRIDGE_SESSIONS=3 لبدء ثلاث جلسات tmux، ثم بدّل بينها باستخدام مبدّل الطرفيات في التطبيق.
ليس رسميًا. صُمم Termbridge لـ macOS وLinux. قد يعمل مع WSL، لكن ذلك لم يُختبر.
ليس بعد. Cloudflare هو مزوّد الأنفاق الوحيد. يمكنك استخدام نفق Cloudflare مسمى على اسم المضيف الخاص بك، أو تعطيل النفق وتمرير URL عام خاص بك، أو استخدام وضع Daytona المباشر.
في الوضع المحلي، يستمر الاتصال ما دام Termbridge قيد التشغيل، وينقطع عند دخول الحاسوب في وضع السكون أو خروج Termbridge. تظل جلسات tmux قيد التشغيل، لذا يمكنك بدء Termbridge مجددًا، ومسح رمز QR الجديد، والاتصال باستخدام --session. في وضع Daytona المباشر، يعمل الخادم داخل البيئة المعزولة.
ثبّت Node 20+ وtmux وcloudflared، وشغّل npx termbridge، ثم امسح رمز QR لفتح الطرفية في متصفح هاتفك.