Datei-zu-Base64-Konverter

Warum eine Datei als Base64 kodieren?

Viele Formate, mit denen Systeme Daten austauschen, transportieren nur Text. JSON, XML, YAML, HTML und E-Mail-Header können keine beliebigen Bytes aufnehmen, denn eine Datei kann Nullbytes, ungültige Zeichenfolgen oder Zeilenenden enthalten, die ein Textparser verändern würde. Base64 bildet je 3 Bytes der Datei auf 4 Zeichen aus einem Satz von 64 Buchstaben, Ziffern, + und / ab. So lässt sich jede Datei als einfacher String übertragen und wieder in exakt dieselben Bytes dekodieren.

Der Preis dafür ist die Größe: Der kodierte Text ist etwa 33 % größer als die Datei, Zeilenumbrüche kommen noch ein wenig hinzu. Aus einer 3-MB-Datei werden rund 4 MB Base64.

Typische Einsatzzwecke

• JSON- und XML-APIs. Endpunkte, die keine Multipart-Formular-Uploads annehmen, erwarten die Datei oft als Base64-String in einem Feld, während Name und Typ in anderen Feldern stehen.
• E-Mail-Anhänge. MIME kodiert Anhänge in Base64 mit Zeilen von höchstens 76 Zeichen (RFC 2045). Die Option „Zeilenumbruch nach 76 Zeichen“ erzeugt genau dieses Layout.
• Konfiguration und Secrets. Die Werte unter data in einem Kubernetes-Secret sind Base64-kodiert. Ein TLS-Zertifikat, ein Keystore oder eine Lizenzdatei muss daher vor dem Eintrag ins Manifest kodiert werden. CI-Systeme legen binäre Secrets auf dieselbe Weise oft in Umgebungsvariablen ab.
• Datenbanken und Quellcode. Eine kleine Binärdatei wie eine Schriftart, ein Sound oder eine Testdatei lässt sich in einer Textspalte oder einer String-Konstante speichern statt in einer separaten Datei.

Für Bilder bietet Bild zu Base64 zusätzlich Skalierung und fertige HTML- und CSS-Snippets. Um Base64 wieder in eine Datei umzuwandeln, verwenden Sie Base64 zu Datei.

Reines Base64 oder Data-URI?

Reines Base64 enthält nur die kodierten Bytes. Genau das erwarten APIs, Kubernetes, Datenbanken und die meisten Programmierbibliotheken, meist zusammen mit einem separaten Feld für Dateinamen oder Content-Type.

Eine Data-URI stellt ein Präfix mit dem MIME-Typ voran, zum Beispiel data:application/pdf;base64,. Damit kann ein Browser den gesamten String als URL in src, href oder in CSS-url() verwenden. Senden Sie dieses Präfix nicht an eine API, die reines Base64 verlangt, denn viele Decoder lehnen es ab. Wenn Sie den MIME-Typ selbst festlegen oder Prozentkodierung verwenden möchten, nutzen Sie den Data-URI-Generator.

Lassen Sie den Zeilenumbruch für JSON, YAML und Quellcode ausgeschaltet. Ein JSON-String darf keine echten Zeilenumbrüche enthalten, und umbrochene Werte in YAML gehen leicht kaputt.

Eine Datei auf der Kommandozeile kodieren

# Linux (GNU coreutils): -w 0 schaltet den standardmäßigen Umbruch nach 76 Zeichen ab
base64 -w 0 report.docx > report.txt

# macOS
base64 -i report.docx -o report.txt

# Windows PowerShell
[Convert]::ToBase64String([IO.File]::ReadAllBytes("C:\files\report.docx"))

# Kubernetes kodiert die Datei automatisch
kubectl create secret generic app-cert --from-file=tls.crt