Lewati ke konten
Octoboard Dokumentasi

Browser melalui Tailscale

Buka Octoboard di browser pada komputer lain melalui jaringan Tailscale Anda sendiri, tanpa SSH atau desktop jarak jauh. Host adalah komputer yang menjalankan Octoboard: Mac, PC Windows, atau server Linux yang menjalankan octoboardd. Login SSH (Login Jarak Jauh di macOS) boleh tetap nonaktif.

Belum yakin ini cara yang tepat untuk Anda? Lihat Pilih cara terhubung.

Browser di komputer Anda → relay di komputer Anda (127.0.0.1) ⟷ Tailscale ⟷ relay di host (127.0.0.1) → Octoboard

Baru mengenal ini?
  • Tailscale: layanan yang menghubungkan perangkat Anda menjadi jaringan pribadi lewat internet, di mana pun perangkat itu berada. Anda masuk ke layanan ini dengan akun Anda sendiri.
  • Tailnet: jaringan Tailscale Anda: perangkat-perangkat yang masuk ke akun Tailscale Anda.
  • 127.0.0.1 (loopback): alamat yang selalu berarti “komputer yang sama ini”.
  • Port: angka yang memilih satu program di komputer, seperti nomor pintu. 127.0.0.1:3369 adalah port 3369 di komputer ini.
  • socat: program kecil dan gratis yang meneruskan koneksi dari satu tempat ke tempat lain. Di sini ia berperan sebagai relay.
  • Tailscale Serve: perintah Tailscale yang membagikan sebuah port hanya ke tailnet Anda. Saudaranya, Tailscale Funnel, akan membagikannya ke seluruh internet; jangan pernah memakainya di sini.
  • Terminal: jendela tempat Anda mengetik perintah: Terminal di macOS, PowerShell di Windows.

Demi keamanan, Octoboard hanya menerima browser yang membukanya di 127.0.0.1, alamat yang selalu berarti “komputer yang sama ini” (disebut juga loopback). Jadi Anda tidak bisa begitu saja mengetik alamat Tailscale host di browser. Sebagai gantinya, Anda menjalankan program relay kecil di setiap komputer: di komputer Anda, relay membuat host tampak lokal di 127.0.0.1; di host, relay menyerahkan koneksi ke Octoboard. Tailscale membawa lalu lintas data di antara keduanya.

  • Tailscale di kedua komputer, masuk ke tailnet yang sama. Pakai tailnet yang hanya berisi perangkat Anda sendiri: setiap perangkat yang diizinkannya menjangkau host dapat menjangkau port yang Anda bagikan.

  • socat di setiap komputer yang berupa Mac atau menjalankan Linux. Komputer Windows tidak memerlukannya.

    Instal Homebrew lebih dulu jika belum punya (macOS tidak menyertakan alat yang dapat melakukan tugas ini), lalu jalankan ini di Terminal:

    Terminal window
    brew install socat
  • Dua atau tiga jendela dibiarkan terbuka selama Anda bekerja: relay dan Tailscale Serve di host (kecuali relay di Windows), dan relay di komputer Anda (kecuali di Windows).

  1. Dapatkan alamat browser, yang membawa kunci untuk memasukkan browser.

    Di Octoboard, buka Pengaturan › Akses jarak jauh, aktifkan Izinkan akses jarak jauh, lalu pilih Izinkan untuk mengonfirmasi. Dua tab kemudian muncul di bawah sakelar. Di tab Browser, pilih Salin alamat di bawah Langkah 2: alamat browser.

    Kirim alamat itu ke komputer lain dengan cara yang hanya bisa Anda baca, misalnya catatan untuk diri sendiri: alamat ini berfungsi seperti kata sandi.

    Lewati Langkah 1: penerusan SSH. Pengaturan aplikasi menyebut SSH di beberapa tempat; Anda bisa mengabaikannya di sini, karena panduan ini hanya memakai alamat browser.

    Biarkan Octoboard tetap berjalan: jika Anda menutupnya, akses jarak jauh berhenti.

  2. Mulai relay di host, yang menghubungkan sebuah port di 127.0.0.1 milik host ke Octoboard. Port ini adalah port host pada langkah-langkah berikut.

    Jalankan ini di Terminal dan biarkan jendelanya terbuka. Relay hanya mendengarkan di 127.0.0.1:3370.

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

    Port host-nya adalah 3370.

  3. Bagikan port host ke tailnet Anda dengan Tailscale Serve, dan biarkan jendelanya terbuka. Jangan pernah memakai Tailscale Funnel, yang akan menempatkannya di internet publik.

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

    Dengan aplikasi Tailscale dari App Store, jalankan perintah itu sebagai /Applications/Tailscale.app/Contents/MacOS/Tailscale sebagai ganti tailscale. Dengan aplikasi mandiri, instal dulu perintahnya dari pengaturannya, di bawah CLI integration.

    Untuk memeriksa, jalankan tailscale serve status di jendela lain: port host seharusnya terdaftar.

  1. Temukan host di aplikasi Tailscale di komputer ini, dan catat namanya (seperti my-mac) atau alamatnya (angka seperti 100.x.y.z).

  2. Mulai relay di komputer ini, yang membuat host tampak di 127.0.0.1:3369 di sini. Jika port 3369 sudah dipakai di komputer ini, pilih port lain dan ubah juga di alamat browser.

    Pada perintah di bawah, ganti <host> dengan nama atau alamat host, dan <host port> dengan port host.

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

    Misalnya, untuk host Mac bernama my-mac:

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

    Jalankan di Terminal dan biarkan jendelanya terbuka.

  3. Buka alamat browser yang Anda salin di host. Alamat ini diawali http://127.0.0.1:3369/.

