Panduan Penggunaan Berth

SFTP · Terminal · Konsol Serial dalam satu jendela — dari cara menambah server hingga pintasan keyboard

🚀Memulai

Tata Letak Layar

Ada empat area dalam satu jendela.

Bilah Sisi Situs — di kiri. Server, konsol serial, dan folder ditampilkan sebagai pohon.
Kolom Sesi — sesi-sesi yang tersambung. Garis warna membedakan server yang mana.
Area Kerja — bagian atas adalah panel berkas (lokal · jarak jauh), bagian bawah adalah terminal. Seret garis pembagi untuk mengubah rasionya.
Bilah Status — di paling bawah. Menunjukkan apa yang sedang terjadi saat ini.

Menambahkan Server Pertama

Klik kanan area kosong di bilah sisi, atau tekan ⌘N.
Isi nama dan alamat server. Jika kolom pengguna dan port dikosongkan, nilai bawaan akan dipakai.
Klik dua kali pada daftar untuk menyambung. Klik satu kali untuk memilih.

💡 Jika server itu sudah biasa Anda sambungkan lewat ssh alias di terminal, tidak ada yang perlu ditulis ulang. Impor semuanya sekaligus lewat Impor dari ~/.ssh/config (⌘⇧I) di menu bilah sisi. Daftar situs FileZilla juga bisa diimpor.

Mengganti Bahasa

Pilih salah satu dari 20 bahasa di menu Berth › Pengaturan (⌘,). Secara bawaan bahasa mengikuti bahasa sistem, dan bahasa yang dipilih hanya berlaku untuk aplikasi ini saja. Perubahan berlaku setelah aplikasi dimulai ulang.

🗂Server dan Folder

Mengelompokkan dengan Folder dan Mewariskan Pengaturan

Jika server dikelompokkan dengan Folder (⌘⇧N), pengaturan diwariskan ke bawah. Setel nama pengguna atau tingkat perhatian sekali di folder, dan semua server di dalamnya akan mengikuti. Fitur ini ada agar Anda tidak perlu menuliskan nilai yang sama dua puluh kali untuk dua puluh server.

Setiap kolom di jendela pengaturan menuliskan dari mana nilai itu berasal (apakah Anda yang menetapkannya, atau diwariskan dari folder mana) di bawahnya, dan tombol kembalikan mengembalikannya ke pewarisan.

Tingkat Perhatian — Pengembangan · Staging · Produksi

Tingkat mengalahkan warna. Disetel ke Produksi, tindakan berisiko meminta konfirmasi tambahan. Di daftar sesi diisi dengan warna pilihanmu dan ditandai batas merah, sehingga beberapa server produksi tetap dibedakan lewat warna. Di tempat yang hanya menampilkan satu (dialog konfirmasi dan sejenisnya), tetap merah sebagai peringatan kuat.

Aturan Klik

Satu kali — memilih (untuk melihat pengaturan atau memindahkannya)
Dua kali — menyambung untuk server, membuka/menutup untuk folder
Segitiga di depan folder terbuka dengan satu kali klik.

🔑Koneksi dan Autentikasi

Saat Pertama Kali Terhubung — Izin Folder

Berth mengikuti aturan App Store (sandbox), sehingga tidak membaca folder utama (home) sesuka hati. Saat pertama kali membuka server, Berth akan meminta Anda memilih sekali folder tempat konfigurasi SSH, kunci, dan known_hosts berada (biasanya ~/.ssh). Setelah dipilih sekali, folder itu diingat dan tidak ditanyakan lagi. Jika kunci disimpan di tempat lain, Anda juga bisa memilih folder utama (home).

Panel berkas lokal juga, dengan alasan yang sama, memakai folder yang Anda pilih sebagai akar — bisa diganti lewat Buka Folder Lokal di judul panel, dan pilihan ini juga diingat.

Membaca ~/.ssh/config

Saat menyambung lewat alias, host, port, pengguna, berkas kunci, ProxyJump, dan StrictHostKeyChecking dari entri itu akan dibaca dan dipakai. Meski port yang tersimpan sudah usang, berkas konfigurasi yang menang.

