Startseite › Entwickler-Tools › Protobuf-Decoder

Protobuf-Decoder

Füge eine Protocol-Buffers-Nachricht als Hex oder Base64 ein und sieh jede Feldnummer, jeden Wire-Typ und jeden Wert – verschachtelte Nachrichten, Strings und gepackte Zahlen werden automatisch erkannt. Füge deine .proto-Datei hinzu, um Feldnamen, Enum-Namen und korrekt typisierte Werte zu erhalten.

Zuletzt aktualisiert:

Schema (.proto) optional, für Feldnamen
Anzeige
Anzeige

Anleitung: Protobuf-Decoder

  1. Füge die kodierte Nachricht ein als Hex oder Base64 oder lade die rohe Binärdatei hoch. Das Format wird automatisch erkannt.
  2. Lies den Baum: Jede Zeile zeigt die Feldnummer, den erkannten Typ, den Wert und seinen Byte-Offset.
  3. Füge optional deine .proto hinzu im Schema-Bereich und wähle die Root-Nachricht, um Feldnamen und Enum-Werte zu sehen.
  4. Entferne ein Präfix, wenn die Bytes aus gRPC oder einem längenbegrenzten Stream stammen.
  5. Wechsle zur JSON- oder decode_raw-Ansicht und kopiere oder lade das Ergebnis herunter.

Protobuf-Wire-Typen auf einen Blick

Wire-TypNameGrößeVerwendet für
0VARINT1 bis 10 Bytesint32, int64, uint32, uint64, sint32, sint64, bool, enum
1I648 Bytes, Little-Endianfixed64, sfixed64, double
2LENVarint-Länge + Datenstring, bytes, eingebettete Nachrichten, gepackte wiederholte Felder, Map-Einträge
3SGROUPbis zum passenden EGROUPproto2-Gruppen (veraltet)
4EGROUPnur TagEnde einer proto2-Gruppe
5I324 Bytes, Little-Endianfixed32, sfixed32, float

Eine Nachricht von Hand lesen

Jedes Feld beginnt mit einem Tag, einem Varint gleich (field_number << 3) | wire_type. Ein Varint speichert 7 Bits pro Byte, die niederwertigste Gruppe zuerst, und das höchste Bit jedes Bytes gibt an, ob ein weiteres Byte folgt. Nimm die Bytes 08 96 01:

  • 08 ist das Tag: 8 >> 3 = Feld 1, 8 & 7 = Wire-Typ 0 (VARINT).
  • 96 01 ist der Wert: 0x96 hat das Fortsetzungsbit gesetzt, also nimm seine unteren 7 Bits (0x16 = 22) und addiere das nächste Byte um 7 verschoben (1 × 128). Der Wert ist 150.

Bei einem längenbegrenzten Feld wie 12 07 74 65 73 74 69 6e 67 bedeutet das Tag 0x12 Feld 2, Wire-Typ 2, und der nächste Varint (7) ist die Anzahl der folgenden Datenbytes, hier der UTF-8-Text "testing". Häufige Tag-Bytes, die man kennen sollte: 0a (Feld 1, LEN), 10 (Feld 2, VARINT), 12 (Feld 2, LEN), 18 (Feld 3, VARINT), 1a (Feld 3, LEN).

Tipps zum Dekodieren echter Payloads

  • Base64 aus JSON oder Logs: gRPC-Web, Firebase und viele APIs kodieren Protobuf-Bytes in Base64. Füge sie direkt ein; URL-sicheres Base64 mit - und _ funktioniert ebenfalls.
  • Streams mit Längenpräfix: Dateien, die mit writeDelimitedTo geschrieben wurden, beginnen jede Nachricht mit einer Varint-Länge. Nutze für die erste Nachricht die Option für längenbegrenztes Überspringen.
  • Negative int32-Werte werden immer als 10-Byte-Varints kodiert, daher ist ein langer Varint, der auf 01 endet, meist eine negative Zahl; prüfe die int64-Lesart.
  • Floats und Doubles: Ein 32-Bit- oder 64-Bit-Feld wird als float oder double angezeigt, wenn der Wert wie eine gewöhnliche Zahl aussieht, sonst als vorzeichenlose Ganzzahl, mit der anderen Lesart daneben.
  • Proto2 vs. proto3: Beide verwenden dasselbe Wire-Format. Proto3 packt wiederholte numerische Felder standardmäßig, und der Decoder entpackt sie, egal ob sie gepackt sind oder nicht.

