S3 Object Storage HOSTKEY¶

Bu makalede

• Servis Açıklaması
• Temel Özellikler
• Teknik Parametreler
• Tarayıcı Erişimi ve CORS
• Presigned URL Desteği
• Fiyatlandırma
• S3 Depolama Alanı Oluşturma
• Invapi'de S3 Storage Control Panel
• Invapi'de S3 Storage Kimlik Bilgilerini Alma
• Invapi'de S3 Storage Bucket Yönetimi
• S3 Browser ile Kullanım
• Temel dosya işlemleri
• AWS CLI aracılığıyla HOSTKEY S3 ile Çalışma

Servis Açıklaması¶

Temel Özellikler¶

• Bağımsız depolama alanları oluşturma - Free Beta 1 planındaki ücretsiz beta süreci boyunca kullanıcılar 3 adede kadar bağımsız S3 storage bucket oluşturabilir;
• VPS/VDS'den bağımsızlık - S3 depolamaları otonom olarak çalışır ve HOSTKEY sunucu kiralaması gerektirmez;
• Bucket Oluşturma - Depolama alanı oluştururken, benzersiz bir isme sahip ilk bucket otomatik olarak oluşturulur. Bucket Oluşturma: Beta süresi boyunca kullanıcılar her bir S3 storage içinde 10 adede kadar bucket oluşturabilir;
• S3 uyumlu erişim - Tüm veri işlemleri için standart Amazon S3 protokolü için tam destek;
• Herhangi bir S3 istemcisi ile çalışma - S3 Browser, Cyberduck, boto3 ve diğer S3 uyumlu araçları kullanın;
• Güvenli erişim - HTTPS protokolü üzerinden Access Key ve Secret Key ile yetkilendirme;
• Basit kimlik bilgisi yönetimi - Hesabınızın web arayüzü üzerinden erişim anahtarlarının oluşturulması ve görüntülenmesi;
• Hazır planlar - Sabit depolama hacmi ve bant genişliğine sahip plan seçeneği.

Teknik Parametreler¶

• Endpoint URL: https://s3-nl.hostkey.com;
• Protokol: HTTPS (SSL/TLS);
• Yetkilendirme: AWS Signature Version 4.

Tarayıcı Erişimi ve CORS¶

Web uygulamalarında S3 Object Storage kullanırken (tarayıcıdan fetch/XHR ile doğrudan erişim), bucket tarafında CORS kurallarını yapılandırmanız gerekir. API/CLI (PutBucketCors metodu) kullanarak CORS politikalarını kendiniz yapılandırabilirsiniz.

Web uygulamaları için önerilen parametreler:

• Allowed Origins: Alan adı URL'niz (örneğin, https://your-app.com).
• Allowed Methods: GET, PUT, POST, HEAD.
• Allowed Headers: Authorization, Content-Type, Content-MD5, x-amz-*.
• Expose Headers: ETag (Multipart Upload işleminin doğru çalışması için gereklidir).

Presigned URL Desteği¶

S3 Object Storage geçici erişim mekanizmalarını tam olarak destekler:

• Presigned GET/PUT URL: Yükleme ve indirme için imzalı bağlantıların oluşturulması.
• Multipart Upload: part-URL aracılığıyla büyük dosyaların yüklenmesi ve işlemin CompleteMultipartUpload ile tamamlanması desteği.

Fiyatlandırma¶

S3 depolama alanı ücretli olarak sağlanır. Güncel fiyatlandırma planlarını buradan inceleyebilirsiniz. Ayrıca depolama ve trafik hacminizi artırabilir ve "kullandıkça öde" (pay-as-you-go) esasına göre ödeme yapabilirsiniz. Ek kullanım maliyeti günlük olarak hesaplanır.

Servis siparişi sırasında, seçilen fiyatlandırma planı şartlarına göre bir aylık gerçek kullanım tutarı hesap bakiyenizden düşülecektir. Sonraki ayların kullanımları için ödemeler ve kaynak limitlerinin aşılması durumunda oluşacak ücretler de hesabınızdan tahsil edilecektir.

