Was b64 macht
b64 wandelt Bytes in Base64-Text um und zurück. Übergeben Sie den Text als Argument, leiten Sie Daten per Pipe hinein oder verweisen Sie mit -i auf eine Datei. Beim Kodieren gibt es das Ergebnis plus einen Zeilenumbruch aus; beim Dekodieren schreibt es die rohen Bytes und sonst nichts, sodass Binärdateien unversehrt herauskommen.
$ b64 "Hello, hub!"
SGVsbG8sIGh1YiE=
$ b64 -d SGVsbG8sIGh1YiE=
Hello, hub!
$ printf '\xfb\xff\xbf' | b64 --url
-_-_
$ b64 --url --no-pad "Привет"
0J_RgNC40LLQtdGC
Die letzten beiden Befehle zeigen das URL-sichere Alphabet (- und _ statt + und /) und eine Ausgabe ohne =-Padding, die Form, die in JWTs und URLs verwendet wird. Base64 vs. Base64URL erklärt den Unterschied.
Installation
Die Installationsbox oben enthält einen Befehl für jeden Paketmanager. Kurz gefasst:
| Plattform | Befehl |
|---|---|
| macOS, Linux (Homebrew) | brew install base64hub-com/tap/b64 |
| Windows (winget) | winget install base64hub.b64 |
| Windows (Scoop) | scoop bucket add base64hub https://github.com/base64hub-com/homebrew-tap, dann scoop install b64 |
| Arch Linux (AUR) | yay -S b64-bin |
| Jede Unix-Shell | curl -fsSL https://base64hub.com/install.sh | sh |
| Mit Node.js oder Python | npm i -g base64hub oder pipx install base64hub |
| Mit Go | go install github.com/base64hub-com/base64hub-cli/cmd/b64@latest |
Für einen einfachen Download gibt es unter Alle Downloads .tar.gz-, .zip- und .deb-Builds für x86_64 und arm64, dazu eine Datei SHA256SUMS zum Prüfen. Die Builds aus npm und PyPI installieren denselben Befehl b64 mit denselben Flags.
Beispiele für den Alltag
Achten Sie auf den Zeilenumbruch: echo hängt einen an, und b64 kodiert jedes Byte, das es erhält.
$ echo hello | b64
aGVsbG8K
$ printf 'hello' | b64
aGVsbG8=
Lange Ausgaben brechen Sie mit -w um, etwa nach 76 Zeichen für MIME:
$ printf 'foobar' | b64 -w 4
Zm9v
YmFy
Eine Data-URI erzeugen. Der MIME-Typ wird am Inhalt erkannt (PNG, JPEG, GIF, WebP, PDF, SVG, Text) oder mit -m gesetzt:
$ printf 'Hi' | b64 --data-uri
data:text/plain;charset=utf-8;base64,SGk=
$ b64 --data-uri -i logo.png -o logo.txt
Prüfen Sie einen String, bevor Sie ihm vertrauen. Das Urteil über ungültige Eingaben geht mit Exit-Code 1 nach stderr. Ein String, der mit - beginnt, braucht davor --, damit er nicht als Flag gelesen wird:
$ b64 --validate -- -_-_
valid (url, 3 bytes)
$ b64 --validate 'Zm9vY'
invalid: invalid length: 5 characters leave a single character in the last group
$ b64 -d 'Zm9v!'
b64: invalid character '!' at position 4
b64 im Vergleich zum Befehl base64
Linux bringt base64 aus den GNU coreutils mit, macOS eine BSD-Version, und ihre Flags unterscheiden sich (Details unter Base64 in Bash). b64 verhält sich auf jedem System gleich. Die GNU-Spalte unten wurde mit coreutils 9.7 geprüft.
| Aufgabe | GNU base64 | b64 |
|---|---|---|
| Zeilenlänge der Ausgabe | bricht nach 76 Zeichen um, außer mit -w 0 | eine Zeile, außer mit -w N |
| URL-sicheres Alphabet | nein (basenc --base64url kann es) | -u / --url |
Eingabe mit - oder _ dekodieren | base64: invalid input | wird akzeptiert |
data:-URI als Ein- oder Ausgabe | nein | --data-uri; beim Dekodieren wird das Präfix entfernt |
| String prüfen | nein | --validate mit Variante und Byte-Anzahl |
| Fehlerdetails | invalid input | das falsche Zeichen und seine Position |
Das Dekodieren ist in b64 absichtlich tolerant: Leerzeichen, Tabs und Zeilenumbrüche werden ignoriert, Padding ist optional, und beide Alphabete werden akzeptiert. Alles andere, etwa ein verirrtes ! oder ein = in der Mitte, ist ein Fehler mit Exit-Code 1. Aufruffehler enden mit Exit-Code 2, so können Skripte fehlerhafte Daten von einer fehlerhaften Befehlszeile unterscheiden.
Funktioniert offline
b64 arbeitet auf Ihrem Rechner und braucht weder Konto noch Netzwerkverbindung. Der Go-Build streamt stdin in Blöcken, so bleibt der Speicherbedarf auch bei Eingaben von mehreren Gigabyte gleich. Für einzelne Strings im Browser gibt es auf dieser Website den Base64-Encoder und den Decoder; die CLI-Doku beschreibt jedes Flag und jeden Exit-Code.
Häufige Fragen
Wie installiere ich ein Base64-Kommandozeilentool mit Homebrew?
Führen Sie brew install base64hub-com/tap/b64 aus. Die Formel liegt im Tap base64hub-com/tap und installiert den Befehl b64 unter macOS und Linux.
Ist b64 ein direkter Ersatz für den Befehl base64?
Nein, die Flags unterscheiden sich. b64 bricht Zeilen nur mit -w um, dekodiert überall mit -d und bietet zusätzlich URL-sichere Ausgabe, Data-URIs und Validierung. Behalten Sie base64 in Skripten, die sich auf sein genaues Verhalten verlassen.
Wie kodiere ich eine Datei auf der Kommandozeile in Base64?
b64 -i photo.jpg -o photo.b64 oder b64 < photo.jpg > photo.b64. Mit --data-uri erhalten Sie einen String data:image/jpeg;base64,…, den Sie in HTML oder CSS einfügen können.
Warum gibt b64 „valid (either, …)“ aus?
Der String enthält keines der Zeichen + / - _ und ist daher sowohl im Standard- als auch im URL-sicheren Alphabet gültig. standard, url und mixed erscheinen, wenn diese Zeichen vorkommen.