Lewati ke konten
Octoboard Dokumentasi

Terhubung melalui SSH

Pakai Octoboard di server Linux atau komputer lain dari komputer ini, di aplikasi desktop atau browser, melalui SSH: koneksi terenkripsi langsung ke mesin itu, tanpa relay atau layanan cloud.

Belum yakin ini cara yang tepat untuk Anda? Pilih cara terhubung membandingkannya dengan cara-cara khusus browser yang tidak memerlukan SSH.

Aplikasi desktop di komputer ini · Browser melalui penerusan SSH ⟷ SSH ⟷ Server Linux atau komputer lain

Baru mengenal ini?
  • Host: mesin tempat Octoboard berjalan dan yang ingin Anda jangkau, yaitu server Linux atau Mac atau PC Windows lain.
  • Server: di sini, mesin Linux yang Anda masuki lewat jaringan, biasanya yang Anda sewa, tanpa layar sendiri.
  • SSH: cara standar dan terenkripsi untuk masuk ke mesin lain dan mengetik perintah di sana. Sudah ada di macOS, Windows, dan Linux.
  • Terminal: jendela tempat Anda mengetik perintah: Terminal di macOS, PowerShell di Windows.
  • Penerusan SSH: perintah SSH yang membuat sesuatu di host muncul di komputer Anda sendiri, sehingga browser Anda dapat membukanya di sana.
  • Sidik jari (kunci host): kode pendek yang mengidentifikasi SSH sebuah mesin. Memeriksanya sekali memastikan Anda mencapai mesin yang benar.
  • File kunci: file yang memasukkan Anda sebagai ganti kata sandi. Beberapa penyedia server memberikannya.
  • Cara untuk masuk ke host dengan SSH. Untuk server Linux, penyedianya memberi Anda alamat dan nama pengguna Anda. Untuk memeriksa bahwa cara ini berfungsi, buka Terminal (macOS) atau PowerShell (Windows) dan jalankan perintah di bawah dengan nama pengguna Anda dan alamat server. Saat pertama kali, jawab yes ketika ditanya apakah server dipercaya.

    Terminal window
    ssh <you>@<server>

    Untuk Mac atau PC Windows sebagai host, Anda mengaktifkan login SSH di pengaturan sistemnya; Gunakan komputer lain sebagai host menunjukkan caranya.

  • Untuk server Linux, Octoboard sudah terinstal dan dimulai di sana. Instalasi › Server Linux menunjukkan caranya. Program server Octoboard, octoboardd, disebut daemon oleh aplikasi.

  • Aplikasi Octoboard di komputer ini, untuk macOS atau Windows, kecuali Anda hanya akan memakai browser.

  1. Masuk ke server lewat SSH sebagai pengguna yang menjalankan Octoboard, jalankan perintah ini, lalu salin baris yang diawali octoboard+ssh://: detail koneksi, yang memberi tahu aplikasi ke mana dan bagaimana terhubung.

    Terminal window
    octoboardd connection

    Jika komputer ini menjangkau server di alamat atau port SSH yang berbeda, tambahkan --host atau --ssh-port ke perintah agar detail koneksi yang dicetak benar.

    Kode QR yang ikut dicetak berisi baris yang sama. Belum ada aplikasi yang memindainya.

  2. Di aplikasi Octoboard di komputer ini, buka Perangkat jarak jauh dari rail di sebelah kiri atau, di macOS, pilih Jarak Jauh › Perangkat Jarak Jauh dari bilah menu. Di Windows, Anda juga dapat memilih Perangkat jarak jauh dari menu sistem jendela atau dari jump list ikon bilah tugas.

  3. Pilih Tambah daemon jarak jauh, lalu Tempel di bawah Detail koneksi untuk mengisi kolom.

  4. Di bawah Autentikasi, pilih Kata sandi jika Anda masuk dengan kata sandi akun Anda. Pilih File kunci jika penyedia server memberi Anda file kunci sebagai gantinya (sering bernama seperti id_ed25519 atau berakhiran .pem), dan masukkan lokasinya di komputer ini.

  5. Pilih Simpan, lalu Hubungkan. Masukkan kata sandi Anda jika diminta.

    Jika Anda menempelkan detail koneksi, identitas server (sidik jarinya) ikut di dalamnya, dan aplikasi memeriksanya untuk Anda. Jika Anda mengetik alamat secara manual, aplikasi menampilkan sidik jari saat pertama kali. Untuk memastikan Anda mencapai mesin yang benar, bandingkan dengan sidik jari yang dicetak perintah ini di server, dan hubungkan hanya jika keduanya cocok:

    Terminal window
    ssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pub

Anda tahu semuanya berhasil saat jendela Octoboard terpisah terbuka, menampilkan proyek dan sesi server.

