Berth Kullanım Kılavuzu

SFTP · Terminal · Seri Konsol tek pencerede — sunucu eklemekten kısayollara kadar

🚀Başlarken

Ekran Düzeni

Tek pencerede dört alan vardır.

Site kenar çubuğu — sol taraf. Sunucular·seri konsollar ve klasörler ağaç yapısında listelenir.
Oturum sütunu — bağlı oturumlar. Renk şeritleriyle hangi sunucu olduğu ayırt edilir.
Çalışma alanı — üstte dosya paneli (yerel·uzak), altta terminal bulunur. Ayırıcıyı sürükleyerek oranı değiştirin.
Durum çubuğu — en alt. O anda neler olduğunu bildirir.

İlk Sunucuyu Ekleme

Kenar çubuğunun boş bir yerine sağ tıklayın veya ⌘N tuşuna basın.
İsim ve sunucu adresini yazın. Kullanıcı adı·port boş bırakılırsa varsayılan değerler kullanılır.
Listede çift tıklarsanız bağlanılır. Tek tıklama seçim içindir.

💡 Zaten terminalde bir ssh alias ile bağlandığınız bir sunucuysa yeniden yazmanıza gerek yoktur. Kenar çubuğu menüsündeki ~/.ssh/config'ten içe aktar(⌘⇧I) ile hepsini tek seferde içe aktarın. FileZilla site listesi de içe aktarılabilir.

Dili Değiştirme

Menüdeki Berth › Ayarlar(⌘,) içinden 20 dilden birini seçin. Varsayılan olarak sistem dili izlenir, seçtiğiniz dil yalnızca bu uygulamaya uygulanır. Değiştirdikten sonra uygulamayı yeniden başlatınca etkinleşir.

🗂Sunucular ve Klasörler

Klasörle Gruplama ve Miras

Sunucuları bir klasörde(⌘⇧N) grupladığınızda ayarlar aşağı doğru miras alınır. Klasöre bir kullanıcı adı veya dikkat seviyesi bir kez uygularsanız altındaki tüm sunucular bunu izler. Bu, yirmi sunucuya aynı değeri yirmi kez yazmamak için var olan bir mekanizmadır.

Ayarlar penceresindeki her alan, değerin nereden geldiğini(siz mi belirlediniz, hangi klasörden miras alındı) altında gösterir; geri alma düğmesiyle mirasa dönebilirsiniz.

Dikkat Seviyesi — Geliştirme · Staging · Üretim

Kademe rengin önündedir. Üretim olarak ayarlandığında riskli işlemler ek onay ister. Oturum listesinde seçtiğiniz renkle doldurulur ve kırmızı kenarlıkla işaretlenir, böylece birden çok üretim sunucusu yine renkle ayırt edilir. Aynı anda yalnızca birinin göründüğü yerlerde (onay pencereleri vb.) güçlü bir uyarı olarak kırmızı kalır.

Tıklama Kuralları

Tek tıklama — seçim (ayarları görmek veya taşımak için basılan)
Çift tıklama — sunucuda bağlanma, klasörde açma/kapama
Klasör önündeki üçgene bir kez basınca açılır.

🔑Bağlantı ve Kimlik Doğrulama

İlk Bağlantıda — Klasör İzni

Berth, App Store kurallarına (sandbox) uyduğu için ev klasörünü dilediğince okumaz. İlk sunucuyu açtığınızda SSH ayarları·anahtarlar·known_hosts dosyasının bulunduğu klasörü(genellikle ~/.ssh) bir kez seçmenizi ister. Bir kez seçtikten sonra hatırlar ve tekrar sormaz. Anahtarlarınızı başka bir yerde tutuyorsanız ev klasörünü de seçebilirsiniz.

Yerel dosya paneli de aynı nedenle sizin seçtiğiniz klasörü kök olarak kullanır — panel başlığındaki Yerel Klasörü Aç ile değiştirebilirsiniz, bu seçim de hatırlanır.

~/.ssh/config'i Okur

