sshpocket

🇹🇷 Türkçe · 🇬🇧 English

macOS için, USB bellekten (veya herhangi bir klasörden) çalışan bir SSH bağlantı menüsü. Her sunucu servers/<ad>/ altında bir klasördür: menüden ekleyin ya da ~/.ssh/config'ten içe aktarın; passphrase macOS Keychain'de durur. İsterseniz imzalı paketlerle (şimdilik sunucu sertleştirme ve saat/locale ayarı) sunucuyu yönetebilirsiniz.

Durum: ham / erken aşama. 🛠️ Bu, kişisel bir HomeLab aracından çıkan bir proje. Claude ile elden geçirildi ve ilk hâline göre epey toparlandı, ama hâlâ geliştirilecek çok yeri var: pürüzler, eksik testler ve yazılmamış özellikler olabilir. Sorunlar projenin hamlığından kaynaklanır; bunun için kimseye kızmayın 😄 — issue ve PR'larla yardım etmeniz çok makbule geçer. İstemci olarak yalnızca macOS'ta denendi (sunucu tarafında neyin denendiği: docs/test-edilen-ortamlar.md). Kendi sunucularınızda kullanmadan önce kodu okuyun; kullanım sorumluluğu size aittir (bkz. LICENSE).

Otomatik başlamaz. macOS, Linux ve modern Windows USB takılınca script çalıştırmaz (güvenlik gereği). Elle başlatın: ./start.sh ya da Finder'da start.command dosyasına çift tıklayın.

Gereksinimler

Standart bir macOS'ta ek bir şey kurmanız gerekmez; araç yalnızca sistemle gelen komutları kullanır:

Ne	Not
macOS 10.15 (Catalina) veya yenisi	İmzalı güncelleme ssh-keygen -Y verify ister (OpenSSH ≥ 8.0)
bash 3.2 (/bin/bash), ssh, ssh-keygen, ssh-add, ssh-copy-id, security, osascript, diskutil, curl, tar, shasum, nc	Hepsi macOS ile gelir; ./start.sh --doctor eksik olanı söyler (hiçbir şey kurmaz)

İsteğe bağlı:

Ne	Ne işe yarar	Kurulum
fzf	Menülerde arama ve açıklama önizleme penceresi. Yoksa yerleşik ok tuşlu menü kullanılır. (0.74.5 ile denendi)	brew install fzf
Python ≥ 3.12	Yalnızca paketler (örn. linux-hardening) için; günlük kullanımda gerekmez. macOS'un sistem Python'u (3.9) yetmez	brew install python@3.13

fzf Homebrew'da /opt/homebrew/bin ya da /usr/local/bin altındaysa Finder'dan (start.command) açıldığında da bulunur.

Hızlı başlangıç

./start.sh                          # menüyü başlat

Ana menüden her şey yapılır: sunucuya bağlanma, ➕ Yeni sunucu ekle, 📥 ~/.ssh/config'ten içe aktar ve 🛠️ Sunucuları yönet (listele/sil/yeniden adlandır). Aynı işler komut satırından da çalışır:

bash sistem/ModuleGenerator.sh      # yeni sunucu ekle
bash sistem/ImportSSHConfig.sh      # ~/.ssh/config'teki sunucuları içe aktar
bash sistem/ModuleManager.sh list   # sunucuları listele (remove / rename de var)

Sunucu ekleme (generator) size IP/kullanıcı/port sorar, isterseniz ed25519 anahtar üretir ve passphrase'i macOS Keychain'e kaydeder.

Özellikler

