İçeriğe geç
Octoboard Belgeler

Tailscale üzerinden tarayıcı

Octoboard uygulamasını, SSH veya uzak masaüstü olmadan, kendi Tailscale ağınız üzerinden başka bir bilgisayarın tarayıcısında açın. Ana makine, Octoboard uygulamasını çalıştıran bilgisayardır: bir Mac, bir Windows bilgisayarı ya da octoboardd çalıştıran bir Linux sunucusu. SSH ile oturum açma (macOS’te Uzaktan Oturum Açma) kapalı kalabilir.

Bunun sizin için doğru yol olup olmadığından emin değil misiniz? Bağlanma yolunu seçin sayfasına bakın.

Bilgisayarınızdaki tarayıcı → bilgisayarınızdaki aktarıcı (127.0.0.1) ⟷ Tailscale ⟷ ana makinedeki aktarıcı (127.0.0.1) → Octoboard

Bu konuya yeni misiniz?
  • Tailscale: cihazlarınızı, nerede olurlarsa olsunlar, internet üzerinden özel bir ağda birbirine bağlayan bir hizmet. Ona kendi hesabınızla oturum açarsınız.
  • Tailnet: sizin Tailscale ağınız: Tailscale hesabınızda oturum açmış cihazlar.
  • 127.0.0.1 (loopback): her zaman “bu aynı bilgisayar” anlamına gelen bir adres.
  • Bağlantı noktası (port): bir bilgisayarda tek bir programı seçen, kapı numarası gibi bir sayı. 127.0.0.1:3369, bu bilgisayardaki 3369 numaralı bağlantı noktasıdır.
  • socat: bir bağlantıyı bir yerden başka bir yere ileten küçük, ücretsiz bir program. Burada aktarıcıdır.
  • Tailscale Serve: bir bağlantı noktasını yalnızca tailnet’inizle paylaşan bir Tailscale komutu. Akrabası Tailscale Funnel onu tüm internetle paylaşırdı; burada asla kullanmayın.
  • Terminal: komutları yazdığınız pencere: macOS’te Terminal, Windows’ta PowerShell.

Güvenlik için Octoboard, yalnızca kendisini 127.0.0.1 adresinde, yani her zaman “bu aynı bilgisayar” anlamına gelen (loopback da denir) bir adreste açan tarayıcıyı kabul eder. Bu yüzden ana makinenin Tailscale adresini tarayıcıya doğrudan yazamazsınız. Bunun yerine her bilgisayarda küçük bir aktarıcı program çalıştırırsınız: sizin bilgisayarınızda ana makineyi 127.0.0.1 adresinde yerel gibi gösterir; ana makinede bağlantıyı Octoboard uygulamasına verir. İkisi arasındaki trafiği Tailscale taşır.

  • İki bilgisayarda da Tailscale, aynı tailnet’te oturum açmış olarak. Yalnızca kendi cihazlarınızı içeren bir tailnet kullanın: ana makineye ulaşmasına izin verdiği her cihaz, paylaştığınız bağlantı noktasına ulaşabilir.

  • Mac olan ya da Linux çalıştıran her bilgisayarda socat. Windows bilgisayarına gerekmez.

    Yoksa önce Homebrew kurun (macOS bu işi yapabilecek bir araçla gelmez), sonra Terminal’de şunu çalıştırın:

    Terminal window
    brew install socat
  • Siz çalışırken açık bırakılan iki ya da üç pencere: ana makinedeki aktarıcı ve Tailscale Serve (Windows’taki aktarıcı hariç) ve bilgisayarınızdaki aktarıcı (Windows hariç).

  1. Tarayıcının oturum açmasını sağlayan anahtarı taşıyan tarayıcı adresini alın.

    Octoboard içinde Ayarlar › Uzaktan erişim bölümünü açın, Uzaktan erişime izin ver seçeneğini açın ve onaylamak için İzin ver düğmesini seçin. Anahtarın altında iki sekme belirir. Tarayıcı sekmesinde, 2. adım: tarayıcı adresi altındaki Adresi kopyala düğmesini seçin.

    Adresi diğer bilgisayara yalnızca sizin okuyabileceğiniz bir yolla iletin, örneğin kendinize bir not olarak: parola gibi çalışır.

    1. adım: SSH yönlendirmesi bölümünü atlayın. Uygulamanın ayarları SSH’den birkaç yerde söz eder; burada bunu yok sayabilirsiniz, çünkü bu kılavuz yalnızca tarayıcı adresini kullanır.

    Octoboard uygulamasını açık tutun: kapatırsanız uzaktan erişim durur.

  2. Ana makinenin 127.0.0.1 adresindeki bir bağlantı noktasını Octoboard uygulamasına bağlayan aktarıcıyı ana makinede başlatın. Bu bağlantı noktası, aşağıdaki adımlarda ana makine bağlantı noktasıdır.

    Bunu Terminal’de çalıştırın ve pencereyi açık bırakın. Yalnızca 127.0.0.1:3370 adresini dinler.

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

    Ana makine bağlantı noktası 3370 değeridir.

  3. Ana makine bağlantı noktasını Tailscale Serve ile tailnet’inizle paylaşın ve pencereyi açık bırakın. Onu genel internete açacak Tailscale Funnel’ı asla kullanmayın.

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

    App Store’daki Tailscale uygulamasıyla komutu tailscale yerine /Applications/Tailscale.app/Contents/MacOS/Tailscale olarak çalıştırın. Bağımsız uygulamayla önce komutu, uygulamanın ayarlarında CLI integration altından kurun.

    Denetlemek için başka bir pencerede tailscale serve status komutunu çalıştırın: ana makine bağlantı noktasını listelemelidir.

  1. Bu bilgisayardaki Tailscale uygulamasında ana makineyi bulun ve adını (örneğin my-mac) ya da adresini (100.x.y.z gibi bir sayı) not edin.

  2. Bu bilgisayarda, ana makineyi burada 127.0.0.1:3369 adresinde gösteren aktarıcıyı başlatın. 3369 numaralı bağlantı noktası bu bilgisayarda zaten kullanılıyorsa başka bir bağlantı noktası seçin ve tarayıcı adresinde de değiştirin.

    Aşağıdaki komutta <host> yerine ana makinenin adını ya da adresini, <host port> yerine ana makine bağlantı noktasını yazın.

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

    Örneğin my-mac adlı bir Mac ana makinesi için:

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

    Terminal’de çalıştırın ve pencereyi açık bırakın.

  3. Ana makinede kopyaladığınız tarayıcı adresini açın. http://127.0.0.1:3369/ ile başlar.

