تخطَّ إلى المحتوى
Octoboard الوثائق

المتصفح عبر Tailscale

افتح Octoboard في متصفح على كمبيوتر آخر عبر شبكة Tailscale الخاصة بك، دون SSH أو سطح مكتب بعيد. المضيف هو الكمبيوتر الذي يشغّل Octoboard: كمبيوتر Mac أو كمبيوتر Windows أو خادم Linux يشغّل octoboardd. ويمكن إبقاء تسجيل الدخول عبر SSH (Remote Login في macOS) متوقفًا.

لست متأكدًا أن هذه هي الطريقة المناسبة لك؟ راجع اختر طريقة الاتصال.

المتصفح على كمبيوترك ← الوسيط على كمبيوترك (127.0.0.1) ⟷ Tailscale ⟷ الوسيط على المضيف (127.0.0.1) ← Octoboard

هل هذا جديد عليك؟
  • Tailscale: خدمة تربط أجهزتك في شبكة خاصة عبر الإنترنت، أينما كانت. تسجّل الدخول إليها بحسابك الخاص.
  • Tailnet: شبكة Tailscale الخاصة بك: الأجهزة المسجَّل دخولها إلى حساب Tailscale الخاص بك.
  • 127.0.0.1 (loopback): عنوان يعني دائمًا “هذا الكمبيوتر نفسه”.
  • المنفذ (Port): رقم يحدد برنامجًا واحدًا على الكمبيوتر، مثل رقم باب. 127.0.0.1:3369 هو المنفذ 3369 على هذا الكمبيوتر.
  • socat: برنامج صغير ومجاني ينقل اتصالًا من مكان إلى آخر. وهو هنا الوسيط.
  • Tailscale Serve: أمر في Tailscale يشارك منفذًا مع tailnet الخاص بك وحده. أما قريبه Tailscale Funnel فكان سيشاركه مع الإنترنت كله؛ لا تستخدمه هنا أبدًا.
  • Terminal: النافذة التي تكتب فيها الأوامر: Terminal في macOS، وPowerShell في Windows.

لماذا هذه الخطوات الإضافية

Section titled “لماذا هذه الخطوات الإضافية”

حرصًا على الأمان، لا يقبل Octoboard إلا متصفحًا يفتحه على 127.0.0.1، وهو عنوان يعني دائمًا “هذا الكمبيوتر نفسه” (ويسمى أيضًا loopback). لذا لا يمكنك ببساطة كتابة عنوان Tailscale الخاص بالمضيف في المتصفح. بدلًا من ذلك، تشغّل برنامج وسيط صغيرًا على كل كمبيوتر: على كمبيوترك يجعل المضيف يبدو محليًا على 127.0.0.1؛ وعلى المضيف يسلّم الاتصال إلى Octoboard. وينقل Tailscale حركة البيانات بين الاثنين.

  • Tailscale على الكمبيوترين، مسجَّلًا الدخول فيهما إلى tailnet نفسه. استخدم tailnet لا يضم إلا أجهزتك: فكل جهاز يسمح له بالوصول إلى المضيف يستطيع الوصول إلى المنفذ الذي تشاركه.

  • socat على كل كمبيوتر هو Mac أو يشغّل Linux. كمبيوتر Windows لا يحتاج إليه.

    ثبّت Homebrew أولًا إن لم يكن لديك (لا يأتي macOS بأداة تؤدي هذه المهمة)، ثم شغّل هذا في Terminal:

    Terminal window
    brew install socat
  • نافذتان أو ثلاث نوافذ تبقى مفتوحة أثناء عملك: الوسيط وTailscale Serve على المضيف (باستثناء الوسيط على Windows)، والوسيط على كمبيوترك (باستثناء Windows).

  1. احصل على عنوان المتصفح، وهو يحمل المفتاح الذي يسجّل دخول المتصفح.

    في Octoboard افتح الإعدادات › الوصول عن بُعد، وشغّل السماح بالوصول عن بُعد، ثم اختر سماح للتأكيد. يظهر بعد ذلك تبويبان أسفل المفتاح. في تبويب المتصفح، اختر نسخ العنوان تحت الخطوة 2: عنوان المتصفح.

    أوصل العنوان إلى الكمبيوتر الآخر بطريقة لا يراها غيرك، مثل ملاحظة ترسلها إلى نفسك: فهو يعمل عمل كلمة المرور.

    تجاوز الخطوة 1: إعادة توجيه SSH. تذكر إعدادات التطبيق SSH في أكثر من موضع، ويمكنك تجاهل ذلك هنا، لأن هذا الدليل يستخدم عنوان المتصفح فقط.

    أبقِ Octoboard قيد التشغيل: إذا أغلقته توقف الوصول عن بُعد.

  2. شغّل الوسيط على المضيف، الذي يوصل منفذًا على 127.0.0.1 الخاص بالمضيف بـ Octoboard. هذا المنفذ هو منفذ المضيف في الخطوات أدناه.

    شغّل هذا في Terminal واترك النافذة مفتوحة. ينصت على 127.0.0.1:3370 وحده.

    Terminal window
    socat TCP-LISTEN:3370,bind=127.0.0.1,reuseaddr,fork UNIX-CONNECT:"$HOME/.octoboard/browser.sock"

    منفذ المضيف هو 3370.

  3. شارك منفذ المضيف مع tailnet الخاص بك عبر Tailscale Serve، واترك النافذة مفتوحة. لا تستخدم Tailscale Funnel أبدًا، فهو سيضع المنفذ على الإنترنت العام.

    Terminal window
    tailscale serve --tcp=3370 tcp://127.0.0.1:3370

    مع تطبيق Tailscale من App Store، شغّل الأمر بكتابة /Applications/Tailscale.app/Contents/MacOS/Tailscale بدلًا من tailscale. ومع التطبيق المستقل، ثبّت الأمر أولًا من إعداداته، تحت CLI integration.

    للتحقق، شغّل tailscale serve status في نافذة أخرى: يجب أن يعرض منفذ المضيف.

