# Nesne Depolama kovasını sunucuya klasör olarak bağlama https://www.gyrohosting.com/bilgi-bankasi/makale/s3-kovayi-sunucuya-baglama - **Bu rehberde ne öğreneceksiniz**: Nesne Depolama hizmetinizdeki bir kovayı sunucunuza normal bir klasör gibi bağlamayı, bağlantının nasıl çalıştığını ve kaldırmayı. - **Süre**: 5 dakika - **Kimin için**: Yedekleri, kullanıcı yüklemelerini ya da büyük dosyaları sunucu diski yerine Nesne Depolama'da tutmak isteyenler. - **Gerekenler**: Aktif bir Nesne Depolama hizmeti (en az bir kova) ve systemd kullanan bir Linux sunucu (Gyro Bulut İstanbul, Gyro Bulut, Türkiye VDS ya da fiziksel sunucu). ## 1. Ne işe yarar? Kovanız sunucuda `/mnt/yedekler` gibi bir klasör olarak görünür. Bu klasöre yazılan dosyalar kovaya, kovadaki dosyalar klasöre gelir; uygulamanızın S3 bilmesi gerekmez. - **Ücretsizdir.** Okuma ve yazma trafiği depolama hizmetinizin trafiğinden sayılır. - **Gyro Bulut İstanbul sunucularında otomatik kurulur.** Diğer sunucularda panelin verdiği tek satırlık komutu bir kez çalıştırırsınız. - **Her bağlantının kendi erişim anahtarı vardır.** Anahtar yalnız seçtiğiniz kovaya yetkilidir (salt okuma ya da okuma/yazma), anahtar sınırınızdan düşmez ve bağlantıyı kaldırınca silinir. Sunucu ele geçirilse bile diğer kovalarınıza erişilemez. - **Kalıcıdır:** sunucu yeniden başladığında bağlantı kendiliğinden gelir, bağlantı koparsa yeniden bağlanır. - **Kovanın adını değiştirmeniz bağlantıyı bozmaz.** > **Bilgi** > > Teknik olarak bu bir rclone FUSE bağlantısıdır: yazılan dosyalar önce sunucuda küçük bir önbelleğe (en çok 2 GB) yazılır ve birkaç saniye içinde kovaya yüklenir. Veritabanı dosyaları ya da sürekli küçük parçalar halinde değiştirilen dosyalar için uygun değildir; yedek, arşiv, medya ve kullanıcı dosyaları için idealdir. ## 2. Panelden bağlama 1. Sunucunuzun hizmet sayfasında **Depolama bağla** sekmesini açın. 2. **Depolama hizmeti** ve **Kova** seçin. 3. **Bağlama noktası**'nı yazın ya da boş bırakın (varsayılan `/mnt/`). Yol `/mnt`, `/srv`, `/data`, `/media`, `/opt`, `/home` ya da `/var/www` altında olmalıdır; klasör yoksa oluşturulur, **dolu bir klasöre bağlanmaz** (içindekiler görünmez olmasın diye). 4. Sunucu yalnız okuyacaksa **Salt okuma**'yı işaretleyin (ör. yedek geri yükleme, web varlıkları). 5. **Bağla**'ya basın. **Gyro Bulut İstanbul sunucularında** bağlantı birkaç saniye içinde kendiliğinden kurulur ve durum **Bağlı** olur (sunucu açık olmalı). **Diğer sunucularda** panel tek satırlık bir **kurulum komutu** gösterir. Sunucunuza SSH ile bağlanıp komutu root ya da `sudo` yetkili bir kullanıcıyla bir kez çalıştırın: ``` curl -fsSL https://www.gyrohosting.com/.../gyro-s3mount.sh -o /tmp/gyro-s3mount.sh && echo "<özet> /tmp/gyro-s3mount.sh" | sha256sum -c --quiet && sudo bash /tmp/gyro-s3mount.sh install https://www.gyrohosting.com ``` Komut **60 dakika geçerlidir ve yalnız bir kez kullanılabilir.** Betik çalışmadan önce SHA-256 özeti doğrulanır; betik gerekli paketleri (FUSE, rclone) kurar, kimlik bilgisini panelden bir kez alır ve bağlantıyı başlatır. Birkaç saniye sonra panelde durum **Bağlı** olur. > **Dikkat** > > Kurulum komutunu kimseyle paylaşmayın ve talep/e-posta gibi yerlere yapıştırmayın. Süresi dolarsa ya da sunucunuzu yeniden kurduysanız satırdaki **Yeni komut** ile yenisini alın (eski anahtar o an geçersiz olur). ## 3. Sunucuda kullanım ``` ls /mnt/yedekler # kovadaki dosyalar cp yedek-2026-11-13.tar.gz /mnt/yedekler/ # kovaya yükler gyro-s3mount list # bu sunucudaki bağlantılar ve durumları systemctl status gyro-s3mount@yedekler # ayrıntılı durum ``` Bağlantı `gyro-s3mount@` adlı bir systemd hizmetidir. Dosyalar root'a aittir, diğer kullanıcılar okuyabilir (`0755` / `0644`). Kimlik bilgisi `/etc/gyro-s3mount/.conf` dosyasında yalnız root'un okuyabileceği şekilde durur; panelde gösterilmez. ## 4. Bağlantıyı kaldırma Panelde ilgili satırdaki **Kaldır**'a basın. Bağlantının erişim anahtarı **hemen** silinir; **kovadaki dosyalar silinmez.** - Gyro Bulut İstanbul sunucularında sunucudaki hizmet ve klasör de kendiliğinden kaldırılır. - Diğer sunucularda sunucuyu temizlemek için panelin gösterdiği komutu çalıştırın: `sudo gyro-s3mount remove `. Bu komutu sunucuda kendiniz çalıştırırsanız panelde de kaldırılmış görünür. ## 5. Depolama hizmeti askıya alınırsa ya da sona ererse - **Askı:** bağlantı kovaya erişemez (klasörde giriş/çıkış hatası görürsünüz). Hizmet yeniden açıldığında bağlantı kendiliğinden döner. - **İptal / sona erme:** bağlantı anahtarı silinir, bağlantı panelde **Sona erdi** olur. Sunucunuz iptal edildiğinde de o sunucunun bağlantıları kapatılır. ## 5a. Korumalı Depolama kovaları Korumalı Depolama (sürümlü, kilitlenebilir) kovaları da bağlanabilir. Farklar: - **Varsayılan salt okuma.** Panelde Korumalı bir depolama hizmeti seçtiğinizde **Salt okuma** işaretli gelir. Yedeklerinizi sunucuda okuyup geri yüklemek için en güvenli kullanım budur. - **Okuma-yazma seçerseniz** panel bir uyarı gösterir ve onayınızı ister (API'de `accept_versioning: true`): - Sunucuda bir dosyayı her kaydetmeniz ya da üzerine yazmanız **yeni bir sürüm** oluşturur. - Silme dosyayı kalıcı silmez, yalnız **silme işareti** koyar; önceki sürüm durur ve [Sürümler](https://www.gyrohosting.com/bilgi-bankasi/makale/s3-versiyonlama-eski-surume-donme) sayfasından geri getirilebilir. - **Kilitli** dosyalar kilit süresi dolmadan silinemez. - Bu yüzden **kullanılan alan ve ücret zamanla büyür.** Eski sürümleri **Yaşam döngüsü** ("eski sürümleri N gün sonra sil") ile sınırlayın; sık değişen dosyaları (log, veritabanı, önbellek) Standart Nesne Depolama'da tutun. - Gereksiz sürüm oluşmaması için bağlantı dosyaların değiştirilme zamanını kovaya yazmaz ve yazmaları yaklaşık 30 saniye toplayıp tek seferde yükler. - Kovanın adını değiştirmek bağlantıyı bozmaz: bağlantı her zaman kovanın değişmeyen **S3 adını** kullanır. ## 6. Komut satırı, API ve Terraform ``` gyro server storage-mount list 12345 gyro server storage-mount create 12345 --storage-service-id 6789 --bucket yedekler --mount-point /mnt/yedekler gyro server storage-mount command 12345 3 # yeni tek kullanımlık komut gyro server storage-mount remove 12345 3 --yes ``` API: `GET/POST /cloud/servers/{id}/storage-mounts`, `GET/DELETE /cloud/servers/{id}/storage-mounts/{mid}`, `POST .../{mid}/command`. Yanıttaki `automatic: true` bağlantının otomatik uygulandığını, `install_command` sunucuda çalıştırılacak komutu gösterir. ``` resource "gyro_server_storage_mount" "yedek" { server_id = gyro_server.web.id storage_service_id = 6789 bucket = "yedekler" mount_point = "/mnt/yedekler" } ``` ## 7. Sık sorulan sorular **Windows sunucuya bağlayabilir miyim?** Hayır. Bu özellik systemd kullanan Linux sunucular içindir (Ubuntu, Debian, AlmaLinux, Rocky Linux, CentOS Stream, Fedora). Windows'ta S3 uyumlu bir istemci (ör. rclone) ile kendiniz bağlanabilirsiniz: [aws-cli ve rclone ile bağlanma](https://www.gyrohosting.com/bilgi-bankasi/makale/s3-aws-cli-rclone). **"Bos degil" hatası aldım.** Seçtiğiniz bağlama noktasında dosya var. Boş ya da olmayan bir klasör seçin (ör. `/mnt/yedekler2`) ve **Yeni komut** ile tekrar deneyin. **Korumalı Depolama kovasını bağlayabilir miyim?** Evet (bkz. Bölüm 5a). Varsayılan salt okumadır; okuma-yazmada her yazma yeni sürüm oluşturur ve alan büyür. Düzenli yedek almak için restic, Veeam ya da rclone genellikle daha verimlidir: [restic ve rclone ile Korumalı Depolama](https://www.gyrohosting.com/bilgi-bankasi/makale/restic-rclone-korumali-depolama). **Bir sunucuya kaç kova bağlayabilirim?** Bir sunucuya en çok 10 kova, bir depolama hizmeti en çok 20 sunucu bağlantısına izin verir. **Ücreti var mı?** Hayır. Yalnız depolama hizmetinizin alanı ve trafiği kullanılır.