Anda juga dapat menjangkau Mac atau PC Windows yang menjalankan aplikasi Octoboard.

  1. Di komputer yang ingin Anda jangkau, buka Pengaturan › Akses jarak jauh di Octoboard.
  2. Pilih Buka Pengaturan Sistem (macOS) atau Buka Pengaturan (Windows) di sana, lalu aktifkan Login Jarak Jauh (macOS) atau OpenSSH Server (Windows), dengan mengikuti jalur yang diberikan baris itu, agar komputer ini menerima login SSH. Ini memerlukan administrator. Kembali di Octoboard, baris itu kemudian menampilkan Aktif.
  3. Aktifkan Izinkan akses jarak jauh, pilih Izinkan untuk mengonfirmasi, dan biarkan Octoboard tetap berjalan: jika Anda menutupnya, akses jarak jauh berhenti.
  4. Di tab Aplikasi Octoboard, pilih Salin detail koneksi, dan kirim ke komputer lain, misalnya lewat email atau chat.
  5. Di komputer tempat Anda akan bekerja, tambahkan host seperti pada langkah 2 sampai 5 Terhubung ke server Linux, dengan menempelkan detail yang Anda kirim. Masuk dengan nama pengguna dan kata sandi Anda di host.

Anda tahu semuanya berhasil saat jendela terpisah terbuka dengan proyek dan sesi host.

  1. Dapatkan perintah penerusan SSH:

    • Di host Mac atau Windows, lakukan dulu langkah 1 sampai 3 Gunakan komputer lain sebagai host. Lalu, di tab Browser, lihat Langkah 1: penerusan SSH. Klik alamat di dalam perintah untuk memilih bagaimana komputer lain Anda menjangkau komputer ini (atau pilih Masukkan alamat sendiri dan ganti <server> nanti), lalu pilih Salin perintah penerusan. Pilih juga Salin alamat di bawah Langkah 2: alamat browser.

    • Di server Linux, jalankan ini di server. Perintah ini mencetak alamat browser, lalu perintah SSH yang harus dijalankan.

      Terminal window
      octoboardd address

      Ganti <server> dalam perintah dengan alamat server.

  2. Di komputer yang akan Anda pakai untuk browsing, jalankan perintah SSH di Terminal (macOS) atau PowerShell (Windows). Jendela mungkin meminta kata sandi Anda, lalu tidak menampilkan apa-apa lagi; itu normal. Biarkan terbuka selama Anda bekerja: menutupnya memutus browser.

  3. Buka alamat browser, yang diawali http://127.0.0.1:, di browser Anda.

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

Hanya orang yang dapat menjangkau Octoboard melalui penerusan SSH yang dapat memakai alamat ini. Rahasiakan alamat ini: kuncinya memberi kendali penuh, dan alamat ini tersimpan di riwayat dan bookmark browser, serta tersinkron ke perangkat Anda yang lain jika sinkronisasi browser aktif.

  • “Server tidak dapat dijangkau”, atau perintah SSH menyatakan “Connection refused” atau kehabisan waktu: login SSH nonaktif di host, atau alamat atau port SSH salah. Periksa bahwa Login Jarak Jauh atau OpenSSH Server aktif, dan bahwa Anda dapat masuk dengan perintah ssh di atas.
  • “Tidak dapat masuk”, atau “Permission denied”: nama pengguna, kata sandi, atau file kunci salah.
  • “Kunci host tidak cocok”: mesin yang menjawab bukan mesin yang Anda hubungi sebelumnya. Ini terjadi setelah server diinstal ulang, tetapi bisa juga berarti ada yang tidak beres. Jangan lanjutkan sampai Anda tahu penyebabnya.
  • Halaman browser tidak termuat: jendela SSH ditutup, atau perintahnya berhenti. Jalankan lagi dan muat ulang halaman.
  • Tanpa port publik tambahan: Octoboard hanya menerima koneksi dari host itu sendiri, jadi untuk terhubung dari komputer lain Anda harus masuk dulu ke host lewat SSH. Inilah sebabnya Anda memerlukan SSH, atau salah satu relay.
  • Periksa mesin mana yang Anda jangkau: aplikasi mengingat kunci host, identitas SSH mesin itu, pada koneksi pertama yang berhasil dan memblokir koneksi dengan peringatan jika identitas itu kemudian berubah.
  • Tanpa kata sandi tersimpan: setelah Anda pertama kali masuk dengan kata sandi atau file kunci Anda sendiri, aplikasi menyiapkan kunci SSH terpisah untuk dipakai komputer ini pada login berikutnya.
  • Cabut akses sebuah komputer: hapus entri komputer itu dari daftar kunci SSH yang diizinkan di host (~/.ssh/authorized_keys di Linux dan macOS). Kunci itu lalu tidak dapat masuk lagi; koneksi yang sudah terbuka tetap berjalan sampai berakhir.
  • Satu jendela per tujuan SSH: koneksi dengan nama pengguna, host, atau port SSH yang berbeda masing-masing membuka jendelanya sendiri, sehingga proyek, sesi, dan notifikasinya tidak pernah tercampur.
  • Lihat status setiap koneksi: buka ikon bilah menu aplikasi di macOS atau ikon area notifikasinya di Windows untuk melihat tab bagi setiap koneksi.
  • Buka situs web jarak jauh di sini: saat agen menjalankan situs web di host, klik tautan localhost yang diberikannya, dan aplikasi membuka situs web itu di komputer ini melalui SSH.
  • Buka file jarak jauh di sini: lihat file di jendela jarak jauh atau unduh salinannya untuk dibuka di aplikasi bawaan komputer ini untuk file tersebut.
  • Terhubung kembali otomatis: jika jaringan terputus, jendela terus mencoba terhubung kembali sampai berhasil atau Anda menutupnya.