FileZilla, Cyberduck ve Komut Satırı ile SFTP Bağlantısı Kurma

SFTP (Secure File Transfer Protocol) sunucudaki site dosyalarınıza doğrudan erişim sağlar. Bu rehber, kimlik bilgilerinizi bulma konusundan hata gidermeye kadar başarıyla bağlanmak için ihtiyaç duyduğunuz her şeyi kapsar.

SFTP Nedir ve Ne Zaman Kullanılır

KPanel'de yerleşik dosya yöneticisi hızlı düzenlemeler için uygundur: dosya adını değiştirme, yapılandırmayı görüntüleme veya tek bir varlık yükleme. SFTP, daha fazla işlem yapmanız gerektiğinde kullanılan doğru araçtır:

• Aynı anda çok sayıda dosya yükleme veya indirme (site taşıma, toplu görüntü yükleme).
• Tarayıcı tabanlı yüklemede zaman aşımına uğrayacak büyük dosyaları aktarma.
• Dosyaları yerel olarak düzenledikten sonra değişiklikleri gönderdiğiniz geliştirme iş akışının parçası olarak çalışma.
• Yerel ve uzak klasörü senkronize tutmanıza izin veren bir GUI istemcisi kullanma.
• KPanel'in dosya yöneticisi aracılığıyla sunulmayan günlüklere veya yapılandırma dosyalarına erişme.

SFTP aktarım sırasında tüm verileri şifreler, bu da onu düz FTP'den daha güvenli hale getirir. KapsuleHost şifrelenmemiş FTP bağlantıları sunmaz.

Ön Koşullar

Bağlanabilmek için iki şeyin hazır olması gerekir.

1. KPanel'de sitenize eklenmiş bir SSH anahtarı.

KapsuleHost üzerinde SFTP, SSH anahtar kimlik doğrulamasını kullanır. Parola kimlik doğrulaması güvenlik nedeniyle devre dışıdır. SSH ortak anahtarınızı henüz eklemediyseniz, önce SSH Anahtarlarını Sitenize Ekleme rehberine bakın, sonra buraya dönün.

2. Site kullanıcı adınız.

KapsuleHost üzerindeki her sitenin özel bir sistem kullanıcısı vardır. Bu, KPanel e-posta adresiniz değildir. Bu, özel olarak o siteye bağlı kısa bir kullanıcı adıdır.

Bunu bulmak için:

1. KPanel'de kpanel.kapsulehost.com adresinde oturum açın.
2. Sol kenar çubuğunda Websites (Web Siteleri) öğesine tıklayın.
3. Bağlanmak istediğiniz siteye tıklayın.
4. SSH / SFTP sayfasına gidin.
5. Site kullanıcı adınız bu sekmenin en üstünde gösterilir. Genellikle mysite_com veya myexamplesite_net gibi görünür.

Bağlantı ayrıntıları bir bakışta:

---

FileZilla ile Bağlanma

FileZilla, Windows, macOS ve Linux için kullanılabilen ücretsiz, çoklu platform SFTP istemcisidir. Henüz sahip değilseniz filezilla-project.org adresinden indirin.

Adım Adım Kurulum

1. FileZilla'yı açın.

2. File > Site Manager öğesine gidin (veya Windows'ta Ctrl+S / Mac'te Cmd+S tuşlarına basın).

3. Add Website öğesine tıklayın ve buna bir ad verin (örneğin, "My Kapsule Site").

4. General sekmesinde aşağıdaki alanları yapılandırın:

   Alan	Değer
   Protocol	SFTP - SSH File Transfer Protocol
   Host	cp1-kapsule.kapsulehost.com
   Port	22
   Logon Type	Key file
   User	Site kullanıcı adınız (örneğin, mysite_com)
   Key file	Browse öğesine tıklayın ve özel anahtar dosyasına gidin

5. Anahtar dosyası için, KPanel'e eklediğiniz ortak anahtarla eşleşen özel anahtarı seçin. macOS ve Linux'ta, özel anahtarlar genellikle ~/.ssh/ içinde depolanır (örneğin, ~/.ssh/id_ed25519 veya ~/.ssh/id_rsa). Windows'ta, genellikle C:\Users\YourName\.ssh\ içindedirler.