Häufige Fragen

Kann man Protobuf ohne die .proto-Datei dekodieren?

Ja, teilweise. Das Binärformat speichert die Nummer und den Wire-Typ jedes Feldes, daher lassen sich Struktur, Zahlen und Strings immer wiederherstellen. Ohne Schema gehen die Feldnamen und die genauen Typen verloren: Ein Varint kann ein int32, ein bool, ein Enum oder ein ZigZag-kodierter sint sein, daher zeigt der Decoder die wahrscheinlichen Lesarten nebeneinander.

Was sind Protobuf-Wire-Typen?

Jedes Feld beginnt mit einem Tag, das die Feldnummer und einen 3-Bit-Wire-Typ enthält: 0 VARINT (int32, int64, uint, sint, bool, enum), 1 I64 (fixed64, sfixed64, double), 2 LEN (string, bytes, verschachtelte Nachrichten, gepackte wiederholte Felder), 3 und 4 Gruppenbeginn und -ende (veraltete proto2-Gruppen) und 5 I32 (fixed32, sfixed32, float). Das Tag selbst ist der Varint (field_number << 3) | wire_type.

Wie unterscheidet der Decoder einen String von einer verschachtelten Nachricht?

Ein längenbegrenztes Feld kann beides enthalten. Der Decoder prüft zuerst, ob die Bytes gültiger, druckbarer UTF-8-Text sind, und zeigt sie als String an; andernfalls versucht er, sie als Nachricht zu parsen, und akzeptiert das Ergebnis nur, wenn jedes Byte von gültigen Feldern verbraucht wird. Klappt beides nicht, versucht er gepackte Varints und zeigt zuletzt Rohbytes an. Wenn sich ein String auch als Nachricht parsen lässt, wird das vermerkt, damit du es mit einem Schema prüfen kannst.

Was ist ZigZag-Kodierung?

sint32- und sint64-Felder bilden vorzeichenbehaftete Zahlen auf vorzeichenlose ab, damit kleine negative Werte kurz bleiben: 0 wird zu 0, -1 zu 1, 1 zu 2, -2 zu 3 und so weiter, mit (n << 1) ^ (n >> 63). Ohne sie belegt ein negativer int32 oder int64 als Varint immer 10 Bytes. Der Decoder zeigt die ZigZag-Lesart jedes Varints als "sint" an.

Wie dekodiere ich eine gRPC-Nachricht?

Eine gRPC-Nachricht hat auf der Leitung ein 5-Byte-Präfix: ein Kompressions-Flag-Byte und eine 4-Byte-Länge in Big-Endian. Wähle "gRPC-Frame" unter Führende Bytes überspringen, um es zu entfernen. Ist das Flag 1, ist die Nutzlast komprimiert (meist gzip) und muss vor dem Dekodieren entpackt werden.

Warum sind 64-Bit-Zahlen in der JSON-Ausgabe Strings?

Das proto3-JSON-Mapping schreibt int64-, uint64-, fixed64- und sfixed64-Werte als Strings, weil JavaScript-Zahlen oberhalb von 2^53 an Genauigkeit verlieren. Ohne Schema werden kleine Varints aus demselben Grund als Zahlen und größere als Strings geschrieben.

Werden meine Daten an einen Server gesendet?

Nein. Die Nachricht und die .proto-Datei werden per JavaScript in deinem Browser-Tab geparst. Nichts wird hochgeladen, daher kannst du auch Produktiv-Payloads sicher untersuchen.

Werden alle Tools auf FreeToolCabin auf Qualität und Genauigkeit getestet?

Ja. Jedes Tool auf der Website durchläuft automatische Tests in echten Browsern, die prüfen, ob das Ergebnis stimmt und keine Fehler auftreten. Wenn du einen Fehler findest oder einen Vorschlag hast, schreib uns an [email protected] – wir sehen es uns an.

Ähnliche Tools

Alle Encoder, Hashes & Krypto ansehen →