• Sunucu başına klasör: her sunucu servers/<ad>/ altındadır; menü kendiliğinden oluşur.
• Keychain: passphrase diske yazılmaz.
• Key'i sunucuya gönderme: menüden veya generator'dan ssh-copy-id (aşağıya bakın).
• ~/.ssh/config içe aktarma: mevcut sunucularınızı tek komutla sunucu kaydına çevirir. Private key'ler kopyalanmaz; IdentityFile yolu sunucunun server.env dosyasına KEY olarak yazılır.
• Mevcut key kullanımı: servers/<ad>/server.env içine KEY=/yol/key yazın (örn. ~/.ssh/id_ed25519).
• Durum göstergesi: menüde 🟢 (port açık) / 🔴 (erişilemiyor) / ⚪ (ayar yok) gösterilir; sunucular paralel kontrol edilir. ⚙️ Ayarlar'dan kapatılabilir/süresi değiştirilebilir (sshpocket.conf; ortam değişkeni SSHPOCKET_STATUS=0|1 önceliklidir).
• Port knocking (istemci tarafı): sunucu menüsünden Knock ayarları; dizi (örn. 7000,8000,9000) Keychain'de durur, bağlanmadan önce otomatik gönderilir, durum göstergesinde 🔒. Sunucu tarafı (knockd) kurulumu bu araçta yoktur; sunucuda yöneticinin tanımlamış olması gerekir. Klasik knocking şifreli değildir.
• Sunucu menüsü: Bağlan · Key'i sunucuya gönder · Bilgileri güncelle (IP/kullanıcı/port/key yolu) · Keychain passphrase'ini güncelle/sil (kayıttan sonra key'i açarak doğrular). Ayar bozuk veya key eksikken de güncelleme seçenekleri kullanılabilir.
• Sunucu yönetimi: ModuleManager.sh list | remove <ad> | rename <eski> <yeni>.
• Aynı sunucuya birden çok kullanıcı/key: her biri ayrı bir sunucu kaydı olur (örn. web_root, web_deploy).
• Menü: ↑↓ gez · Enter aç · ←/q geri; numara yazmak da çalışır; her seçeneğin kısa açıklaması görünür. fzf kuruluysa menüler fzf ile açılır (arama + açıklama önizleme penceresi). Stil ⚙️ Ayarlar'dan (UI: auto · fzf · arrows · numbers) ya da SSHPOCKET_UI=numbers ./start.sh ile değişir; bir terminalde sorun çıkarırsa numbers yapın.
• ./start.sh --doctor: ön koşul denetimi (ssh araçları, Python aralığı, venv, disk, ağ); yalnızca okur, hiçbir şey kurmaz.
• Paketler ve güncelleme: imzalı, kilitli (components.lock) paketler (şimdilik linux-hardening ve utility) ana menüde 📦 Paketler ve güncelleme altında; her eylem önizleme ve onay kapılarından geçer, sudo parolası Ansible'ın kendi isteminden alınır. Komutlar, platform seçimi ve hardening_ssh_allow_from zorunluluğu: docs/paketler.md · hardening kullanımı ve erişim ağı tuzağı: docs/hardening-kullanim.md.
• Test edilenler: macOS (Intel ve Apple Silicon) elle denendi; CI'da macOS (bash 3.2) ve Ubuntu 26.04. Neyin denenip neyin denenmediği: docs/test-edilen-ortamlar.md.
• Otomatik testler (Bats, Linux'ta bash 5.3 ve macOS bash 3.2) + ShellCheck her PR'da CI'da çalışır.

Key'i sunucuya gönderme

Sunucu menüsünden 2) Public key'i sunucuya gönder seçeneği (veya generator'ın son adımı) ssh-copy-id çalıştırır:

• Key sunucuda zaten yetkiliyse bunu söyler ve bir şey yapmaz.
• Değilse ssh-copy-id önce agent'taki/varsayılan key'leri, olmazsa parolayı dener. İsterseniz giriş için başka bir key dosyası yolu da verebilirsiniz.
• Parola yalnızca ssh'ın kendi isteminde girilir; script'e hiç uğramaz.
• Sunucuda PasswordAuthentication no yapmak bilerek otomatik değildir. Key ile girişin çalıştığını gördükten sonra elle yapın, yoksa kendinizi dışarıda bırakabilirsiniz.

Eski sürümden geliyorsanız

v3 öncesi sistem/Modules/<ad>/ sunucuları otomatik taşınır (./start.sh --migrate --dry-run, sonra ./start.sh --migrate); eski klasörler silinmez. Ayrıntı: docs/eski-duzenden-tasima.md.

Güncelleme

Otomatik değildir; siz başlatırsınız: ./start.sh --check-update (yalnızca bakar) ve ./start.sh --update (indir → imzayı doğrula → notları göster → onaylarsanız kur) ya da ana menüden ⬆️ Güncellemeleri kontrol et / güncelle. Paket yalnızca bu reponun GitHub Release'lerinden HTTPS ile inen ve bakımcının imza anahtarıyla imzalı dosyadır (ssh-keygen -Y verify); doğrulanamazsa hiçbir şey kurulmaz, imza anahtarı tanımlı değilse güncelleme kapalıdır. Sunucularınız, ayarlarınız ve key'leriniz korunur; hata olursa kodun yedeği geri yüklenir. Ayrıntı: docs/guncelleme.md.