على الكمبيوتر الذي ستتصفح منه

Section titled “على الكمبيوتر الذي ستتصفح منه”
  1. ابحث عن المضيف في تطبيق Tailscale على هذا الكمبيوتر، ودوّن اسمه (مثل my-mac) أو عنوانه (رقم مثل 100.x.y.z).

  2. شغّل الوسيط على هذا الكمبيوتر، ليظهر المضيف على 127.0.0.1:3369 هنا. إذا كان المنفذ 3369 مستخدمًا بالفعل على هذا الكمبيوتر، فاختر منفذًا آخر وغيّره في عنوان المتصفح أيضًا.

    في الأمر أدناه، استبدل <host> باسم المضيف أو عنوانه، و<host port> بمنفذ المضيف.

    Terminal window
    socat TCP-LISTEN:3369,bind=127.0.0.1,reuseaddr,fork TCP:<host>:<host port>

    مثلًا، لمضيف Mac اسمه my-mac:

    Terminal window
    socat TCP-LISTEN:3369,bind=127.0.0.1,reuseaddr,fork TCP:my-mac:3370

    شغّله في Terminal واترك النافذة مفتوحة.

  3. افتح عنوان المتصفح الذي نسخته على المضيف. وهو يبدأ بـ http://127.0.0.1:3369/.

ستعرف أن كل شيء نجح عندما يفتح Octoboard في تبويب المتصفح دون أن يطلب منك تسجيل الدخول.

  • لا تُحمَّل الصفحة: أُغلقت إحدى النوافذ، أو توقف أمرها. تأكد من أن الوسيطين وTailscale Serve ما زالت تعمل، ومن أن tailscale serve status على المضيف يعرض منفذ المضيف.
  • يقول socat “Address already in use”: المنفذ مستخدم على ذلك الكمبيوتر. اختر منفذًا آخر؛ وعلى كمبيوترك، غيّره في عنوان المتصفح أيضًا.
  • تُرفض الصفحة أو تظهر فارغة: تأكد من أنك فتحت العنوان على 127.0.0.1، لا باسم Tailscale الخاص بالمضيف ولا بعنوانه 100.x.y.z.
  • يطبع الوسيط على المضيف “Connection refused” أو “No such file or directory” عند فتح الصفحة: السماح بالوصول عن بُعد متوقف، أو أن Octoboard لا يعمل على المضيف (وفي Linux، أن octoboardd لا يعمل).
  • على الكمبيوتر الذي تصفحت منه: أوقف socat بـ Ctrl+C، أو احذف إعادة التوجيه في Windows من PowerShell يعمل كمسؤول:

    Terminal window
    netsh interface portproxy delete v4tov4 listenaddress=127.0.0.1 listenport=3369
  • على المضيف: أوقف أمر Tailscale Serve وsocat بـ Ctrl+C. وتأكد بـ tailscale serve status أن شيئًا لم يعد مشاركًا؛ فإذا بقي المنفذ معروضًا، فأزله بـ tailscale serve --tcp=3370 off (وفي Windows، tailscale serve --tcp=3369 off).

  • على مضيف Mac أو Windows، أوقف السماح بالوصول عن بُعد عندما لا تحتاج إليه بعد الآن. يغلق هذا مدخل المتصفح ويقطع اتصال كل صفحة فُتحت بالمفتاح.

  • إذا احتمل أن العنوان تسرّب، فأعطه مفتاحًا جديدًا بـ تجديد المفتاح في تبويب المتصفح، أو في Linux بـ octoboardd address --rotate. تنقطع الصفحات المفتوحة بالعنوان القديم.

  • العنوان هو كلمة المرور: مفتاحه يمنح تحكمًا كاملًا في Octoboard على المضيف، بما في ذلك تشغيل أي أمر. ويبقى صالحًا إلى أن تجدّده. ويبقى في سجل المتصفح وإشاراته المرجعية، ويُزامَن إلى أجهزتك الأخرى إذا كانت مزامنة المتصفح مفعّلة.
  • من يستطيع الوصول إليه: كل من يصل إلى منفذ المضيف ويملك المفتاح. ينصت الوسيطان على 127.0.0.1 فقط، فلا تستطيع الأجهزة الأخرى في شبكة المضيف أو شبكتك المحلية الوصول إليهما؛ ويجعل Tailscale Serve منفذ المضيف متاحًا من tailnet الخاص بك وحده، بقدر ما تسمح قواعد الوصول فيه.
  • فقط على أجهزة لا يسجّل الدخول إليها أحد غيرك: يستطيع حساب مستخدم آخر على المضيف أو على كمبيوترك الاتصال بمنافذ 127.0.0.1 هذه، وعندما لا يكون الوسيط قيد التشغيل يستطيع أن يستولي على منفذه ويتلقى المفتاح عندما يعيد متصفحك الاتصال. عند الاتصال عبر SSH، لا يوجد هذا الضعف في مضيف Mac أو Linux، ولا في كمبيوترك أنت عند استخدام تطبيق سطح المكتب. أما في المتصفح فيبقى هذا الضعف في كمبيوترك، لأن إعادة توجيه SSH هناك تستمع أيضًا على منفذ 127.0.0.1.
  • لا Funnel أبدًا: Tailscale Funnel سينشر المنفذ على الإنترنت كله.