Base64 enkoder i dekoder

Jak zakodować i odkodować Base64

1. 1 U góry wybierz, czy pracujesz z tekstem, czy z plikiem. Tekst możesz zarówno zakodować, jak i odkodować. Plik, na przykład obraz czy PDF, zakodujesz do Base64 albo od razu do data URI.
2. 2 Przy tekście wybierz Zakoduj albo Odkoduj i wklej tekst. Wynik pojawia się na bieżąco, już podczas pisania.
3. 3 Skopiuj wynik przyciskiem Kopiuj. Przyciskiem Zamień przeniesiesz go do pola wejściowego i odwrócisz kierunek, na przykład żeby sprawdzić wynik.

Co narzędzie zrobi za Ciebie

• przy odkodowywaniu rozpozna zwykły Base64 i base64url oraz dopisze brakujące znaki = na końcu
• odczyta całe data URI razem z typem pliku i zignoruje spacje oraz podziały wierszy
• rozpozna obraz, PDF czy archiwum, przy obrazie pokaże podgląd i zaproponuje pobranie
• tekst, który nie jest w UTF-8, spróbuje odczytać w starszym kodowaniu Windows-1250 i Cię o tym uprzedzi
• przy kodowaniu tekstu pokaże pod wynikiem także wersję base64url dla adresów URL i JWT
• wszystko przetwarza bezpośrednio w Twojej przeglądarce, nic nie jest wysyłane na serwer

Jak zamienić obraz na Base64 i z powrotem

Base64 najczęściej stosuje się przy obrazach. Mały obraz zakodujesz i wstawisz bezpośrednio do HTML albo CSS, bez osobnego pliku. A gdy dostaniesz obraz jako ciąg Base64, na przykład z API, zamienisz go tutaj z powrotem na plik i zapiszesz.

Jak odczytać token JWT

Token JWT wygląda jak jeden długi ciąg, ale składa się z trzech części oddzielonych kropką. Dwie pierwsze to zwykły JSON zakodowany w base64url, więc odczytasz je nawet bez klucza. Każdą część wklej do narzędzia osobno:

eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjMiLCJuYW1lIjoiSmFuYSIsImV4cCI6MTc2NzIyNTYwMH0.podpis

Nagłówek

{"alg":"HS256","typ":"JWT"}

algorytm podpisu i typ tokenu

Dane

{"sub":"123","name":"Jana","exp":1767225600}

identyfikator użytkownika, imię i czas wygaśnięcia

Podpis

podpis

binarny podpis, który weryfikuje serwer, to nie jest tekst

Wartość exp to czas wygaśnięcia w sekundach od 1 stycznia 1970, tutaj dokładnie północ 1 stycznia 2026 UTC. Dane w tokenie odczyta każdy, kto ma token, dlatego nigdy nie umieszczaj w nich haseł ani innych poufnych informacji.

Jak wyciągnąć załącznik ze źródła e-maila

W źródle wiadomości każdy załącznik jest zapisany jako długi blok Base64 za nagłówkiem Content-Transfer-Encoding: base64. Źródło otworzysz w Gmailu przez Pokaż oryginał, a w Outlooku przez Wyświetl źródło wiadomości. Skopiuj blok bez nagłówków, wklej go tutaj, wybierz Odkoduj i pobierz plik. To pomaga, gdy załącznika nie da się otworzyć w programie pocztowym albo program go zablokował.

Losowy klucz w Base64

Tajne klucze do API, szyfrowania czy podpisów często zapisuje się jako losowe bajty w Base64. Laravel na przykład przechowuje klucz aplikacji jako APP_KEY=base64: i 32 losowe bajty. Klucz wygenerujesz także tutaj, kryptograficznie bezpiecznym generatorem bezpośrednio w Twojej przeglądarce.

Czym jest Base64 i do czego służy

Base64 to sposób na zapisanie dowolnych danych, także obrazu czy PDF, za pomocą zaledwie 64 zwykłych znaków: wielkich i małych liter, cyfr oraz znaków + i /. Tak zapisane dane można przesłać wszędzie tam, gdzie dozwolony jest tylko tekst, na przykład w załącznikach e-maili, w odpowiedziach API w formacie JSON, w HTML czy CSS. Z każdych trzech bajtów powstają cztery znaki, dlatego wynik jest mniej więcej o jedną trzecią dłuższy od oryginalnych danych.

znaki w alfabecie Base64