⚠️ Ada dua hal yang tidak bisa dilakukan. ProxyCommand adalah fitur yang menjalankan program eksternal, sehingga diblokir oleh sandbox — tuliskan jump host dengan ProxyJump sebagai gantinya. ssh-agent juga tidak bisa dijangkau, sehingga berkas kunci dibaca langsung, dan untuk kunci berkata sandi, kata sandi akan ditanyakan saat menyambung.

Metode Autentikasi

Otomatis — diserahkan ke ssh. Semua kunci bawaan dicoba, dan jika gagal, kata sandi ditanyakan di terminal.
Berkas Kunci — hanya memakai satu kunci yang ditentukan.
Kata Sandi — melewati kunci.

⚠️ Jika server itu sudah biasa Anda sambungkan hanya dengan ssh di terminal, Otomatis adalah pilihan yang tepat. Menentukan kunci secara khusus — dengan maksud membantu — justru menghalangi koneksi, karena hanya kunci itu saja yang dicoba.

Saat Server Bertanya

Jika kata sandi disimpan, Berth akan menjawabnya satu kali secara otomatis saat menyambung. Pertanyaan lain — kode autentikasi dua langkah, kata sandi yang salah dan perlu diketik ulang, kata sandi untuk kunci berkata sandi — akan muncul apa adanya di jendela "Server Bertanya" persis seperti yang dikirim server, dan Anda menjawabnya sendiri. Agar akun tidak terkunci, kata sandi tersimpan hanya dimasukkan otomatis satu kali, dan hanya ditanyakan hingga tiga kali.

Agar Tidak Perlu Mengetik Kata Sandi Lagi

Klik kanan server dan pilih Daftarkan Kunci Publik ke Server Ini… untuk mengunggah kunci publik dari ~/.ssh ke server. Setelah itu, koneksi berikutnya memakai kunci.

Kata sandi yang disimpan hanya ada di Keychain macOS. Berkas pengaturan hanya menyimpan tanda "tersimpan", bukan nilainya.

Server Belum Pernah Dilihat, Kunci Host yang Berubah

Server yang baru pertama kali disambungkan akan menampilkan jenis dan sidik jari kunci, lalu menanyakan apakah akan diingat. Jika diingat, Berth menuliskannya ke ~/.ssh/known_hosts dengan format yang sama seperti ssh, dan tidak akan ditanyakan lagi setelahnya.

Juga muncul saat identitas server berbeda dari sebelumnya. Bisa jadi serangan man-in-the-middle, bisa juga server yang dipasang ulang. Berth tidak membuat keputusan untuk Anda, melainkan memberikan bahan pertimbangan — jenis dan sidik jari kunci lama/baru, bahkan perintah untuk mencocokkannya langsung di konsol perangkat. Setelah memastikan, tekan "Hapus kunci lama dan ingat kunci baru", maka entri lama akan dihapus (dicadangkan ke known_hosts.old) dan kunci baru dituliskan.

💡 Untuk perangkat yang membuat jendela ini muncul setiap kali — seperti board pengembangan yang sering di-flash ulang — Anda bisa mengaktifkan Jangan Ingat Kunci Host di pengaturan server itu. Agar risikonya terkurung hanya pada perangkat itu, known_hosts tidak disentuh. Tidak bisa diaktifkan pada tingkat Produksi.

Panel Berkas (SFTP)

Mengunggah dan Mengunduh

Kiri adalah Mac Anda, kanan adalah server. Kirim dengan menyeret dan melepas, atau dengan ⌥⌘→ (unggah) · ⌥⌘← (unduh). Progresnya tertumpuk di baris transfer.

Panel Berkas yang Mengikuti Terminal

Jika Anda mengetik cd di terminal, panel remote mengikuti ke folder yang sama. Jika hal ini justru mengganggu, matikan dengan ⌘⇧L.

Tempat Favorit · Tampilan