Octoboard tarayıcı sekmesinde, oturum açmanızı istemeden açıldığında işe yaradığını anlarsınız.

  • Sayfa yüklenmiyor: pencerelerden biri kapatılmış ya da komutu durmuş. Aktarıcıların ve Tailscale Serve’ün hâlâ çalıştığını ve ana makinedeki tailscale serve status çıktısının ana makine bağlantı noktasını listelediğini denetleyin.
  • socat “Address already in use” diyor: o bağlantı noktası o bilgisayarda kullanılıyor. Başka bir bağlantı noktası seçin; kendi bilgisayarınızda tarayıcı adresinde de değiştirin.
  • Sayfa reddediliyor veya boş: adresi, ana makinenin Tailscale adıyla ya da 100.x.y.z adresiyle değil, 127.0.0.1 üzerinden açtığınızı denetleyin.
  • Sayfayı açtığınızda ana makinedeki aktarıcı “Connection refused” veya “No such file or directory” yazdırıyor: Uzaktan erişime izin ver kapalı ya da Octoboard ana makinede çalışmıyor (Linux’ta octoboardd çalışmıyor).
  • Tarayıcıyı kullandığınız bilgisayarda: socat’ı Ctrl+C ile durdurun ya da Windows’ta yönlendirmeyi yönetici olarak çalıştırılan PowerShell’de silin:

    Terminal window
    netsh interface portproxy delete v4tov4 listenaddress=127.0.0.1 listenport=3369
  • Ana makinede: Tailscale Serve komutunu ve socat’ı Ctrl+C ile durdurun. tailscale serve status ile artık hiçbir şeyin paylaşılmadığını denetleyin; bağlantı noktası hâlâ listeleniyorsa tailscale serve --tcp=3370 off ile kaldırın (Windows’ta tailscale serve --tcp=3369 off).

  • Mac veya Windows ana makinesinde, artık gerekmediğinde Uzaktan erişime izin ver seçeneğini kapatın. Bu, tarayıcı girişini kapatır ve anahtarla açılmış her sayfanın bağlantısını keser.

  • Adres sızmış olabilirse, Tarayıcı sekmesindeki Anahtarı yenile ile ya da Linux’ta octoboardd address --rotate ile ona yeni bir anahtar verin. Eski adresle açık olan sayfaların bağlantısı kesilir.

  • Adres paroladır: anahtarı, ana makinedeki Octoboard uygulamasının tam denetimini verir; her komutu çalıştırmak dahil. Siz yenileyene kadar geçerlidir. Tarayıcının geçmişinde ve yer imlerinde kalır, tarayıcı eşitlemesi açıksa diğer cihazlarınıza da eşitlenir.
  • Kimler ulaşabilir: ana makine bağlantı noktasına ulaşan ve anahtara sahip olan herkes. Aktarıcılar yalnızca 127.0.0.1 adresini dinler, bu yüzden ana makinenin ya da yerel ağınızın diğer cihazları onlara ulaşamaz; Tailscale Serve, ana makine bağlantı noktasını erişim kurallarının izin verdiği ölçüde yalnızca tailnet’inizden ulaşılabilir kılar.
  • Yalnızca başka kimsenin oturum açmadığı bilgisayarlarda: ana makinedeki ya da bilgisayarınızdaki başka bir kullanıcı hesabı bu 127.0.0.1 bağlantı noktalarına bağlanabilir ve bir aktarıcı çalışmıyorken onun bağlantı noktasını alıp tarayıcınız yeniden bağlandığında anahtarı alabilir. SSH ile bağlanma yöntemi, Mac veya Linux ana makinesinde bu zayıflığa sahip değildir; masaüstü uygulamasını kullandığınızda kendi bilgisayarınızda da yoktur. Ancak tarayıcıda bilgisayarınızda bu zayıflık yine vardır, çünkü orada da SSH yönlendirmesi bir 127.0.0.1 bağlantı noktasını dinler.
  • Asla Funnel değil: Tailscale Funnel, bağlantı noktasını tüm internette yayımlardı.