Belgeler
Hızlı başlangıç
- Site Yöneticisi (F4) → Yeni site: protokolü seçin (SFTP önerilir), sunucu, kullanıcı, parola ya da anahtar dosyası. Bağlan.
- Sol panel yerel, sağ panel uzak. Sürükle-bırak, F6 (karşı tarafa aktar) ya da ortadaki oklarla aktarın. Aktarımlar Kuyruk sekmesinde görünür; sürdürme, yeniden deneme ve çakışma kararları oradadır.
- Bağlantı sihirbazı (Dosya menüsü) adım adım kurulum yapar ve bağlantıyı sınar; S3/WebDAV sağlayıcı ön ayarları buradadır.
İlk bağlantıda SSH parmak izi ya da sertifika sorulur — sunucu yöneticinizden doğrulayıp onaylayın.
Protokoller ve ayarlar
| Protokol | Not |
|---|---|
| FTP / FTPS | Pasif kip önerilir; FTPS "açık TLS" (port 21) ya da "örtük" (990). MODE Z sıkıştırma isteğe bağlı. |
| SFTP | Parola ya da OpenSSH anahtarı (.ppk değil; PuTTY'den "OpenSSH key" olarak dışa aktarın). Anahtar üret: Site → Anahtar dosyası → Üret… |
| WebDAV | Nextcloud/ownCloud (/remote.php/dav/files/KULLANICI/), SharePoint/IIS ("LOCK kullan" seçeneği), Apache mod_dav. |
| HTTP/HTTPS | Salt okunur dizin gezinme (nginx autoindex, Apache, python http.server). |
| S3 | Erişim anahtarı = kullanıcı adı, gizli anahtar = parola. Bölge ve kova siteye yazılır; IP'li uç noktada "yol biçimi". Sihirbazda Amazon, Wasabi, B2, R2, Spaces, MinIO, Google Cloud (HMAC), Oracle ön ayarları. |
| Azure Blob | Depolama hesabı = kullanıcı adı; parola = hesap anahtarı ya da SAS (sv=…&sig=…). Kapsayıcı isteğe bağlı. |
Proxy: Seçenekler → Bağlantı → Proxy (SOCKS4/4a/5, HTTP CONNECT, Windows sistem ayarı, FTP user@host). Site bazında atlanabilir.
Hosting panelleri
Site Yöneticisi → İçe aktar → panelden: cPanel/WHM (API token), Plesk (API anahtarı), DirectAdmin (login key), Hestia (API). CloudPanel, CyberPanel, aaPanel, Virtualmin ve ISPConfig için sunucuya tek satırlık ciciFTP ajanı kurulur (sağlaması denetlenir); ajan kısıtlı bir SSH anahtarıyla yalnız site listesi ve SFTP/FTP erişim verme komutlarını çalıştırır.
Eşitleme ve otomasyon
- Klasörleri eşitle (Ctrl+Shift+S): yön, yalnız değişenler, ayna (silme korumalı — eksik tarama varsa silmez), sağlama karşılaştırma.
- Zamanlanmış görevler: Windows Görev Zamanlayıcı ile
ciciFTP.exe --run-task "ad" --exit-when-done. - Betikler (Ctrl+Shift+B):
site,cd,lcd,put,get,mput,mget,sync,delete,rename,chmod,pgpencrypt,foreach site,if exists… Kabuk komutu yoktur (güvenlik). - Makro kaydı: yaptıklarınız betik olarak kaydedilir.
- Yerel klasörü izle: kaydedilen dosya otomatik yüklenir.
Düzenleyici
Uzak dosyayı çift tıkla dahili düzenleyicide açın (sözdizimi renklendirme, bul/değiştir, kod parçacıkları); kaydedince yüklenir. Harici düzenleyici (Notepad++, VS Code) Seçenekler → Düzenleyici'den seçilir.
Klavye kısayolları
| Tuş | İşlev |
|---|---|
| F4 | Site Yöneticisi |
| Ctrl+Q | Hızlı bağlan · Ctrl+D bağlantıyı kes |
| F5 | Yenile · F6 karşı tarafa aktar · F2 yeniden adlandır · Del sil |
| Ctrl+F | Sunucuda dosya bul · Ctrl+M maskeyle seç |
| Ctrl+K | Panelleri karşılaştır · Ctrl+B site listesi · Ctrl+L alt panel |
| F1 | Tüm kısayollar |
Taşınabilir kip ve veri klasörü
Ayarlar %APPDATA%\ciciFTP altındadır (settings.json, sites.json, keys\, logs\). ciciFTP.exe --data-dir "D:\ciciFTP-veri" ile hepsi USB belleğe taşınır. Yedek: Seçenekler → Genel → Ayarları yedekle (parolalar şifreli kalır; başka bilgisayarda ana parola gerekir).
Sorun giderme
- Liste geliyor, aktarım yok (FTP): pasif kip + güvenlik duvarında pasif port aralığı; FTPS'te TLS oturum yeniden kullanımı isteyen sunucularda "açık TLS" deneyin.
- Sertifika reddedildi: sunucunun sertifikası geçersiz/kendinden imzalı; yöneticiden parmak izini alıp "Her zaman güven" deyin.
- Türkçe karakterler bozuk: Site → Gelişmiş → Karakter kodlaması (UTF-8 / windows-1254).
- Günlük sekmesi her komutu ve yanıtı gösterir; hata bildirirken bu satırları ekleyin (parola zaten maskelidir).