64

z trzech bajtów powstają cztery znaki

3 → 4

o tyle dłuższy jest wynik

+33%

standard, który definiuje Base64

RFC 4648

Przykłady

Tak wyglądają typowe teksty przed zakodowaniem i po nim:

Jak działa Base64 krok po kroku

1. 1 Tekst najpierw zamienia się na bajty. Litery bez polskich znaków zajmują w UTF-8 jeden bajt, ą, ć czy ż dwa bajty, a emoji cztery.
2. 2 Każdy bajt ma osiem bitów. Bity ustawia się jeden za drugim i dzieli na grupy po sześć.
3. 3 Każda szóstka bitów to liczba od 0 do 63, której w alfabecie Base64 odpowiada jeden znak: 0 to A, 26 to a, 52 to 0, 62 to +, a 63 to /.
4. 4 Jeśli na ostatnią szóstkę zabraknie bitów, uzupełnia się ją zerami. Na końcu wyniku dopisuje się wtedy znaki =, aby jego długość była podzielna przez cztery.

Alfabet Base64 (tabela znaków)

Base64 używa dokładnie 64 znaków. Każdy odpowiada jednej liczbie od 0 do 63, czyli jednej szóstce bitów. Znak = nie należy do alfabetu, tylko uzupełnia długość na końcu.

1. 0 A
2. 1 B
3. 2 C
4. 3 D
5. 4 E
6. 5 F
7. 6 G
8. 7 H
9. 8 I
10. 9 J
11. 10 K
12. 11 L
13. 12 M
14. 13 N
15. 14 O
16. 15 P
17. 16 Q
18. 17 R
19. 18 S
20. 19 T
21. 20 U
22. 21 V
23. 22 W
24. 23 X
25. 24 Y
26. 25 Z
27. 26 a
28. 27 b
29. 28 c
30. 29 d
31. 30 e
32. 31 f
33. 32 g
34. 33 h
35. 34 i
36. 35 j
37. 36 k
38. 37 l
39. 38 m
40. 39 n
41. 40 o
42. 41 p
43. 42 q
44. 43 r
45. 44 s
46. 45 t
47. 46 u
48. 47 v
49. 48 w
50. 49 x
51. 50 y
52. 51 z
53. 52 0
54. 53 1
55. 54 2
56. 55 3
57. 56 4
58. 57 5
59. 58 6
60. 59 7
61. 60 8
62. 61 9
63. 62 +
64. 63 /

Skąd na końcu = albo ==

Base64 przetwarza dane po trzy bajty. Gdy na końcu zostanie ich mniej, brakujące miejsce oznacza znak =. Jeśli został jeden bajt, dochodzą dwa znaki =, przy dwóch bajtach jeden, a przy trzech żaden. Niektóre systemy, na przykład JWT, pomijają znaki =, bo dekoder i tak potrafi wyliczyć długość.

Jak duży będzie Base64

Z każdych trzech bajtów powstają cztery znaki, więc Base64 ma 4 × ⌈n ÷ 3⌉ znaków, gdzie n to liczba bajtów, a nawiasy oznaczają zaokrąglenie w górę. Wynik jest zatem mniej więcej o 33% dłuższy. W e-mailach Base64 dzieli się dodatkowo na wiersze po 76 znaków, a każdy wiersz kończą dwa znaki CR LF, dlatego załącznik rośnie o około 37%. I w drugą stronę: Base64 o długości d zawiera 3 × d ÷ 4 bajtów, od czego odejmujesz liczbę znaków = na końcu.

Warianty Base64

Wszystkie warianty używają tych samych pierwszych 62 znaków. Różnią się dwoma ostatnimi znakami, uzupełnianiem na końcu i tym, czy wynik dzieli się na wiersze.

Gdzie Base64 przydaje się w praktyce

<img src="data:image/png;base64,iVBORw0KGgo…" alt="Logo">

.ikona {
  background: url("data:image/svg+xml;base64,PHN2Zy…");
}

Content-Type: application/pdf; name="faktura.pdf"
Content-Transfer-Encoding: base64

JVBERi0xLjcKJeLjz9MK…

Authorization: Basic bG9naW46aGFzbG8=

eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjMiLCJuYW1lIjoiSmFuYSJ9.podpis

-----BEGIN CERTIFICATE-----
MIIDdzCCAl+gAwIBAgIE…
-----END CERTIFICATE-----

