Base64 File Encoder

Co je Base64 kódování souborů?

Base64 kódování souborů převádí binární soubory — PDF, ZIP, obrázky, spustitelné soubory, fonty, zvuk — na prostý ASCII text pomocí abecedy definované v RFC 4648. Každé tři bajty binárního vstupu se přemění na čtyři Base64 znaky, čímž vznikne textová reprezentace, která může procházet kanály určenými výhradně pro text: JSON API payloady, XML dokumenty, těla e-mailů, HTML atributy a proměnné prostředí.

Na rozdíl od kódování textu do Base64 (které pracuje s řetězci) čte kódování souborů do Base64 surový proud bajtů libovolného souboru bez ohledu na jeho formát. Binární hlavičky PDF, komprimované bloky ZIP a pixelová data PNG jsou zpracovány stejně: jako posloupnost oktetů k překódování. Výsledek je vždy platný ASCII, bezpečný pro vložení kamkoli, kde jsou povoleny tisknutelné znaky.

Kompromisem je velikost: výstup Base64 je přibližně o 33 % větší než původní binární soubor. Pro PDF o velikosti 1 MB to znamená přibližně 1,33 MB textu v Base64. Tato režie je cenou za reprezentaci 8-bitových bajtů pomocí 6-bitových znaků a je vlastností samotného kódování — žádná implementace se jí nevyhne. I přes to zůstává Base64 kódování souborů standardní metodou pro vkládání binárních dat do formátů pouze pro text, specifikovanou v MIME (RFC 2045), datových URI (RFC 2397) a JSON Web Tokens (RFC 7519).

Proč používat tento Base64 File Encoder?

Tento nástroj kóduje soubory do Base64 přímo ve vašem prohlížeči pomocí FileReader API. Žádný soubor není nahrán na server — veškerá konverze probíhá na straně klienta v JavaScriptu.

Případy použití Base64 kódování souborů

Nárůst velikosti souboru při Base64 kódování

Base64 kódování zvětšuje objem dat přesně o jednu třetinu. Každé 3 vstupní bajty produkují 4 výstupní znaky (každý reprezentuje 6 bitů). Výplňové znaky (=) jsou přidány, když délka vstupu není násobkem 3. Tabulka níže ukazuje vztah mezi původní velikostí souboru a velikostí zakódovaného výstupu.

Datové URI a přehled MIME typů

Datové URI vkládá obsah souboru přímo do HTML, CSS nebo JavaScriptu ve formátu data:[MIME typ];base64,[zakódovaná data]. MIME typ říká prohlížeči, jak interpretovat dekódované bajty. Níže jsou uvedeny běžné přípony souborů, jejich MIME typy a odpovídající předpony datových URI.

Ukázky kódu

Tyto spustitelné příklady ukazují, jak načíst binární soubor a zakódovat ho do Base64 v JavaScriptu, Pythonu, Node.js, shellu a Go. Každá ukázka produkuje standardní Base64 (RFC 4648 sekce 4) s výplní.

// Read a file from an <input> element and encode to Base64
const input = document.querySelector('input[type="file"]')
input.addEventListener('change', (e) => {
  const file = e.target.files[0]
  const reader = new FileReader()
  reader.onload = () => {
    const base64 = reader.result.split(',')[1]
    console.log(base64) // → "JVBERi0xLjQK..." (raw Base64, no data URI prefix)
  }
  reader.readAsDataURL(file)
})

// Convert a Blob to Base64 with async/await
async function blobToBase64(blob) {
  const buffer = await blob.arrayBuffer()
  const bytes = new Uint8Array(buffer)
  let binary = ''
  bytes.forEach(b => binary += String.fromCharCode(b))
  return btoa(binary) // → standard Base64 string
}

import base64
from pathlib import Path

# Encode a file to Base64
file_bytes = Path('document.pdf').read_bytes()
encoded = base64.b64encode(file_bytes).decode('ascii')
print(encoded[:40])  # → "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PA..."

# Write encoded output to a text file
Path('document.b64.txt').write_text(encoded)

# Build a data URI from a file
mime_type = 'application/pdf'
data_uri = f'data:{mime_type};base64,{encoded}'
print(data_uri[:60])  # → "data:application/pdf;base64,JVBERi0xLj..."

import { readFileSync, writeFileSync } from 'fs'

// Encode a file to Base64
const buffer = readFileSync('archive.zip')
const base64 = buffer.toString('base64')
console.log(base64.length) // → 1398104 (for a ~1 MB file)

// Save Base64 output to a file
writeFileSync('archive.b64.txt', base64)

// Build a data URI
const mime = 'application/zip'
const dataUri = `data:${mime};base64,${base64}`

# Encode a file to Base64 (macOS / Linux)
base64 < document.pdf > document.b64.txt

# Encode with no line wrapping (GNU coreutils)
base64 -w 0 < document.pdf > document.b64.txt

# Encode and copy to clipboard (macOS)
base64 < image.png | pbcopy

# Encode with OpenSSL (available everywhere)
openssl base64 -in archive.zip -out archive.b64.txt

# Pipe directly into curl for API upload
base64 -w 0 < photo.jpg | curl -X POST -d @- https://api.example.com/upload

package main

import (
	"encoding/base64"
	"fmt"
	"os"
)

func main() {
	data, err := os.ReadFile("document.pdf")
	if err != nil {
		panic(err)
	}
	encoded := base64.StdEncoding.EncodeToString(data)
	fmt.Println(len(encoded)) // → 1398104 (for a ~1 MB file)

	// Write to file
	os.WriteFile("document.b64.txt", []byte(encoded), 0644)
}

Často kladené otázky