Skip to main content
Übersicht des Square Cloud Blob Storage Dienstes

​
Warum Square Cloud Blob Storage wählen?

Als größte Bot-Hosting-Plattform Lateinamerikas, der 80 der 100 größten brasilianischen Discord-Server vertrauen, haben wir Blob Storage entwickelt, um ein Problem zu lösen, auf das unsere eigene Community immer wieder gestoßen ist: Discords CDN war nie als Speicher-Backend gedacht, und Links brechen, laufen ab oder werden rate-limitiert. Blob Storage ersetzt das durch einen Objektspeicher, der auf Langlebigkeit ausgelegt ist. Die Architektur ist bewusst einfach: S3-kompatibler Objektspeicher ist die Source of Truth für deine Dateien, und ein globales CDN liefert sie von der Edge aus. Du bekommst die Langlebigkeit von 11 Neunen eines S3-Designs mit der Lese-Latenz eines globalen Caches, und jeder Plan enthält großzügigen Speicher.

​
Hauptfunktionen

Keine Transfergebühren

Keine Ingress- und Egress-Gebühren. Lade hoch und liefere aus, so viel du brauchst: Du zahlst für Speicher, niemals für Bandbreite.

Globales CDN

Öffentliche Dateien werden über ein globales CDN an der Edge ausgeliefert, nah bei deinen Nutzern, wo auch immer sie sind.

Private Dateien

Speichere Dateien ohne öffentliche URL und gib sie über temporäre Links oder Freigabelinks heraus. Du kannst jede Datei jederzeit zwischen öffentlich und privat umschalten.

Freigabelinks

Links, die ablaufen, widerrufen werden können, die Anzahl der Downloads begrenzen und bei Pro und Enterprise ein Passwort abfragen.

S3-kompatibel

Nutze aws-cli, boto3, rclone oder ein beliebiges AWS SDK über das S3-Gateway, mit Zugangsdaten, die aus deinem API-Schlüssel abgeleitet werden.

Uploads aus dem Browser

Dein Server erstellt ein Upload-Token und der Browser lädt direkt hoch, ohne jemals deinen API-Schlüssel zu sehen.

Regeln pro Präfix

Lege mit den Kontoeinstellungen Standardwerte (Sichtbarkeit, Ablauf, Cache), Limits (Größe, Dateitypen) und eine automatische Löschung nach N Tagen für alles unter einem Präfix fest.

Serverseitige Operationen

Kopiere, verschiebe und benenne Dateien um, ohne sie herunterzuladen, und ändere Header (Cache, Disposition, Metadaten) direkt an Ort und Stelle.

​
So funktioniert es

Dateien kommen über die REST-API, den Browser (mit einem Upload-Token) oder ein beliebiges S3-Tool herein. Jede Datei ist entweder öffentlich oder privat und geht über eine öffentliche URL, einen temporären Link oder einen Freigabelink hinaus.

​
Speicher und Preise

Speicher ist in deinem Plan enthalten, und es gibt keine Transfergebühren: du zahlst nur für das, was über dem Kontingent gespeichert bleibt.

​
Enthaltener Speicher

Jeder Plan enthält Speicher ohne Aufpreis, und er wächst mit dem Plan:

​
Wenn du dein Kontingent erreichst

Sobald deine Nutzung das enthaltene Kontingent erreicht, werden neue Uploads mit STORAGE_QUOTA_EXCEEDED abgelehnt, bis du Speicherplatz freigibst oder deinen Plan upgradest. Alles bereits Gespeicherte wird weiterhin normal ausgeliefert. Speicher, der über dem Kontingent liegt (zum Beispiel nach einem Plan-Downgrade), wird wie folgt berechnet:

Speicher über dem Kontingent

R$ 0,20 pro angefangenem GiB über dein enthaltenes Kontingent hinaus.
Account Stats zeigt deine aktuelle Nutzung, den Durchschnitt dieses Monats und die geschätzten Kosten für Speicher über dem Kontingent.
Blob Storage ist nur verfügbar für Konten mit einem aktiven Plan. Ein Konto ohne aktiven Plan kann Dateien weiterhin auflisten, herunterladen, löschen und privat machen. Läuft ein Plan ab oder wird er gekündigt, kommen gespeicherte Dateien in eine Löschwarteschlange, erneuere deinen Plan daher so schnell wie möglich: bereits gelöschte Dateien lassen sich nicht wiederherstellen.

​
Funktionen nach Plan

Jeder Plan erhält die vollständige API: öffentliche und private Dateien, temporäre Links, Freigabelinks, das S3-Gateway, Upload-Tokens und Regeln pro Präfix. Einige Optionen hängen vom Plan ab, und alle antworten mit demselben Code 403 UPGRADE_REQUIRED, dessen message den geltenden Plan (oder das Limit) nennt:

​
Öffentliche und private Dateien

Jedes Objekt ist entweder öffentlich oder privat, und seine id zeigt, welches von beiden: pub/<user_id>/<path> oder prv/<user_id>/<path>.
  • Öffentliche Dateien haben eine dauerhafte CDN-URL: https://blob.squarecloud.dev/pub/<user_id>/<path>.
  • Private Dateien haben keine öffentliche URL (url ist null). Du liest sie über einen temporären Link, einen Freigabelink, die API oder das S3-Gateway.
  • Legacy-Dateien, hochgeladen vor dem Update im September 2026, behalten ihre ursprüngliche id <user_id>/<path>, und jede Route akzeptiert sie. Ihre ursprüngliche URL unter https://public-blob.squarecloud.dev/<user_id>/<path> funktioniert noch 30 Tage lang, bis zum 25. Oktober 2026: Verschiebe sie mit Object Copy (move: true), um eine URL unter blob.squarecloud.dev zu erhalten.