{
  "nazwa": "umowa.pdf",
  "zawartosc": "JVBERi0xLjcKJeLjz9MK…"
}

apiVersion: v1
kind: Secret
data:
  password: dGFqbmVoZXNsbw==

Jak rozpoznać plik po początku Base64

Większość formatów zaczyna się charakterystycznymi bajtami, dlatego również ich Base64 zaczyna się zawsze tak samo. Po pierwszych znakach często rozpoznasz typ pliku jeszcze przed odkodowaniem. Wiersze oznaczone gwiazdką pokazują tylko najczęstszy początek, a nie stałą regułę.

Base64 a inne kodowania

Base64 to nie jedyny sposób zapisu bajtów tekstem. Inne kodowania są albo dłuższe, ale łatwiej je czytać i przepisywać, albo krótsze, ale używają mniej typowych znaków.

Krótka historia Base64

1. 1987

   Kodowanie pojawiło się po raz pierwszy w specyfikacji bezpiecznej poczty PEM (RFC 989) pod nazwą printable encoding.

2. 1992

   Standard MIME (RFC 1341) wykorzystał je do załączników e-mail, wprowadził wiersze po 76 znaków i nadał mu nazwę Base64.

3. 2003

   RFC 3548 opisał Base64 jako osobny standard, niezależny od poczty, i dodał wariant dla adresów URL i nazw plików.

4. 2006

   RFC 4648 zastąpił poprzedni dokument i obowiązuje do dziś.

Base64 w programowaniu i w wierszu poleceń

Tak zakodujesz i odkodujesz tekst „Hej” w popularnych językach. Tekst z polskimi znakami zawsze najpierw zamień na bajty w UTF-8, inaczej dostaniesz błąd albo inny wynik.

const base64 = btoa(String.fromCharCode(...new TextEncoder().encode('Hej')));
const text = new TextDecoder().decode(Uint8Array.from(atob(base64), (c) => c.charCodeAt(0)));

Buffer.from('Hej', 'utf8').toString('base64');
Buffer.from('SGVq', 'base64').toString('utf8');
Buffer.from('Hej').toString('base64url');

base64_encode('Hej');
base64_decode('SGVq', true);

import base64

base64.b64encode('Hej'.encode()).decode()
base64.b64decode('SGVq').decode()
base64.urlsafe_b64encode(b'Hej')

Base64.getEncoder().encodeToString("Hej".getBytes(StandardCharsets.UTF_8));
new String(Base64.getDecoder().decode("SGVq"), StandardCharsets.UTF_8);

Convert.ToBase64String(Encoding.UTF8.GetBytes("Hej"));
Encoding.UTF8.GetString(Convert.FromBase64String("SGVq"));

printf 'Hej' | base64
echo 'SGVq' | base64 -d
base64 < plik.pdf > plik.txt

[Convert]::ToBase64String([Text.Encoding]::UTF8.GetBytes('Hej'))
[Text.Encoding]::UTF8.GetString([Convert]::FromBase64String('SGVq'))
[Convert]::ToBase64String([IO.File]::ReadAllBytes('plik.pdf'))

Obrazy i SVG w kodzie

Obraz na Base64 w JavaScripcie

const file = document.querySelector('input[type=file]').files[0];
const reader = new FileReader();

reader.onload = () => console.log(reader.result);
reader.readAsDataURL(file);

Metoda readAsDataURL zwraca gotowe data URI razem z typem pliku, na przykład data:image/png;base64,iVBORw0KGg….

Odkodowanie pliku Base64 w wierszu poleceń

Gdy masz Base64 zapisany w pliku, na przykład z API albo z logu, odkodujesz go od razu z powrotem do oryginalnego pliku:

Linux

base64 -d obraz.txt > obraz.png

macOS

base64 -d -i obraz.txt -o obraz.png

Windows (wiersz poleceń)

certutil -decode obraz.txt obraz.png

Windows PowerShell

[IO.File]::WriteAllBytes('obraz.png', [Convert]::FromBase64String((Get-Content obraz.txt -Raw)))

OpenSSL

openssl base64 -d -A -in obraz.txt -out obraz.png

Jeśli plik zaczyna się nagłówkiem data URI, na przykład data:image/png;base64,, najpierw go usuń. Polecenie certutil poradzi sobie też z plikiem, który ma wiersze BEGIN i END.

Częste błędy i jak je naprawić

Kiedy używać Base64, a kiedy nie