Anda tahu semuanya berhasil saat Octoboard terbuka di tab browser tanpa meminta Anda masuk.

  • Halaman tidak termuat: salah satu jendela ditutup, atau perintahnya berhenti. Periksa bahwa relay dan Tailscale Serve masih berjalan, dan bahwa tailscale serve status di host mencantumkan port host.
  • socat menyatakan “Address already in use”: port itu sudah dipakai di komputer tersebut. Pilih port lain; di komputer Anda, ubah juga di alamat browser.
  • Halaman ditolak atau kosong: periksa bahwa Anda membuka alamat di 127.0.0.1, bukan nama Tailscale host atau alamat 100.x.y.z.
  • Relay di host mencetak “Connection refused” atau “No such file or directory” saat Anda membuka halaman: Izinkan akses jarak jauh nonaktif, atau Octoboard tidak berjalan di host (di Linux, octoboardd tidak berjalan).
  • Di komputer tempat Anda browsing: hentikan socat dengan Ctrl+C, atau di Windows hapus penerusan di PowerShell yang dijalankan sebagai administrator:

    Terminal window
    netsh interface portproxy delete v4tov4 listenaddress=127.0.0.1 listenport=3369
  • Di host: hentikan perintah Tailscale Serve dan socat dengan Ctrl+C. Periksa dengan tailscale serve status bahwa tidak ada lagi yang dibagikan; jika port masih terdaftar, hapus dengan tailscale serve --tcp=3370 off (di Windows, tailscale serve --tcp=3369 off).

  • Di host Mac atau Windows, nonaktifkan Izinkan akses jarak jauh saat Anda tidak lagi memerlukannya. Ini menutup pintu masuk browser dan memutus setiap halaman yang dibuka dengan kunci itu.

  • Jika alamat mungkin bocor, beri alamat kunci baru dengan Ganti kunci di tab Browser, atau di Linux dengan octoboardd address --rotate. Halaman yang terbuka dengan alamat lama akan terputus.

  • Alamat adalah kata sandi: kuncinya memberi kendali penuh atas Octoboard di host, termasuk menjalankan perintah apa pun. Kunci berlaku sampai Anda menggantinya. Alamat tersimpan di riwayat dan bookmark browser, serta tersinkron ke perangkat Anda yang lain jika sinkronisasi browser aktif.
  • Siapa yang dapat menjangkaunya: siapa pun yang mencapai port host dan memiliki kuncinya. Relay hanya mendengarkan di 127.0.0.1, sehingga perangkat lain di jaringan host atau jaringan lokal Anda tidak dapat menjangkaunya; Tailscale Serve membuat port host hanya dapat dijangkau dari tailnet Anda, sejauh aturan aksesnya mengizinkan.
  • Hanya di komputer yang tidak dipakai login orang lain: akun pengguna lain di host atau di komputer Anda dapat terhubung ke port 127.0.0.1 ini, dan selama relay tidak berjalan ia dapat mengambil port itu dan menerima kunci saat browser Anda tersambung kembali. Terhubung melalui SSH tidak memiliki kelemahan ini di host Mac atau Linux, dan komputer Anda sendiri juga tidak memilikinya saat memakai aplikasi desktop. Di browser, komputer Anda tetap memilikinya, karena penerusan SSH di sana juga mendengarkan di port 127.0.0.1.
  • Jangan pernah Funnel: Tailscale Funnel akan memublikasikan port ke seluruh internet.