Faturalandırma geçmişinizi görüntülemek için Invapi içindeki kullanıcı profilinde bulunan Balance & Payments menüsüne gidin ve Billing Details bölümüne geçin.

Billing Details bölümünde, bu hesaba bağlı tüm ek hizmetler (Managed Apps, S3) için işlem geçmişini ve ayrıca bu hesaptan tahsil edilen toplam tutarı görüntüleyebilirsiniz. Her bir servis ücreti aylık faturalandırma döngüsü içinde ayrı ayrı listelenir.

Faturalar, raporlama ayını takip eden ayın 2. gününde saat 05:00 UTC'de oluşturulur. Faturaları Invapi içindeki Balance & Payments bölümünde, Billing Details sekmesi altında inceleyebilirsiniz. Fatura tutarları bir takvim ayı için hesaplanır ve servis kullanım maliyetini içerir. Tüm ek hizmetler için toplam tutarı içeren tek bir konsolide fatura oluşturulabilir.

S3 Depolama Alanı Oluşturma¶

1. Invapi üzerindeki hesabınıza giriş yapın.

2. S3 Storage bölümüne gidin;

3. Yeni depolama alanı oluşturun:

   

   • Region: bölgeyi seçin (varsayılan NL - Hollanda);
   • Bucket name: bucket adını girin (örneğin, bde347688-testbucket):
     • isim benzersiz olmalıdır;
     • maksimum 63 karakter;
     • sadece küçük harfler, sayılar ve tireler;
     • bir harf veya sayı ile başlamalı ve bitmelidir.
   • Plan: bir fiyatlandırma planı seçin (örneğin, Standart). Seçmek için plan adına tıklayın;
   • Create S3 Storage düğmesine tıklayın.

Depolama alanı oluşturulduktan sonra siparişiniz için ödeme yapmanız istenecektir.

Invapi'de S3 Storage Control Panel¶

Başarılı ödemenin ardından, şunları yapabileceğiniz Your Independent Storages paneline (veya sol menüden S3 Storage seçilerek) yönlendirileceksiniz:

1. Ödenmiş depolama alanlarınızı ve tarifelerini görüntüleme
2. Yeni bir bağımsız S3 storage oluşturma
3. Detaylarını görüntülemek için listeden belirli bir depolama alanı seçme
4. Depolama hacmi ve trafik kullanımı istatistiklerini görüntüleme
5. Depolamaya bağlanmak için kimlik bilgilerini (credentials) görüntüleme
6. Mevcut depolama alanına yeni bucket'lar ekleme
7. Eklenen bucket listesini ve istatistiklerini görüntüleme
8. Bucket'lar üzerinde işlemler gerçekleştirme

Invapi'de S3 Storage Kimlik Bilgilerini Alma¶

1. Depolama alanlarınızın listesinde, oluşturduğunuz depolama alanını bulun ve Credentials sekmesine gidin:

   

2. Kimlik bilgilerini kopyalayın:

   Şunlara ihtiyacınız olacak:

   • Host Name (Endpoint URL): https://s3-nl.hostkey.com;
   • S3 User ID: (örneğin, oab56UivbdcUURCTrMCrcB86YWzyy1hB);
   • Access Key: anahtarı görüntülemek için simgesine tıklayın;
   • Secret Key: anahtarı görüntülemek için simgesine tıklayın.

   Bu verileri kaydedin - bağlantı için gereklidir.

Invapi'de S3 Storage Bucket Yönetimi¶

Doğrudan Invapi'deki S3 storage arayüzünden aşağıdaki bucket işlemleri yapılabilir:

1. Bucket'ın depolama alanında kapladığı alanı ve içindeki nesne sayısını görüntüleme;
2. Bucket'ı silme;
3. İsmiyle olan satıra tıklayarak bucket içeriğini görüntüleme;
4. Bucket içindeki dosyalar için dosya boyutu ve oluşturma tarihi bilgilerini görüntüleme;
5. Bucket içinde dosya arama;
6. Bucket'tan tekil dosyaları silme.

S3 Browser ile Kullanım¶

1. S3 Browser'ın ücretsiz sürümünü indirin: https://s3browser.com;

2. Yeni bir hesap ekleyin:

   

   • S3 Browser'ı açın;
   • Accounts >> Add New Account yolunu izleyin.

3. Formu doldurun:

   • Display name: HOSTKEY S3 (istediğiniz bir isim);
   • Account type: S3 Compatible Storage (Amazon S3 Storage değil!);
   • API endpoint: s3-nl.hostkey.com (https:// olmadan);
   • Access Key ID: HOSTKEY panelinden Access Key'inizi yapıştırın;
   • Secret Access Key: HOSTKEY panelinden Secret Key'inizi yapıştırın;
   • Use secure transfer (SSL/TLS): onay kutusunu işaretli bırakın.

4. Add new account düğmesine tıklayın;

5. Dosyalarla çalışın:

   

   Başarılı bağlantıdan sonra şunları göreceksiniz:

   • Solda Bucket list;
   • Sağda Files in bucket;
   • Yönetim düğmeleri: Upload, Download, Delete, New Folder, Refresh.

   Mevcut işlemler:

   • Upload - dosya yükleme;
   • Download - dosya indirme;
   • Delete - dosya silme;
   • New Folder - klasör oluşturma;
   • Refresh - listeyi yenileme.

Temel dosya işlemleri¶

S3 uyumlu bir istemci aracılığıyla S3 depolama alanına bağlandıktan sonra aşağıdaki işlemler yapılabilir:

Dosya yükleme¶

1. S3 Browser ile:

   • Sol panelden bir bucket seçin;
   • Upload düğmesine veya Upload folder(s) düğmesine tıklayın;
   • Bilgisayarınızdan dosyaları seçin;
   • Yüklemeyi onaylayın:

   

2. Sürükle ve bırak ile:

   • Dosyaları doğrudan gezginden S3 Browser penceresine sürükleyin.

Dosya indirme¶

1. Bucket içinden bir dosya seçin;

2. Download düğmesine tıklayın veya sağ tıklayıp Download seçeneğini belirleyin:

   

3. Dosyanın bilgisayarınızda kaydedileceği klasörü belirtin.

Dosya ve klasör silme¶

1. Bir dosya veya klasör seçin;

2. Delete düğmesine tıklayın veya klavyeden Delete tuşuna basın:

   

3. Silme işlemini onaylayın.

Klasör yapısı oluşturma¶

1. Bir bucket veya klasör seçin;

2. New Folder düğmesine tıklayın:

   

3. Klasör adını girin:

   

4. Create new folder düğmesine tıklayın.

Dosya kopyalama ve taşıma¶

• Kopyalama: bir dosya seçin > sağ tıklayın > Copy > hedef klasöre gidin > sağ tıklayın > Paste;
• Taşıma: farenin düğmesini basılı tutarak dosyayı istediğiniz klasöre sürükleyin.

Dosyaları yeniden adlandırma¶

1. Dosyaya sağ tıklayın;

2. Rename seçeneğini belirleyin:

   

3. Yeni bir isim girin;

4. Klavyeden Enter tuşuna basın.

Erişim izinlarını yönetme (ACL)¶

1. Dosyaya veya bucket'a sağ tıklayın;

2. Bağlam menüsünde Edit Permissions (ACL) seçeneğini belirleyin:

   

3. Açılan pencerede kullanıcılar için erişim izinlarını yapılandırın:

   • Owner - nesne üzerinde tam kontrol;
   • Any AWS Users - herhangi bir AWS kullanıcısı için erişim;
   • All Users - herkes için genel (public) erişim.

4. Her kullanıcı kategorisi için şunları ayarlayabilirsiniz:

   • Full Control - tam kontrol;
   • Read - nesneyi okuma;
   • Write - nesneyi yazma/değiştirme;
   • Read Permissions - okuma erişim izinleri;
   • Write Permissions - değiştirme erişim izinleri:

   

5. Hızlı yapılandırma için düğmeleri kullanın:

   • Make public - dosyayı herkese açık yapın;
   • Make private - dosyayı özel (private) yapın.

6. Yapılandırmadan sonra kaydetmek için Apply changes düğmesine tıklayın.

Web bağlantıları oluşturma¶

S3 Object Storage'da bir dosya veya klasör için genel bir bağlantı oluşturmak üzere:

1. Dosyaya sağ tıklayın;

2. Bağlam menüsünde Generate Web URL seçeneğini belirleyin:

   

3. Açılan Web URL Generator penceresinde bağlantı oluşturma parametrelerini yapılandırın:

4. Use secure transfer (HTTPS) - güvenli bir bağlantı kullanın (gizli veriler için önerilir);

5. Expiration - bağlantı geçerlilik süresini seçin;

6. Hostname - ana makine seçimi:

   • Use default host name - varsayılan adresi kullanın (örneğin, https://s3-nl.hostkey.com/bfcc62b88-testbucket/);
   • Veya kendi alan adınızı belirtin;

7. Parametreleri yapılandırdıktan sonra sistem dosya için tam bir bağlantı oluşturacaktır, örneğin:

   https://s3-nl.hostkey.com/bfcc62b88-testbucket/dedicated-server-architecture.drawio

Bağlantıyı kısaltma:¶

1. Kısa bir bağlantı oluşturmak için Shorten düğmesine tıklayın ve bir servis seçin:

   • Shorten with Bitly - Bitly ile kısaltın;
   • Shorten with TinyURL - TinyURL ile kısaltın;
   • Configure... - kısaltma servislarını yapılandırın;

   

   

2. Başarılı kısaltmadan sonra kısa bir bağlantı alacaksınız (örneğin, https://tinyurl.com/2dhcsk8y);

3. Şu düğmeleri kullanın:

   • Copy - bağlantıyı panoya kopyalayın;
   • Close - oluşturucu penceresini kapatın.

   

AWS CLI aracılığıyla HOSTKEY S3 ile Çalışma¶

AWS CLI Kurulumu¶

AWS CLI iki şekilde kurulabilir. Birini seçin:

Yöntem 1: pip aracılığıyla kurulum (evrensel)¶

Avantajları:

• Tek bir komutla basit kurulum;
• Kolay güncelleme;
• Tüm platformlarda çalışır (Windows, Linux, macOS).

Dezavantajları:

• Python yüklü olmasını gerektirir;
• Bazı terminallerde uyarılar gösterebilir.

Kurulum:

pip install awscli boto3

Kurulumu doğrulayın:

aws --version

pip show awscli boto3

Güncelleme:

pip install --upgrade awscli boto3

Yöntem 2: Windows için MSI yükleyicisi (önerilen)¶

Avantajları:

• Python gerektirmez;
• Terminalde uyarı çıkmaz;
• Temiz sistem kurulumu sağlar.

Dezavantajları:

• Sadece Windows içindir;
• Güncellemeler manuel olarak indirilmelidir.

Terminal üzerinden kurulum:

curl -o AWSCLIV2.msi https://awscli.amazonaws.com/AWSCLIV2.msi

msiexec /i AWSCLIV2.msi /quiet /norestart

Kurulumdan sonra:

1. Terminali yeniden başlatın;
2. Kurulumu doğrulayın.

   aws --version
   

   where aws
   

Beklenen sonuç:

aws-cli/2.x.x Python/3.x.x Windows/10 exe/AMD64
C:\Program Files\Amazon\AWSCLIV2\aws.exe

Alternatif kurulum yöntemi:

• Manuel olarak indirin: https://awscli.amazonaws.com/AWSCLIV2.msi;
• Yükleyiciyi çift tıklayarak çalıştırın;
• Terminali yeniden başlatın.

Çakışmaları kontrol edin:

where aws

Birden fazla yol gösteriliyorsa, versiyonlardan birini kaldırın:

pip uninstall awscli -y

wmic product where "name like 'AWS Command Line Interface%'" call uninstall

HOSTKEY S3 bağlantısını yapılandırma¶

1. HOSTKEY panelinden kimlik bilgilerini alma

1. Invapi üzerindeki hesabınıza giriş yapın;
2. S3 Storage bölümüne gidin;
3. "Credentials" sekmesini açın;

4. Aşağıdaki verileri kopyalayın:

   S3 kullanıcı tanımlayıcısı (Access Key ID) için:

   • Anahtarı görüntülemek için göz simgesine tıklayın;
   • Görüntülenen değeri manuel olarak veya Copy düğmesiyle kopyalayın.

   Gizli anahtar (Secret Access Key) için:

   • Anahtarı görüntülemek için göz simgesine tıklayın;
   • Görüntülenen değeri manuel olarak veya Copy düğmesiyle kopyalayın.

   Dikkat

   Gerçek anahtar değerlerini görüntülemek için önce simgesine tıklamanız gerekir; ancak ondan sonra doğru şekilde kopyalanabilirler.

5. Ayrıca şunlara da ihtiyacınız olacak:

6. Host name: https://s3-nl.hostkey.com;
7. Region: panelde görüntülenen bölge (örneğin, Hollanda için nl).

2. Profili ayarlama

aws configure --profile hostkey

İstenildiğinde şunları girin:

AWS Access Key ID [None]: your_access_key_id
AWS Secret Access Key [None]: your_secret_access_key
Default region name [None]: nl
Default output format [None]: json

Örnek:

AWS Access Key ID [None]: s3uid_XXXXXXXXXXXXXXXXX
AWS Secret Access Key [None]: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Default region name [None]: nl
Default output format [None]: json

3. Yapılandırmayı doğrulayın

aws configure list --profile hostkey

Beklenen çıktı:

NAME       : VALUE                    : TYPE             : LOCATION
profile    : hostkey                  : manual           : --profile
access_key : ****************xxxx     : shared-credentials-file :
secret_key : ****************xxxx     : shared-credentials-file :
region     : nl                       : config-file      : ~/.aws/config

4. Bağlantıyı doğrulayın

aws s3 ls --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Beklenen sonuç (bucket listeniz):

2025-11-26 13:54:16 your-bucket-name

Temel dosya işlemleri¶

Bucket içeriğini görüntüleme¶

aws s3 ls s3://bucket-name/ --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Örnek:

aws s3 ls s3://your-bucket-name/ --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Sonuç:

2025-11-28 12:14:28         21 test.txt
2025-11-28 14:52:11         19 test_new.txt

Dosya yükleme¶

Bir test dosyası oluşturun:

echo Hello HOSTKEY S3 > test.txt

Dosyayı bucket'a yükleyin:

aws s3 cp test.txt s3://bucket-name/ --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Örnek:

aws s3 cp test_new.txt s3://your-bucket-name/ --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Sonuç:

upload: .\test_new.txt to s3://your-bucket-name/test_new.txt

Dosya indirme¶

aws s3 cp s3://bucket-name/file.txt ./local-file.txt --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Örnek:

aws s3 cp s3://your-bucket-name/test.txt ./downloaded.txt --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Sonuç:

download: s3://your-bucket-name/test.txt to .\downloaded.txt

İndirilen dosyayı kontrol edin (Windows):

type downloaded.txt

İndirilen dosyayı kontrol edin (Linux/macOS):

cat downloaded.txt

Dosya silme¶

aws s3 rm s3://bucket-name/file.txt --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Örnek:

aws s3 rm s3://your-bucket-name/test.txt --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Sonuç:

delete: s3://your-bucket-name/test.txt

Klasör senkronizasyonu¶

Bir klasörü bucket'a yükleme:

aws s3 sync path/to/local/folder s3://bucket-name/path-in-bucket/ --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Örnek:

aws s3 sync C:\Users\User\Documents\Test s3://your-bucket-name/remote-folder/ --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Sonuç:

upload: Documents\Test\file1.txt to s3://your-bucket-name/remote-folder/file1.txt
upload: Documents\Test\file2.docx to s3://your-bucket-name/remote-folder/file2.docx

Bucket'tan bir klasör indirme:

aws s3 sync s3://bucket-name/path-in-bucket/ path/to/local/folder --profile hostkey --endpoint-url https://s3-nl.hostkey.com

İlerleme gösterimi ile:

aws s3 sync C:\Users\User\Documents\Test s3://your-bucket-name/backup/ --profile hostkey --endpoint-url https://s3-nl.hostkey.com --progress

Doğru:

aws s3 sync "C:\Users\Name\My Documents" s3://bucket/docs/ --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Yanlış (hata verecektir):

aws s3 sync C:\Users\Name\My Documents s3://bucket/docs/ --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Ek komutlar¶

Bucket oluşturma¶

aws s3 mb s3://new-bucket-name --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Boş bir bucket silme¶

aws s3 rb s3://bucket-name --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Tüm içeriğiyle birlikte bir bucket silme¶

aws s3 rb s3://bucket-name --force --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Bucket'lar arası kopyalama¶

aws s3 cp s3://source-bucket/file.txt s3://dest-bucket/file.txt --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Dosya taşıma¶

aws s3 mv s3://bucket-name/old-file.txt s3://bucket-name/new-file.txt --profile hostkey --endpoint-url https://s3-nl.hostkey.com

Sorun Giderme¶

Hata: "aws" bir komut değil¶

Neden: AWS CLI yüklü değil veya PATH'e eklenmemiş.

Çözüm:

1. Kurulumdan sonra terminali yeniden başlatın;
2. where aws komutuyla kurulumu doğrulayın (bir yol göstermelidir);
3. Bu işe yaramazsa, AWS CLI'yi yeniden yükleyin.

Hata: Geçersiz bucket adı¶

Neden: Yanlış bucket adı.

Çözüm: HOSTKEY panelindeki tam bucket adını kullanın (örneğin, prefix-testbucket).

Hata: AccessDenied¶

Neden: Yanlış kimlik bilgileri veya yetersiz izinler.

Çözüm:

1. HOSTKEY panelindeki Access Key ve Secret Key'i kontrol edin;
2. Profili yeniden oluşturun.

   aws configure --profile hostkey
   

pip ve MSI versiyonları arasındaki çakışma¶

Belirtiler: where aws komutu iki farklı yol gösteriyor.

Çözüm: Versiyonlardan birini kaldırın (bkz. "Kurulum yöntemlerini karıştırmayın" bölümü).

Yapılandırmayı sıfırlama¶

Windows:

rmdir /S /Q %USERPROFILE%\.aws

Linux/macOS:

rm -rf ~/.aws

Tekrar kurulum yapın:

aws configure --profile hostkey

Yapılandırma dosyalarının konumu¶

Windows:

C:\Users\KULLANICI_ADI\.aws\credentials
C:\Users\Users\KULLANICI_ADI\.aws\config

Linux/macOS:

~/.aws/credentials
~/.aws/config

Dosya içerikleri:

• credentials - Access Key ve Secret Key;
• config - bölge (region) ve çıktı formatı ayarları.

Doğrulama için yararlı komutlar¶

AWS CLI versiyonu:

aws --version

Yürütülebilir dosyanın konumu:

where aws

Profil bilgisi:

aws configure list --profile hostkey

Paket bilgisi (pip versiyonu için):

pip show awscli boto3

Güncelleme (pip versiyonu için):

pip install --upgrade awscli boto3