İlk indirmeyi doğrulama

--update imzayı kendisi doğrular, ama ilk kopyayı (Release sayfasından indirdiğiniz arşivi) doğrulayamaz: ona güveniniz GitHub'a ve HTTPS'e dayanır. İsterseniz arşivi açmadan önce kendiniz doğrulayın (OpenSSH ≥ 8.0, macOS'ta hazır). Anahtarın parmak izi SHA256:0gjAyj8b7VlmtHIFbwmgAmKjK06sw/a5wdEoE8UECwU; bunu bakımcıdan başka bir yoldan da teyit etmeniz, depodaki dosyaya körü körüne güvenmekten iyidir.

# Release'ten sshpocket-X.Y.Z.tar.gz ve sshpocket-X.Y.Z.tar.gz.sig dosyalarını indirdikten sonra:
cat > /tmp/sshpocket_signers <<'EOF'
sshpocket-release namespaces="sshpocket-release" ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIKVJS3mGlCaOT/l8XfR0TxuKxqLUs6PpVDa9TYqm0fLn
EOF
ssh-keygen -Y verify -f /tmp/sshpocket_signers -I sshpocket-release -n sshpocket-release \
  -s sshpocket-X.Y.Z.tar.gz.sig < sshpocket-X.Y.Z.tar.gz        # "Good ... signature" yazmalı

Güvenlik modeli

• Passphrase diske yazılmaz. Keychain'de durur (USBMonitor_<ÖNEK>_Passphrase), ssh-add'e SSH_ASKPASS ile doğrudan aktarılır.
• server.env yalnızca IP, kullanıcı, port (ve ops. key yolu, knock ayarı) içerir. Gizli bilgi içermemelidir; knock dizisi de Keychain'dedir.
• TOTP/2FA gizli anahtarlarını bu klasörde saklamayın; telefondaki uygulamada tutun.
• servers/, sshpocket.conf, id_ed25519* ve usb_logs/ .gitignore ile dışarıda tutulur.
• Güncellemeler ve paketler imzalıdır; güncelleme elle başlatılır (yukarıya bakın). Paket eylemleri sunucuya yazmadan önce önizleme ve onay kapılarından geçer.
• IP/kullanıcı/port değerleri komut çalıştırılmadan önce doğrulanır (kullanıcı - ile başlayamaz).
• Sunucu host key'i ilk bağlantıda size sorulur (otomatik kabul yoktur).
• Özel anahtarınızı USB'de taşıyorsanız USB'yi (APFS şifreli birim) şifreleyin.
• Güvenlik açığı bildirimi için: SECURITY.md.

Yapı

start.sh / start.command   giriş noktaları
sistem/Main.sh             menü döngüsü
sistem/Autoload.sh         eski sistem/Modules/ altını yükler (taşınana kadar)
sistem/ModuleGenerator.sh  yeni sunucu (+ key üretimi, Keychain, ssh-copy-id)
sistem/ImportSSHConfig.sh  ~/.ssh/config içe aktarma
sistem/ModuleManager.sh    list / remove / rename
sistem/Helpers/            Log, Menu/UI, kayıt, doğrulama, SSH, Keychain, ayarlar, güncelleme, paket (Components*) yardımcıları
components.lock            paket kilit dosyası (imzalı sürümle gelir); kurulu paketler: components/
servers/<ad>/              her sunucu için: server.env, id_ed25519_<ad>   (eski: sistem/Modules/<ad>/ → ./start.sh --migrate)
sistem/templates/          server.env.example şablonu
test/                      Bats testleri (bats test)
docs/                      ayrıntılı belgeler (paketler, güncelleme, test edilen ortamlar, standart)
img/                       README görselleri (release arşivine girmez)

Geliştirme

brew install shellcheck bats-core
shellcheck -x -s bash start.sh start.command sistem/*.sh sistem/Helpers/*.sh
bats test

Katkı için CONTRIBUTING.md, planlananlar için ROADMAP.md.

Destek

sshpocket ücretsiz ve MIT lisanslı kalacak. Faydalı bulduysanız GitHub Sponsors üzerinden destek olabilirsiniz; yıldız, hata bildirimi ve katkı da en az onun kadar değerli.

Lisans

MIT, bkz. LICENSE.