Bir takma adla bağlandığınızda o girişin host·port·kullanıcı·anahtar dosyası·ProxyJump· StrictHostKeyChecking değerleri okunup kullanılır. Kayıtlı port eskiyse bile ayar dosyası önceliklidir.

⚠️ İki şey desteklenmez. ProxyCommand harici bir program başlattığı için sandbox tarafından engellenir — sıçrama sunucusu için ProxyJump kullanın. ssh-agent'a da erişilemez, bu yüzden anahtar dosyası doğrudan okunur; parolalı anahtarlarda bağlanırken parola sorulur.

Kimlik Doğrulama Yöntemi

Otomatik — ssh'a bırakılır. Tüm varsayılan anahtarlar denenir, olmazsa terminalde parola sorulur.
Anahtar Dosyası — belirtilen tek anahtar kullanılır.
Parola — anahtar atlanır.

⚠️ Terminalde sadece ssh ile bağlandığınız bir sunucuysa Otomatik doğrudur. Yardımcı olur diye bir anahtar belirtirseniz bağlantı tam tersine engellenir — çünkü yalnızca belirttiğiniz tek anahtar denenir.

Sunucu Sorduğunda

Parolayı kaydederseniz bağlanırken bir kez sizin yerinize yanıtlanır. Bunun dışındaki sorular — iki adımlı doğrulama kodu, yanlış parolayı yeniden yazma, parolalı anahtarın parolası — "Sunucu soruyor" penceresinde sunucunun gönderdiği soru aynen görünür ve siz kendiniz yanıtlarsınız. Hesap kilitlenmesin diye kayıtlı parola yalnızca bir kez otomatik olarak girilir, en fazla üç kez sorulur.

Parolayı Artık Yazmamak İçin

Sunucuya sağ tıklayıp Bu Sunucuya Ortak Anahtar Kaydet…'i seçerseniz ~/.ssh içindeki ortak anahtar sunucuya yüklenir. Bundan sonra anahtarla bağlanılır.

Kaydedilen parola yalnızca macOS Anahtar Zinciri'nde bulunur. Ayar dosyasında yalnızca "kayıtlı" ibaresi kalır, değerin kendisi yer almaz.

İlk Kez Görülen Sunucu, Değişen Host Anahtarı

İlk kez bağlanılan sunucu için anahtarın türü ve parmak izi gösterilir, hatırlanıp hatırlanmayacağı sorulur. Hatırlarsanız ~/.ssh/known_hosts dosyasına ssh ile aynı biçimde yazılır ve bundan sonra sorulmaz.