Lies Links und Freigabe, um zu erfahren, wie sich Veröffentlichen, Zurückziehen und die verschiedenen Arten von Links verhalten.

​
Unterstützte Dateitypen

Praktisch jeder Dateityp wird akzeptiert, einschließlich Formaten ohne registrierten MIME-Typ: .bam, .vcf, .fasta, .fastq, .parquet, .h5, .npy und so weiter. Die gespeicherte Endung stammt aus dem Dateinamen, den du hochlädst, und zusammengesetzte Kompressionssuffixe bleiben erhalten (reads.fastq.gz bleibt .fastq.gz). Die einzige Ausnahme ist eine Sperrliste für ausführbare Dateien und Installer (.exe, .msi, .bat, .apk und ähnliche), die mit BLOCKED_FILE_TYPE abgelehnt werden.
Die Auslieferung ist von Grund auf sicher: Der ausgelieferte Content-Type wird serverseitig bestimmt, niemals vom Client. Unbekannte Formate und im Browser darstellbare Typen (.html, .svg, .xml) werden immer als Downloads (application/octet-stream) ausgeliefert, sodass bösartige Uploads niemals im Browser gerendert werden.

​
Leistung und Langlebigkeit

Blob Storage wurde vor dem Start umfangreichen Benchmarks unterzogen. Die wichtigsten Ergebnisse:
  • Latenz: Dateien werden im Durchschnitt in ~11 ms empfangen.
  • Langlebigkeit: ausgelegt auf 99,999999999 % (11 Neunen).
  • Edge-Auslieferung: Öffentliche Dateien werden am CDN-Edge gecacht, sodass wiederholte Abrufe nie zum Ursprung zurückmüssen.
  • Health Check: https://blob.squarecloud.dev/pub/status antwortet mit OK und wird nie gecacht, sodass du dein Monitoring darauf richten kannst.
Globaler Latenz-Benchmark von Blob Storage
Hinweis: Die Benchmark-Ergebnisse stammen aus kontrollierten Tests und variieren je nach geografischem Standort, Dateigröße, Netzwerkqualität und Spitzenauslastung. Die genauesten Werte erhältst du, wenn du aus deiner Produktionsumgebung testest.
Regionale Einschränkungen: Nutzer in Afrika und einigen asiatischen Regionen können aufgrund der physischen Entfernung zu den Rechenzentren und der lokalen Netzwerkinfrastruktur höhere Latenzen erfahren.

​
So hostest du deine Dateien

1

API-Schlüssel erstellen

Erstelle in deinen Kontoeinstellungen einen API-Schlüssel mit dem Scope blob:write. Siehe Authentifizierung.
2

Hochladen

Sende Dateien bis 100 MB an Object Post. Größere Dateien, bis 10 GiB, laufen über den Chunked-Upload-Ablauf. Du bevorzugst S3-Tools? Richte sie stattdessen auf das S3-Gateway.
3

Ausliefern

Verwende die url aus der Antwort für öffentliche Dateien, oder erstelle für private Dateien einen temporären Link oder einen Freigabelink.
Für einen ersten Upload und Download mit curl folge dem Schnellstart der Blob Storage API.
Du verwendest JavaScript? Das Blob SDK (@squarecloud/blob) übernimmt für dich einfache und Multipart-Uploads, Links, Freigaben, Regeln und das S3-Gateway, in Node.js und im Browser.

​
Häufig gestellte Fragen

Blob Storage ist für jeden Plan verfügbar, ab Hobby, jeweils mit einem eigenen enthaltenen Speicherkontingent (siehe Tabelle oben). Den vollständigen Vergleich findest du unter Pläne und Preise.
Neue Uploads werden mit STORAGE_QUOTA_EXCEEDED abgelehnt, bis du Objekte löschst oder deinen Plan upgradest. Alles bereits Gespeicherte wird weiterhin normal ausgeliefert. Speicher über dem Kontingent (zum Beispiel nach einem Downgrade) wird mit R$ 0,20 pro angefangenem GiB berechnet, und Account Stats zeigt die Schätzung jederzeit an.
Ja. Das S3-Gateway unter https://s3-blob.squarecloud.app funktioniert mit aws-cli, boto3, rclone und den AWS SDKs. Das Zugangsschlüsselpaar erhältst du über S3 Credentials: Es wird aus deinem API-Schlüssel abgeleitet, sodass das Widerrufen des Schlüssels auch das Paar widerruft.
Jeder Plan erhält Regeln pro Präfix (5 bei Hobby und Standard, 10 bei Pro, 20 bei Enterprise). Benutzerdefinierte Metadaten und passwortgeschützte Freigabelinks erfordern Pro oder Enterprise. Ablaufzeiten und automatische Löschung unter 7 Tagen sowie Dateien, die ohne Edge-Cache ausgeliefert werden, erfordern Enterprise. Außerhalb dieser Pläne wird der Request mit 403 UPGRADE_REQUIRED abgelehnt, und seine message nennt den Plan, der die Funktion freischaltet.
Noch 30 Tage. Legacy-Dateien, hochgeladen vor dem Update im September 2026, behalten ihre URL unter public-blob.squarecloud.dev bis zum 25. Oktober 2026, und ihre id <user_id>/<path> gilt weiterhin auf jeder Route. Damit der öffentliche Link danach erhalten bleibt, verschiebe die Datei mit Object Copy (move: true): Neue Dateien werden von blob.squarecloud.dev/pub/... ausgeliefert, und ihre id beginnt mit pub/ oder prv/.