1. Bağlantıyı test etmek için Connect öğesine tıklayın veya daha sonra bağlanmak için OK öğesine tıklayın.

Kaydetme ve Yeniden Bağlanma

Site Manager'a kaydedildikten sonra, File > Site Manager öğesine giderek ve Connect öğesine tıklayarak herhangi bir zamanda yeniden bağlanabilirsiniz. FileZilla ayrıca hızlı erişim için araç çubuğundaki açılır menüde kaydedilmiş siteleri gösterir.

---

Cyberduck ile Bağlanma

Cyberduck, macOS ve Windows için ücretsiz bir SFTP istemcisidir. cyberduck.io adresinden indirin.

Adım Adım Kurulum

1. Cyberduck'ı açın.

2. Open Connection öğesine tıklayın (araç çubuğundaki dünya simgesi).

3. İletişim kutusunun üst kısmındaki protokol açılır menüsünden SFTP (SSH File Transfer Protocol) öğesini seçin.

4. Bağlantı alanlarını doldurun:

   Alan	Değer
   Server	cp1-kapsule.kapsulehost.com
   Port	22
   Username	Site kullanıcı adınız (örneğin, mysite_com)
   Password	Boş bırakın
   SSH Private Key	Choose öğesine tıklayın ve özel anahtar dosyasını seçin

5. Connect öğesine tıklayın.

İlk bağlantıda, Cyberduck sizden sunucunun ana bilgisayar anahtarı parmak izini doğrulamanızı isteyecektir. Devam etmek için Allow öğesine tıklayın. Sonraki bir bağlantıda farklı bir parmak izine sahip bu istemi görürseniz, kabul etmeyin ve desteğe başvurun; bu bir yapılandırma değişikliğini gösterebilir.

Yer İşareti Olarak Kaydetme

Bağlantıyı gelecekte kullanmak için kaydederlmek:

1. Başarıyla bağlandıktan sonra, Bookmark > New Bookmark öğesine gidin (veya Mac'te Cmd+Shift+B tuşlarına basın).
2. Yer işaretine bir ad verin ve iletişim kutusunu kapatın. Yer işareti, Cyberduck yer işareti listenizde görünür.

---

Terminal'den Bağlanma (Mac, Linux veya WSL)

Komut satırını tercih ederseniz, macOS, Linux ve Windows Subsystem for Linux (WSL) üzerinde sftp komutu kullanılabilir.

Temel Bağlantı

sftp mysite_com@cp1-kapsule.kapsulehost.com

mysite_com yerine gerçek site kullanıcı adınızı yazın. Özel anahtarınız varsayılan konumda değilse (~/.ssh/id_rsa veya ~/.ssh/id_ed25519), -i bayrağıyla belirtin:

sftp -i ~/.ssh/your_private_key mysite_com@cp1-kapsule.kapsulehost.com

İlk bağlantıda, sunucunun ana bilgisayar parmak izini doğrulamanız istenir. yes yazın ve Enter tuşuna basın. Bu, cihaz başına anahtar başına yalnızca bir kez gerçekleşir.

Kullanışlı SFTP Komutları

Bağlandıktan sonra sftp> istemi görürsünüz. Dosyaları gezinmek ve aktarmak için bu komutları kullanın:

Örnek: dosya indirme

sftp> cd htdocs/wp-content/themes
sftp> get my-theme.zip

Örnek: dosya yükleme

sftp> lcd ~/Desktop
sftp> cd htdocs/wp-content/uploads
sftp> put my-image.jpg

---

Dosyalarınız Nerede

Bağlandıktan sonra, site kullanıcısının giriş dizinine ineceksiniz: /home/[siteuser]/.

Dizin yapısı şöyle görünür:

/home/mysite_com/
├── htdocs/              ← Your web root (main location for site files)
│   ├── index.php
│   ├── wp-config.php
│   ├── wp-content/
│   │   ├── themes/
│   │   ├── plugins/
│   │   └── uploads/
│   └── ...
├── logs/                ← PHP and access logs
└── tmp/                 ← Temporary files

WordPress'in (veya diğer uygulamanın) bulunduğu web kökü htdocs/ dir. Bu, çoğu zaman harcayacağınız dizindir. Bazı site yapılandırmalarında bunun yerine public_html/ adıyla isimlendirilmiş olabilir. Bağlandığınızda public_html/ yerine htdocs/ görürseniz, bunu kullanın.

---

Bağlantı Sorunlarını Giderme

"Connection refused" (Bağlantı reddedildi)

Bağlantı kurulmadan önce etkin olarak reddedildi.

Kontrol et: cp1-kapsule.kapsulehost.com ana bilgisayarını ve 22 portunu kullandığınızdan emin olun. Yaygın bir hata, 21 portunu girmektir (bu SFTP değil FTP'dir) veya ana bilgisayar adında yazım hatası yapmaktır.

"Permission denied (publickey)" (İzin reddedildi - publickey)

Sunucu bağlantı girişimini kabul etti ancak kimlik doğrulamanızı reddetti.

Her birini kontrol et:

• SSH ortak anahtarınız KPanel > Websites > [site] > SSH / SFTP içinde eklenir. Orada listelenmiyorsa, sunucunun bunun kaydı yoktur.
• FileZilla/Cyberduck'ta doğru özel anahtarı seçtiniz; özellikle KPanel'e eklediğiniz ortak anahtarla eşleşen özel anahtarı.
• Anahtarınızın bir parolası varsa, doğru girdiğinden emin olun.
• Birden fazla anahtarınız varsa, yanlış olanı yanlışlıkla seçmediğinizden emin olun.

"Host key verification failed" (Ana bilgisayar anahtarı doğrulaması başarısız)

SFTP istemciniz daha önce bu ana bilgisayar adı için farklı bir ana bilgisayar anahtarı görmüştür ve uyumsuzluğu uyarıyor.

İlk bağlantıda: Parmak izi kabul etmeniz istenir. Bu normaldir. Accept (Kabul Et) öğesine tıklayın veya yes yazın.

Sonraki bir bağlantıda yeni parmak izine sahip: Bu sunucuda bir yapılandırma değişikliğini gösterebilir. Kabul etmeden önce support@kapsulehost.com adresinden desteğe başvurun ve gördüklerinizi belirtin.

Terminal'de eski bir ana bilgisayar anahtarını temizlemek için ~/.ssh/known_hosts dosyasını düzenleyin ve cp1-kapsule.kapsulehost.com için satırı kaldırın.

"Could not read from remote repository" (Uzak depoda okunamadı) veya Yanlış Dizin

Kullanıcı adı olarak site kullanıcı adınız yerine KPanel e-posta adresinizi kullanmış olabilirsiniz.

Kontrol et: Kullanıcı adı, e-posta adresiniz değil, site kullanıcı adınız (örneğin, mysite_com) olmalıdır. KPanel > Websites > [site] > SSH / SFTP adresinde doğru kullanıcı adını bulun.

Bağlantı Zaman Aşımı

Bağlantı girişimi asılı kalır ve herhangi bir hata olmadan zaman aşımına uğrar.

Olası nedenler:

• IP adresiniz, tekrarlanan başarısız giriş girişimleri nedeniyle Kapsule güvenlik duvarı tarafından geçici olarak engellenmiş olabilir. support@kapsulehost.com adresinden desteğe başvurun ve güvenlik duvarı günlüğünü kontrol etmelerini isteyin.
• Ağınızdaki yerel bir güvenlik duvarı veya VPN, 22 numaralı porta giden bağlantıları engelliyor olabilir. Bunu hariç tutmak için başka bir ağdan (örneğin, cep telefonu hotspot'ı) deneyin.

---

İlgili Makaleler

• SSH Anahtarlarını Sitenize Ekleme
• KPanel'de Dosya Yöneticisini Kullanma
• SSH Tüneli aracılığıyla Veritabanınıza Bağlanma