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 mitSTORAGE_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 Code403 UPGRADE_REQUIRED, dessen message den geltenden Plan (oder das Limit) nennt:
Öffentliche und private Dateien
Jedes Objekt ist entweder öffentlich oder privat, und seineid 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 (
urlistnull). 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 unterhttps://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 unterblob.squarecloud.devzu erhalten.
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.
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/statusantwortet mitOKund wird nie gecacht, sodass du dein Monitoring darauf richten kannst.
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.
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.Häufig gestellte Fragen
Welchen Plan brauche ich für Blob Storage?
Welchen Plan brauche ich für Blob Storage?
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.
Was passiert, wenn ich mein enthaltenes Speicherkontingent erreiche?
Was passiert, wenn ich mein enthaltenes Speicherkontingent erreiche?
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.Temporärer Link oder Freigabelink?
Temporärer Link oder Freigabelink?
Ein temporärer Link ist bis zu 24 Stunden gültig und kann nicht widerrufen werden: Nutze ihn, um einem Nutzer sofort eine Datei zu übergeben. Ein Freigabelink hält bis zu 30 Tage, kann widerrufen werden, kann die Anzahl der Downloads begrenzen und bei Pro und Enterprise ein Passwort abfragen. Siehe Links und Freigabe.
Kann ich S3-Tools verwenden?
Kann ich S3-Tools verwenden?
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.Welche Funktionen hängen vom Plan ab?
Welche Funktionen hängen vom Plan ab?
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.Funktionieren meine alten Datei-URLs noch?
Funktionieren meine alten Datei-URLs noch?
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/.