KeyLab, eski adıyla sshpocket. Komut ve dosya adları (sshpocket.conf,
sshpocketikilisi, imza ad alanı) şimdilik değişmedi.
🇹🇷 Türkçe · 🇬🇧 English
macOS için, USB bellekten (veya herhangi bir klasörden) çalışan tek dosyalık bir SSH sunucu yöneticisi: yerel web arayüzü + komut satırı.
Her sunucu servers/<ad>/ altında bir klasördür; passphrase macOS Keychain'de durur.
İmzalı paketlerle (şimdilik linux-hardening: sunucu sertleştirme; utility: saat dilimi/dil/NTP ayarı ve Docker, nginx, MariaDB, Redis gibi uygulamaların kurulumu) sunucuyu yönetebilirsiniz.
Sürüm 4 ile sshpocket (şimdi KeyLab) Go'da yeniden yazıldı. Eski kabuk (bash) motoru depodan kaldırıldı; son hâli git geçmişinde ve
kabuk-referansietiketinde duruyor. Go sürümü onunla yan yana karşılaştırmalı testlerle doğrulandı; kabuğun çıktılarıtestdata/altında altın dosyalar olarak saklanır.
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:
KeyLab.app'e çift tıklayın (ya da Finder'dastart.command, ya da./sshpocket).
- Release sayfasından
keylab-X.Y.Z-macos.zipdosyasını indirin ve açın:KeyLab.appçıkar. - Nasıl kullanacağınıza göre yerleştirin:
- Normal:
KeyLab.app'i Uygulamalar'a sürükleyin. Verileriniz~/.keylab/altında tutulur (ilk açılışta oluşur). - USB / taşınabilir:
KeyLab.app'i USB belleğe (ya da başka bir harici sürücüye) koyup açın;servers/,components/vestate/ilk açılışta uygulamanın yanında kendiliğinden oluşur (klasör açmanız gerekmez). Harici olmayan bir klasörde taşınabilir çalıştırmak için yanına birservers/klasörü koyun. Salt okunur bir diskten (ör. disk imajı) açarsanız yazılamadığı için~/.keylabkullanılır ve uyarı verilir. Sunucularınız ve anahtarlarınız (servers/) ile durum ve günlükler (state/) orada kalır. Taşınabilirde bilgisayarda kalan izler: Python ortamı (Ansible) ve ayrı tarayıcı profili geçici bir klasörde ($TMPDIR/keylab-…) tutulur ve Çıkış/kapatma ile silinir (her oturumda paket ortamı yeniden kurulur);known_hostsUSB'dekistate/altında durur. Misafir mod (taşınabilirde otomatik): KeyLab kendi özelssh-agent'ını başlatır; anahtarlar yalnız onda durur, passphrase her oturumdassh-addisteminde sorulur ve hiçbir yere kaydedilmez, kapatınca ajan sonlanır. Bu bilgisayarın Keychain'ine ve sizinssh-agent'ınıza dokunulmaz (Ayarlar'da "Mod" satırı görünür). Passphrase'i her oturumda yazarsınız; isterseniz şifreli kasaya (aşağıya bakın) kaydedip tek ana parolayla açabilirsiniz, port knocking dizisi de orada durur. Çıkış düğmesi ajanı ve geçici klasörü hemen siler, USB'yi çıkarır ve kapanış ekranında neleri temizlediğini ve bilgisayarda neler kaldığını listeler. Misafir modu kapatmak içinKEYLAB_GUEST=0verin (taşınabilirde bile Keychain kullanılır). Gömülü pencerenin WebKit verisi (~/Library/WebKit/…ve~/Library/Caches/…altında) misafir modda pencere kapanınca ve her açılışta silinir. Hâlâ kalanlar: macOS'un kendi izleri (Spotlight, son kullanılanlar, sistem günlükleri). KeyLab kapatılmadan (güç kesilirse ya da SIGKILL) geçici klasör ve özel ajan süreci kalabilir; ajan yalnız bellekte tutar, soketi geçici klasörle birlikte silinir.
- Normal:
KeyLab.app'e çift tıklayın; arayüz uygulamanın kendi penceresinde açılır (Chrome ya da başka bir tarayıcı gerekmez; pencereyi kapatınca KeyLab de kapanır). Komut satırından-browser defaultsistem tarayıcısını,-browser auto(varsayılan) pencereyi kullanır. Çıkarmak için arayüzdeki Çıkış düğmesi (USB'den çalışıyorsanız anahtarları ajandan silip USB'yi de çıkarır).- İlk açılışta macOS uyarı verebilir ("doğrulanamadı"): uygulama Apple'ın noter onayından geçmedi (ücretli Developer ID gerekir), ama imzalıdır. Sağ tıklayıp Aç'ı seçin (macOS 15 ve sonrasında: Sistem Ayarları → Gizlilik ve Güvenlik → "Yine de aç"). Güvenmeden önce indirdiğiniz dosyayı aşağıdaki İlk indirmeyi doğrulama adımıyla kontrol etmenizi öneririz.
- Paketler (linux-hardening, utility): ilk açılışta kurulu paket yoktur. Paketler sayfasındaki Paketleri keşfet ve kur düğmesiyle kurun; imza anahtarları ve paket kilidi uygulamanın içinde gelir, her paket imzası ve özeti doğrulanarak kurulur (internet gerekir).
- Güncelleme: Ayarlar > Güncelleme > "Güncellemeyi denetle" (KeyLab kendiliğinden internete çıkmaz; siz başlatırsınız): yeni sürüm ve GitHub sürüm notları gelir, "Güncelle ve yeniden başlat" paketi indirir, imzasını doğrular,
KeyLab.app'i bütünüyle değiştirir (eskisi.keylab-update-backup/altında yedeklenir) ve yeniden açar. Uygulamanın klasörü yazılabilir olmalı (Uygulamalar ya da USB) ve.appolarak çalışmalısınız; olmuyorsa neden kartta yazar. USB'den (exFAT/FAT) güncelleme 4.0.13'ten itibaren desteklenir; ondan eski sürümlerden bir kez elle geçmeniz gerekir. İsterseniz yine yeni sürümün zip'ini indirip eskisinin yerine koyabilirsiniz (verilerinizservers/ya da~/.keylab/içinde kalır)../sshpocket updatekomutu tek başına ikili içindir;.apppaketinin içindeki ikiliyi değiştirmek paketin imza mührünü bozar, bu yüzden.appiçin önerilmez (Finder'dan açılışının bundan etkilenip etkilenmediği denenmedi). - Python (yalnızca paketler için): sunucu yönetimi, terminal, anahtarlar ve port knocking Python olmadan çalışır. Paketler (linux-hardening, utility) Ansible kullanır ve Python ≥ 3.12 ister; uygun Python yoksa KeyLab paket eylemini başlatmadan önce bir pencerede neyi nasıl kuracağınızı söyler (kendisi kurmaz; Python ve Ansible'ı kendi içinde de taşımaz).
| Ne | Not |
|---|---|
| macOS 27 veya üstü, Apple Silicon (arm64) | Yalnızca güncel macOS ve Apple Silicon desteklenir; Intel ve eski macOS sürümleri için yayın yapılmaz |
ssh, ssh-keygen, ssh-add, ssh-copy-id, security, osascript, diskutil |
Hepsi macOS ile gelir; ./sshpocket doctor eksik olanı söyler (hiçbir şey kurmaz) |
| Python ≥ 3.12 | Yalnızca paketler (Ansible) için; brew install [email protected]. sshpocket gerekli sanal ortamı kendisi kurar |
İmza doğrulama, indirme, arşiv ve port yoklaması ikilinin içindedir; curl, tar, shasum, nc ve bash gerekmez.
./sshpocket # yerel web arayüzünü başlatır (127.0.0.1, jetonlu adres)
./sshpocket doctor # ön koşul denetimi (yalnızca okur)
./sshpocket components list # paketler: kilit ↔ kurulu durumu
./sshpocket components run utility durum ubuntutest # bir paket eylemini komut satırından çalıştır
./sshpocket versionArayüzde sunucu ekleme (ad, adres, kullanıcı, port), anahtar adımları (üretme, sunucuya gönderme, ajana ekleme),
yeniden adlandırma, silme, değişken düzenleme ve paket eylemleri (önizleme → onay → uygulama) vardır.
Arayüz yalnızca 127.0.0.1'e bağlanır; oturum çerezi ister.
sshpocket ikili (Release'ten indirilen keylab-X.Y.Z-darwin-arm64 dosyası bu adla)
start.command çift tıkla başlatıcı
release_signers güncelleme güven noktası (imzacı public key)
index_signers paket indeksi güven noktası
components.lock paket kilidi; components/ kurulu paketler
servers/<ad>/ server.env + id_ed25519_<ad> (kullanıcı verisi, repoya girmez)
Veri nereye gider? ./sshpocket yanında servers/ varsa (USB ya da klasör) taşınabilir çalışır: her şey o klasörde kalır.
Yoksa kurulu gibi çalışır: ilk açılışta ~/.keylab/servers ve ~/.keylab/components oluşturulur. İsterseniz -servers/-components ya da KEYLAB_SERVERS ile yer gösterebilirsiniz.
-
Sunucu başına klasör, Keychain'de passphrase (diske yazılmaz),
ssh-addile ajana ekleme (Keychain parolasıyla; yanlışsa yeniden kaydetme sorusu). -
Anahtarı sunucuya gönderme (
ssh-copy-id): anahtar zaten yetkiliyse bir şey yapmaz; parola yalnızca ssh'ın kendi isteminde girilir;PasswordAuthentication nobilerek otomatik değildir. -
Paketler: imzalı, kilitli (
components.lock). Her eylem önizleme, önkoşul ve onay kapılarından geçer; sudo parolası Ansible'ın kendi isteminden alınır; günlükler0600ve parola maskelenerek arşivlenir. Ayrıntı: docs/paketler.md · hardening: docs/hardening-kullanim.md. -
Güncelleme:
./sshpocket update(aşağıya bakın) ve paketler içincomponents update | upgrade. -
Rapor:
components reportpaket sürümü değişince "ne değişti, hangi sunucum etkileniyor" gösterir. -
USB çıkarma:
./sshpocket eject(USB'deki anahtarları ajandan silip çıkarır). Arayüzde üst çubuktaki Çıkış düğmesi aynı işi yapar ve uygulamayı kapatır. -
Test edilenler: docs/test-edilen-ortamlar.md — neyin denenip neyin denenmediği orada.
-
~/.ssh/configiçe aktarma:./sshpocket servers import-ssh-config [dosya](private key kopyalanmaz;IdentityFileyoluKEYolarak yazılır). -
Port knocking (istemci): arayüzdeki sunucu adımlarından ya da
./sshpocket servers knock <ad>; dizi Keychain'de durur, "Terminal'de aç" bağlanmadan önce otomatik gönderir. Sunucu tarafı (knockd) bu araçta yoktur; klasik knocking şifreli değildir. -
Keychain parolası:
./sshpocket servers keychain <ad>(kaydet/güncelle/sil, kayıttan sonra anahtarı açarak doğrular). -
Ayarlar:
sshpocket.conf(STATUS=on|off,STATUS_TIMEOUT=1-5; ortam değişkeniSSHPOCKET_STATUSönceliklidir)../sshpocket settingsdeğerleri gösterir,settings set STATUS_TIMEOUT 3yazar. -
Gömülü terminal: sunucu sayfasında "Gömülü terminal" tarayıcıda
ssh -ttoturumu açar; en çok 4 oturum, pencere küçültülünce oturumlar açık kalır ve altta bir çubukta durur (macOS ve Linux; Windows'ta henüz yok). Yerel shell açılmaz, yalnız kayıtlı sunucuya bağlanır; açma/kapama durum klasöründeterminal-audit.logdosyasına yazılır. -
Sunucu karşılaştırma ve raporlar: "Karşılaştır" sayfası sunucuları sütun sütun yan yana koyar ve farklı olan satırları işaretler (Markdown/CSV/JSON dışa aktarma; CSV hücreleri formül enjeksiyonuna karşı korunur). "Raporlar" dört şablonlu (filo, sunucu denetimi, Lynis bulguları, drift) yazdırılabilir rapor üretir (görsel, Markdown, JSON). Adı parola/token/secret geçen değişkenlerin değerleri maskelenir.
-
~/.ssh/configiçe aktarma (arayüz): "Sunucu ekle" sayfasından; tarayıcı yalnız takma adı gönderir, adres/kullanıcı/port sunucuda dosyadan yeniden okunup doğrulanır. -
Envanter yedeği: Ayarlar > Envanter yedeği. Yedek sır içermez (private key yolu, knock, parola/token adlı değişkenler yok) ama sunucu adreslerini içerir. İçe aktarma önce önizleme gösterir; var olan sunucular yalnız siz seçerseniz değişir ve doğrulama uygulamanın kendi kurallarından geçer.
-
İş izleyici: çalışan eylem "Arka plana al" ile küçültülür; üst çubuktaki iş düğmesi süreyi/sonucu gösterir ve sayfa yenilense bile çalışan işe yeniden bağlanır. İş çalışırken başka eylem başlatılamaz.
-
Gizlilik kilidi:
Ltuşu ya da Ayarlar'dan boşta süresiyle ekranı gizler. Bu bir parola kilidi DEĞİLDİR, yalnızca yan masadakinin ekranı görmesini engeller; varsayılan kapalıdır. -
Vurgu rengi: Ayarlar'dan 8 vurgu rengi (açık/koyu temada WCAG AA kontrastı doğrulanmış).
-
Uygulama kataloğu:
utilitypaketinde (veitemsbildiren paketlerde) sunucu sayfasında uygulama kartları (Docker, nginx, MariaDB, Redis; kurulu/kurulabilir süzgeci); kurulum "Genel eylemler"den yapılır; sayfanın üstünde Saat ve NTP kartı (NTP durumunu oku/ayarla).itemsbildiren paketlerde kartlarda öğeye özel Önizle/Kur/Yükselt/Kaldır düğmeleri çalışır ve önkoşul kapısı öğe ve mod kapsamlıdır (docs/package-standard.md); utility'nin kartlarındaki düğmeler henüz kapalıdır. -
Şifreli kasa: ana parolayla açılan kasa (PBKDF2-HMAC-SHA256 + AES-256-GCM); anahtar passphrase'leri ve port knocking dizisini tutar, özel ssh-agent'a yükler. Açılışta giriş ekranı, boşta (varsayılan 15 dk,
KEYLAB_VAULT_IDLE_MIN) ya da elle kilitlenir; yanlış parolada bekleme süresi artar. Bu Mac'e güveniyorum (Ayarlar): işaret dosyası~/.keylab/keychain-okvarsa taşınabilirde bile Keychain ve kendi ssh-agent'ınız kullanılır. -
Kaynaklar sayfası: KeyLab'ın kendi CPU/RAM/disk kullanımı ve çalışanları (Etkinlik Monitörü gibi, yalnız KeyLab'a ait).
-
Dil: arayüz Türkçe ve İngilizce (üst çubuktaki TR/EN düğmesi).
Terminal menüsü (fzf dâhil) bilerek taşınmadı; sunucu taşıma (--migrate, eski sistem/Modules düzeni) taşınmadı.
Durum göstergesi, port kapalı ve knock etkinse 🔒 "knock gerekir" gösterir; panodaki "ssh komutunu kopyala" knock etkinse önce knock'u gönderen tek bir komut verir. Bakımcı aracı: ./sshpocket components lock <paket> <sürüm> [--repo sahip/depo] [--write] (components.lock girdisini imzayı doğrulayarak üretir; --write olmadan yalnız gösterir).
Otomatik değildir; siz başlatırsınız: ./sshpocket update --check (yalnızca bakar) ve ./sshpocket update (indir → imzayı doğrula → sürümü teyit et → onaylarsanız kur).
Güncelleme yalnızca bu reponun GitHub Release'lerinden HTTPS ile inen ve bakımcının imza anahtarıyla imzalı ikiliyi kurar; imza doğrulanamazsa, ikilinin bildirdiği sürüm etiketle uyuşmazsa ya da geri sürüme düşülecekse hiçbir şey kurulmaz; imza anahtarı tanımlı değilse güncelleme kapalıdır.
Yerleştirme atomiktir, eski ikili .update-backup/ altına yedeklenir; servers/, components/ ve anahtarlarınıza dokunulmaz. Ayrıntı: go/YAYIN.md.
update imzayı kendisi doğrular, ama ilk kopyayı (Release sayfasından indirdiğiniz dosyayı) doğrulayamaz: ona güveniniz GitHub'a ve HTTPS'e dayanır.
İsterseniz çalıştırmadan ö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 keylab-X.Y.Z-macos.zip ve .sig dosyalarını indirdikten sonra
# (komut satırı ikilisi için keylab-X.Y.Z-darwin-arm64 ve .sig; aşağıda dosya adlarını ona göre değiştirin):
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 keylab-X.Y.Z-macos.zip.sig < keylab-X.Y.Z-macos.zip # "Good ... signature" yazmalı- Passphrase diske yazılmaz. Keychain'de durur (
USBMonitor_<ÖNEK>_Passphrase),ssh-add'eSSH_ASKPASSile doğrudan aktarılır. server.envyalnı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/,id_ed25519*ve günlükler.gitignoreile dışarıda tutulur.- Güncellemeler ve paketler imzalıdır; güncelleme elle başlatılır (yukarıya bakın). Kendini güncelleyen ikili de aynı imza anahtarına bağlıdır. 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.
go/ Go kaynağı (ana ürün): main + internal/{manifest,trust,runner,servers,cli,report,findings,selfupdate,eject,doctor,settings}
go/web/ gömülü web arayüzü
go/YAYIN.md yayın biçimi ve sürüm çıkarma adımları
go/scripts/build-release.sh arm64 ikiliyi ve KeyLab.app zip'ini derler ve İMZALAR (bakımcı aracı)
components.lock paket kilit dosyası; components/ kurulu paketler (repoya girmez)
servers/<ad>/ server.env, id_ed25519_<ad> (kullanıcı verisi)
docs/ ayrıntılı belgeler (paketler, güncelleme, test edilen ortamlar, standart)
cd go
go vet ./... && go test ./... -short # uzun karşılaştırmalı testler için -short'u kaldırın
go build -o keylab .
bash go/scripts/keylabtest.sh # yerel deneme klasörünü (~/Developer/keylabtest) günceller ve KeyLab'ı oradan başlatır
bash go/scripts/keylabtest.sh --main # aynısı, ama GitHub'daki güncel main'i ayrı klonda çekip (çalışma dalınızdan bağımsız) ondan derlerKarşılaştırmalı testler Go sonucunu testdata/*.json altındaki altın dosyalarla (eski kabuk/Python motorunun kaydedilmiş çıktıları) karşılaştırır; kabuk gerekmez.
Kayıtları yenilemek için eski motor git checkout kabuk-referansi -- referans/kabuk ile geri getirilir ve KEYLAB_KAYIT_KABUK=1 go test ./internal/<paket> çalıştırılır (bkz. go/internal/shellgold).
Katkı için CONTRIBUTING.md, planlananlar için ROADMAP.md.
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.
MIT, bkz. LICENSE.