⌘D — menyematkan atau melepas jalur saat ini dari Sematan. Sematan menjadi akar pohon.
⌘↓ — masuk ke folder yang dipilih. ⌘↑ untuk kembali satu tingkat.
⌥⌘T — tampilan Pohon ↔ Daftar. Untuk folder berisi ribuan berkas, tampilan daftar lebih baik.
⌘R — Baca Ulang.
⌘⇧F — Cari di Server. Bukan aplikasi yang menelusuri daftar, melainkan server yang menjalankan find.

Melihat Perbedaan

Aktifkan dengan ⌘⇧Y untuk membandingkan lokal dan jarak jauh berdampingan, lalu menandai yang berbeda dan yang hanya ada di satu sisi. Berguna saat Anda hanya ingin mengirim yang perlu saja.

🌏 Mac dan Linux menuliskan nama berkas berhuruf Korea, Jepang, atau Vietnam dengan byte yang berbeda. Berth hanya menyamakan nama saat mencocokkan pasangannya, jadi berkas yang terlihat sama tidak akan terpecah menjadi "hanya ada di satu sisi". Untuk transfer sebenarnya, nama yang ada di server dipakai apa adanya.

Menghapus

⌘⌫ secara bawaan memindahkan ke tempat sampah di sisi server, dan selalu meminta konfirmasi. Jika tempat sampah dimatikan di server, Anda akan diberi tahu terlebih dahulu bahwa tindakan ini tidak bisa dibatalkan.

⌨️Terminal

Ini shell sungguhan tempat vim·tmux·less berjalan apa adanya. Pilih dengan menyeret mouse dan salin dengan ⌘C — perintah tertempel bersih, tanpa spasi pengisi di akhir baris.

Konfirmasi Tempel

Jika Anda menempelkan beberapa baris, Berth menunjukkan dulu apa yang akan dijalankan. Sebab tempelan yang mengandung baris baru langsung menjadi perintah begitu masuk. Yang terlihat berisiko ditandai beserta alasannya.

Tampilan Luas

Tekan ⌘↩ untuk memperbesar area saat ini, dan tekan lagi untuk kembali. ⌥⌘↩ hanya memperbesar satu panel. Ukuran huruf diatur dengan ⌘+ · ⌘- · ⌘0. Bersihkan terminal dengan ⌘L — layar dan scrollback dihapus, hanya menyisakan baris prompt saat ini.

🔌Konsol Serial (UART)

Memilih Perangkat

Tambahkan konsol serial dengan ⌃⌘N, lalu pilih perangkat yang terpasang di pengaturan. Berth mengingat perangkatnya, bukan jalurnya — memakai nomor seri jika ada, atau jenisnya jika tidak ada. Perangkat yang sama akan ditemukan meski dicolokkan ke port USB lain.

💡 Nomor seri itu milik perangkat yang terdaftar lewat USB. Jika Anda memakai adaptor USB-serial, yang diingat sebenarnya adalah adaptornya, jadi jika adaptornya diganti, Anda harus memilih ulang.

Kecepatan dan Pengaturan Jalur

Pilih kecepatan dari daftar atau ketik langsung (nilai di luar standar seperti 1,500,000 juga bisa dipakai — asalkan didukung oleh adaptornya). Bawaannya adalah 8N1 · tanpa kontrol aliran, nilai yang dipakai sebagian besar konsol.

Kontrol Aliran — aktifkan hanya saat memakai kabel 4 kawat (RTS/CTS). Mengaktifkannya pada kabel 3 kawat justru menyumbat.
Lanjutan (paritas · bit) — tekan baris untuk membuka. Dipakai hanya saat nilainya berbeda, seperti bootloader STM32 (8E1).

⚠️ UART tanpa kontrol aliran bisa membuat perangkat berhenti mengirim data saat komunikasi berlangsung terus-menerus atau dalam jumlah besar. Ini bukan masalah aplikasi ini saja, melainkan karakteristik jalur itu sendiri (program lain di kabel yang sama akan mengalami hal serupa), dan solusi mendasarnya adalah mengaktifkan kontrol aliran pada kabel 4 kawat, atau menurunkan kecepatan di sisi board.

Papan Riwayat

Dalam sesi serial, perintah yang Anda ketik dan jawabannya tertumpuk di sebelah kanan beserta waktunya. Input pada bagian yang meminta kata sandi disembunyikan.