Sunucunun kimliği önceki bağlantıdan farklıysa da bu ekran çıkar. Bir ortadaki adam saldırısı da olabilir, sunucunun yeniden kurulmuş olması da. Berth sizin yerinize karar vermez, yalnızca gerekli bilgiyi verir — eski/yeni anahtarın türü ve parmak izi, hatta cihazın konsolunda doğrudan karşılaştıracağınız komut. Doğruladıktan sonra "Eski Anahtarı Sil ve Yeni Anahtarı Hatırla"ya basarsanız eski kayıt silinir(known_hosts.old'a yedeklenir) ve yeni anahtar yazılır.

💡 Sık sık yeniden yazdığınız bir geliştirme kartı gibi bu pencereyi her seferinde gördüğünüz cihazlar için, o sunucunun ayarlarından Host Anahtarını Hatırlama açılabilir. Risk yalnızca o cihazla sınırlı kalsın diye known_hosts dosyasına dokunulmaz. Üretim seviyesinde bu açılamaz.

Dosya Paneli (SFTP)

Yükleme ve İndirme

Solda Mac'iniz, sağda sunucu bulunur. Sürükleyip bırakın veya ⌥⌘→(yükle) · ⌥⌘←(indir) ile gönderin. İlerleme durumu aktarım satırında birikir.

Terminali Takip Eden Dosya Paneli

Terminalde cd yaptığınızda uzak panel aynı klasörü izler. Bu izleme rahatsız ettiğinde ⌘⇧L ile kapatın.

Sık Kullanılanlar · Görünüm

⌘D — şu anki yolu sabitler veya kaldırır. Sabitlenen yol, ağacın kökü olur.
⌘↓ — seçili klasöre girer. ⌘↑ ile bir seviye geri döner.
⌥⌘T — Ağaç ↔ Liste görünümü. Binlerce dosyalı klasörlerde liste daha iyidir.
⌘R — Yeniden oku.
⌘⇧F — Sunucuda ara. Uygulama listeyi taramaz, sunucu find ile arama yapar.

Fark Görünümü

⌘⇧Y ile açarsanız yerel ve uzak yan yana karşılaştırılır, farklı olanlar·yalnızca bir tarafta olanlar gösterilir. Yalnızca gerekeni göndermek istediğinizde kullanılır.

🌏 Mac ve Linux, Korece·Japonca·Vietnamca dosya adlarını farklı baytlarla yazar. Berth adları yalnızca eşleştirirken karşılaştırır, bu yüzden gözle aynı görünen bir dosya "yalnızca tek tarafta var" diye ikiye ayrılmaz. Gerçek aktarımda sunucudaki ad aynen kullanılır.

Silme

⌘⌫ varsayılan olarak sunucu tarafındaki çöp kutusuna taşır ve her zaman onay ister. Çöp kutusu kapalı sunucularda geri alınamayacağı önceden bildirilir.

⌨️Terminal

vim·tmux·less'ın sorunsuz çalıştığı gerçek bir kabuktur. Fareyle sürükleyerek seçip ⌘C ile kopyalayın; komut, satır sonundaki dolgu boşlukları olmadan temiz bir şekilde yapışır.

Yapıştırma Onayı

Birden çok satır yapıştırırsanız neyin çalıştırılacağı önce gösterilir. Satır sonu içeren bir yapıştırma olduğu yerde komut haline geliverdiği için böyledir. Riskli görünenler, nedeniyle birlikte işaretlenir.

Geniş Görünüm

⌘↩ ile şu anki bölgeyi büyütün, tekrar basınca geri dönün. ⌥⌘↩ yalnızca bir paneli büyütür. Yazı boyutu ⌘+ · ⌘- · ⌘0 ile ayarlanır. Terminali ⌘L ile temizleyin — ekran ve kaydırma geçmişi silinir, yalnızca geçerli komut satırı kalır.

🔌Seri Konsol (UART)

Cihaz Seçme

⌃⌘N ile seri konsol ekleyin, ayarlardan takılı cihazı seçin. Berth yolu değil cihazı hatırlar — seri numarası varsa onunla, yoksa türüyle. Başka bir USB girişine taksanız bile aynı cihazı bulur.

💡 Bu seri numarası USB üzerinden numaralandırılan cihaza aittir. USB-seri adaptör kullanıyorsanız aslında hatırlanan adaptördür, bu yüzden adaptörü değiştirirseniz yeniden seçmeniz gerekir.

Hız ve Hat Ayarları

Hız, listeden seçilir veya doğrudan yazılır(1.500.000 gibi standart dışı değerler de olur — adaptörün kabul ettiği bir değer olmalıdır). Varsayılan 8N1 · akış kontrolü yoktur, çoğu konsol bu değeri kullanır.

Akış kontrolü — yalnızca 4 telli kablo (RTS/CTS) kullanırken açın. 3 telli kabloda açarsanız tam tersine tıkanır.
Gelişmiş (Parite · Bit) — satıra basınca açılır. STM32 önyükleyicisi (8E1) gibi farklı durumlarda kullanılır.

⚠️ Akış kontrolü olmayan UART'ta sürekli·yoğun iletişimde cihazın göndermeyi durdurması görülebilir. Bu yalnızca bu uygulamaya özgü bir sorun değildir, hattın kendi doğasıdır (aynı kabloda başka programlar da aynı sonucu verir); kalıcı çözüm 4 telli kabloda akış kontrolünü açmak veya kart tarafındaki hızı düşürmektir.

Kayıt Panosu

Seri oturumda yazdığınız komut ve yanıtı zaman damgasıyla birlikte sağda birikir. Parola sorulan yerdeki girişler gizlenir.

⚡Kısayollar

Uygulama kısayollarında her zaman ⌘ bulunur. ⌃·⌥ kombinasyonları kabuğun ve TUI'nin (vim·tmux) alanıdır, uygulama bunları almaz.

⌨️ Fareye gerek yok. Buradaki her işlemin bir kısayolu var — ellerini klavyeden ayırmak istemeyenler için.

Tuş	İşlev
`⌘N` · `⌃⌘N` · `⌘⇧N`	Sunucu ekle · Seri konsol ekle · Klasör oluştur
`⌘I` · `⌘⇧I`	Bu sunucunun ayarları · ~/.ssh/config'ten içe aktar
`⌘K`	Nereye gidelim — isimle arayıp doğrudan git
`⌘1` … `⌘9`	Oturum değiştirme
`⌃⌘←` `→` `↑` `↓`	Paneller arası geçiş
`⌘↩` · `⌥⌘↩`	Büyüt / geri dön · yalnızca bu paneli büyüt
`⌘⇧S` · `⌥⌘↑` `⌥⌘↓`	Kenar çubuğu · ayırıcıyı taşıma
`⌥⌘→` · `⌥⌘←`	Yükle · indir
`⌘D` · `⌘R` · `⌥⌘N`	Sabitle/kaldır · yeniden oku · yeni klasör
`⌘↓` · `⌘↑` · `⌥⌘T`	İçine gir · geri dön · ağaç↔liste
`⌘⌫` · `⌘⇧F`	Uzaktan sil · sunucuda ara
`⌘⇧V` · `⌘⇧L` · `⌘⇧Y`	Yolu terminale gönder · terminali takip et · farkı göster
`⌘+` `⌘-` `⌘0` · `⌘⇧W`	Yazı boyutu · bu oturumu kapat
`⌘L` · `⌘]` `⌘[`	Terminali temizle · Sağ panel sekmelerini değiştir
`⌘C` · `⌘⇧P` · `⌘⇧U` · `⌘?`	Kopyala · Kayda al · Manifestoyu tekrar gönder · Kullanım kılavuzu

❓Sık Sorulan Sorular

Parola Nerede Saklanır?

Yalnızca macOS Anahtar Zinciri'nde saklanır. Ayar dosyasında yalnızca "kayıtlı" ibaresi kalır. Anahtar zinciri bağlanma anında yalnızca bir kez açılır.

Kullanım Verisi Toplanıyor mu?

Hayır. Uygulama içinde hiçbir ölçüm yoktur. Neyin açıldığı, nereye bağlanıldığı sayılmaz.

Seri Konsol Aniden Duruyor.

Akış kontrolü olmayan UART'ta yoğun iletişim yaparsanız ortaya çıkan bir hat özelliğidir. 4 telli kabloysanız ayarlardan akış kontrolünü (RTS/CTS) açın; 3 telliyseniz kart tarafındaki hızı düşürün veya çıktıyı sayfa sayfa bölün.

Zaten Kullandığım SSH Ayarlarını Yeniden mi Yazmalıyım?

Hayır. ~/.ssh/config'ten içe aktarırsanız takma ad aynen kullanılarak bağlanılır ve o girişin host·port· kullanıcı·anahtar·ProxyJump değerleri okunup kullanılır.

ProxyCommand Kullanan Bir Ayarım Var.

ProxyCommand harici bir program başlattığı için App Store'un sandbox'ında kullanılamaz. Sıçrama sunucusu üzerinden geçen bir ayarsa ProxyJump'a çevirmeniz yeterlidir. ssh-agent de aynı nedenle kullanılamaz; anahtar dosyası doğrudan okunur ve parolalı anahtarlarda bağlanırken parola sorulur.

Desteklenen macOS Sürümü Nedir?

macOS 14 (Sonoma) ve üzeri, hem Apple Silicon hem Intel desteklenir.

Faydalı Olduysa

Berth ücretsizdir. Destek olun diyerek geliştirmeye katkıda bulunabilirsiniz.