⚡Pintasan Keyboard

Pintasan aplikasi selalu menyertakan ⌘. Kombinasi ⌃·⌥ milik shell dan TUI (vim·tmux), jadi aplikasi tidak mengambilnya.

⌨️ Tanpa mouse. Setiap tindakan di sini punya pintasan — dibuat untuk yang lebih suka tak melepas tangan dari keyboard.

Tombol	Fungsinya
`⌘N` · `⌃⌘N` · `⌘⇧N`	Tambah Server · Tambah Konsol Serial · Buat Folder
`⌘I` · `⌘⇧I`	Pengaturan Server Ini · Impor dari ~/.ssh/config
`⌘K`	Mau ke mana — cari berdasarkan nama dan langsung pindah
`⌘1` … `⌘9`	Beralih Sesi
`⌃⌘←` `→` `↑` `↓`	Berpindah Antar-Panel
`⌘↩` · `⌥⌘↩`	Perbesar / Kembali · Perbesar Panel Ini Saja
`⌘⇧S` · `⌥⌘↑` `⌥⌘↓`	Bilah Sisi · Menggeser Garis Pembagi
`⌥⌘→` · `⌥⌘←`	Unggah · Unduh
`⌘D` · `⌘R` · `⌥⌘N`	Sematkan/Lepas Sematan · Baca Ulang · Folder Baru
`⌘↓` · `⌘↑` · `⌥⌘T`	Masuk · Kembali · Pohon ↔ Daftar
`⌘⌫` · `⌘⇧F`	Hapus di Jarak Jauh · Cari di Server
`⌘⇧V` · `⌘⇧L` · `⌘⇧Y`	Jalur ke Terminal · Ikuti Terminal · Tampilkan Perbedaan
`⌘+` `⌘-` `⌘0` · `⌘⇧W`	Ukuran Huruf · Tutup Sesi Ini
`⌘L` · `⌘]` `⌘[`	Bersihkan terminal · Ganti tab panel kanan
`⌘C` · `⌘⇧P` · `⌘⇧U` · `⌘?`	Salin · Simpan ke catatan · Kirim ulang manifes · Panduan

❓Pertanyaan yang Sering Diajukan

Di mana kata sandi disimpan?

Hanya disimpan di Keychain macOS. Berkas pengaturan hanya menyimpan tanda "tersimpan". Keychain dibuka hanya sekali, tepat saat menyambung.

Apakah riwayat penggunaan dikumpulkan?

Tidak. Tidak ada instrumentasi apa pun di dalam aplikasi. Apa yang Anda buka atau ke mana Anda menyambung tidak dihitung.

Konsol serial berhenti di tengah jalan.

Ini karakteristik jalur yang muncul saat berkomunikasi dalam jumlah besar lewat UART tanpa kontrol aliran. Jika memakai kabel 4 kawat, aktifkan kontrol aliran (RTS/CTS) di pengaturan; jika 3 kawat, turunkan kecepatan di sisi board atau salurkan keluarannya melalui pager.

Apakah saya perlu menulis ulang pengaturan SSH yang sudah ada?

Tidak. Jika diimpor dari ~/.ssh/config, koneksi memakai alias apa adanya, dan host, port, pengguna, kunci, serta ProxyJump dari entri itu akan dibaca dan dipakai.

Saya punya pengaturan yang memakai ProxyCommand.

ProxyCommand adalah fitur yang menjalankan program eksternal, sehingga tidak bisa dipakai di dalam sandbox App Store. Jika pengaturan Anda melewati jump host, gantilah dengan ProxyJump dan semuanya akan tetap berjalan. ssh-agent juga tidak bisa dipakai karena alasan yang sama; berkas kunci dibaca langsung, dan untuk kunci berkata sandi, kata sandi akan ditanyakan saat menyambung.

Versi macOS apa yang didukung?

macOS 14 (Sonoma) ke atas, mendukung Apple Silicon maupun Intel.

Jika Ini Membantu Anda

Berth gratis. Anda bisa membantu pengembangannya dengan Dukung Kami.