O que é a codificação Base64? Como funciona, por que fica 33% maior e por que não é criptografia
Base64 escreve qualquer arquivo ou texto com letras e dígitos simples para e-mail, JSON e URLs. Como funciona, por que adiciona 33% e por que não é criptografia.
Atualizado em 1 de novembro de 20269 min de leitura
Base64 é uma forma de escrever qualquer dado, uma foto, um PDF ou uma frase, usando apenas 64 caracteres seguros: as letras de A a Z e de a a z, os dígitos de 0 a 9, dois símbolos e um sinal de igual para o preenchimento. Ele existe porque muitos sistemas que transportam dados, como e-mail, JSON e endereços da web, foram feitos para texto simples e falham diante de dados binários brutos. Base64 não é compressão nem criptografia. Ele deixa os dados cerca de 33% maiores e qualquer pessoa pode revertê-lo em um segundo, então nunca o use para esconder algo.
O que o Base64 realmente faz
Os computadores guardam tudo como bytes, e um byte pode ter 256 valores. Alguns desses valores são códigos de controle ou caracteres que sistemas pensados só para texto tratam como especiais: uma quebra de linha, um byte nulo, uma aspa. Se você passar um JPEG por um sistema que espera texto, ele pode ser alterado, cortado ou rejeitado. O Base64 resolve isso traduzindo cada byte para uma forma que é garantidamente texto comum e imprimível. O destinatário traduz de volta e recebe exatamente os bytes originais.
Pense em uma caixa de transporte. O conteúdo não muda, mas a caixa cabe em qualquer esteira. O preço da caixa é o volume extra, e é daí que vêm os 33%.
Como 3 bytes viram 4 caracteres
O método é pequeno o bastante para ser feito à mão. Pegue três bytes, ou seja, 24 bits. Divida esses 24 bits em quatro grupos de 6 bits. Cada grupo de 6 bits é um número de 0 a 63, e cada número corresponde a um caractere do alfabeto Base64: de 0 a 25 são A a Z, de 26 a 51 são a a z, de 52 a 61 são 0 a 9, o 62 é + e o 63 é /.
Exemplo com a palavra Man. As letras M, a e n são os bytes 77, 97 e 110, em binário 01001101, 01100001 e 01101110. Junte tudo em uma cadeia de 24 bits e reagrupe de seis em seis: 010011, 010110, 000101, 101110. São 19, 22, 5 e 46, que correspondem a T, W, F e u. Assim, Man vira TWFu.
| Etapa | Valor |
|---|---|
| Texto | M, a, n |
| Bytes (decimal) | 77, 97, 110 |
| Bits, unidos | 01001101 01100001 01101110 |
| Reagrupados em 6 bits | 010011 010110 000101 101110 |
| Números | 19, 22, 5, 46 |
| Caracteres Base64 | T, W, F, u |
Por que o resultado fica 33% maior
Entram três bytes, saem quatro caracteres, e cada caractere ocupa um byte. É uma proporção de 4 para 3, então o resultado é cerca de um terço maior que o original. O tamanho exato é 4 vezes o tamanho da entrada dividido por 3, arredondado para cima. Um arquivo de 3.000 bytes vira 4.000 caracteres. Uma foto de 1 MB vira cerca de 1,33 MB de texto.
Dois detalhes mudam um pouco a conta. O e-mail e os certificados PEM dividem o Base64 em linhas (de 76 ou de 64 caracteres), e cada quebra de linha acrescenta um pouco. E quando a entrada não é múltiplo de três bytes, entra preenchimento, explicado abaixo.
| Tamanho original | Tamanho em Base64 (aprox.) | A mais |
|---|---|---|
| 3 KB | 4 KB | +1 KB |
| 100 KB | 133 KB | +33 KB |
| 1 MB | 1,33 MB | +0,33 MB |
| 10 MB | 13,3 MB | +3,3 MB |
Esse é o principal motivo para não embutir imagens grandes como Base64 em uma página da web. Uma imagem de 200 KB custa à página cerca de 267 KB, e o navegador não consegue guardá-la em cache separadamente da página que a contém. Para ícones pequenos, vale a pena economizar uma requisição; para fotos, quase nunca. Se o problema é a imagem, reduza o tamanho dela primeiro e só depois codifique.
Preenchimento: para que servem os sinais de igual
Dados reais raramente são um múltiplo exato de três bytes. Quando sobram um ou dois bytes, o Base64 completa o último grupo com bits zero e acrescenta sinais = para que a saída sempre tenha um comprimento múltiplo de quatro. Dois bytes sobrando dão um =. Um byte sobrando dá ==.
| Entrada | Bytes | Base64 | Preenchimento |
|---|---|---|---|
| Man | 3 | TWFu | nenhum |
| Ma | 2 | TWE= | um = |
| M | 1 | TQ== | dois == |
| Hello | 5 | SGVsbG8= | um = |
O preenchimento não carrega dados. Ele só avisa ao decodificador onde terminam os bits reais. Muitos sistemas aceitam Base64 sem ele e os tokens costumam omiti-lo, mas um decodificador estrito pode recusar uma cadeia com o comprimento errado. Se uma decodificação falhar com erro de comprimento, a primeira coisa a verificar é se falta um = no final.
Onde você encontra Base64 todo dia
- URIs de dados. Uma cadeia que começa com data:image/png;base64, seguida da imagem codificada permite que uma imagem more dentro de HTML, CSS ou da assinatura de um e-mail, sem arquivo separado.
- Anexos de e-mail. O e-mail foi criado para texto de 7 bits, então o MIME codifica os anexos em Base64, dividido em linhas de 76 caracteres. Por isso um anexo ocupa na rede cerca de um terço a mais do que no seu disco; veja o guia sobre o limite de anexos do Gmail.
- JSON e cargas de API. O JSON não tem tipo binário, então uma API que recebe uma imagem ou um PDF normalmente pede esse conteúdo como cadeia Base64 em um campo. Formate o restante da carga com o formatador de JSON para ler com mais facilidade.
- Tokens e cabeçalhos. As três partes de um JSON Web Token são cadeias Base64, e a autenticação básica do HTTP envia usuário:senha em Base64.
- Certificados e chaves. Os arquivos PEM, os que ficam entre as linhas BEGIN e END, são Base64 dividido em linhas de 64 caracteres.
Codificar ou decodificar Base64 passo a passo
Abra a ferramenta e escolha o sentido
Abra o codificador e decodificador Base64 e escolha Codificar para gerar Base64 ou Decodificar para recuperar o original. Também há páginas dedicadas para codificar e decodificar.
Cole um texto ou solte um arquivo
Digite ou cole na caixa, ou solte um arquivo como uma imagem ou um PDF. O texto digitado é convertido enquanto você escreve, e o painel mostra o tamanho de entrada, o de saída e o percentual de acréscimo.
Ajuste o formato se precisar
Em Alfabeto, escolha Padrão ou Seguro para URL. Ative Envolver o resultado como URI de dados se o resultado for para HTML ou CSS. Escolha uma Quebra de linha de 64 (PEM) ou 76 (MIME) somente quando um certificado ou o corpo de um e-mail exigir.
Decodifique para texto ou para arquivo
Ao decodificar, defina Saída decodificada como Texto para ler o resultado na caixa, ou como Arquivo para baixá-lo. A ferramenta identifica o tipo de arquivo, então um PNG decodificado é baixado como PNG.
Copie ou baixe
Copie o resultado ou baixe-o. Tudo roda no seu dispositivo, não nos nossos servidores, então uma imagem privada ou uma chave não é enviada para ser convertida.
Converta texto e arquivos nos dois sentidos, com alfabeto padrão e seguro para URL e saída como URI de dados. Grátis: um arquivo de até 25 MB por vez. Pro: fila de até 100 arquivos, baixados em um único ZIP. Roda no seu dispositivo, não nos nossos servidores.
Codificar ou decodificar Base64Base64 seguro para URL
O alfabeto padrão usa + e /, e ambos causam problemas em endereços da web: um mais pode ser lido como espaço em uma cadeia de consulta, e a barra é um separador de caminho. A variante segura para URL troca esses caracteres por - e _ e normalmente omite o preenchimento =. É a forma usada em JSON Web Tokens, em nomes de arquivo e em muitos parâmetros de consulta.
| Padrão | Seguro para URL | |
|---|---|---|
| Caractere 62 | + | - |
| Caractere 63 | / | _ |
| Preenchimento | = mantido | normalmente omitido |
| Uso típico | E-mail, PEM, URIs de dados | Tokens, nomes de arquivo, cadeias de consulta |
Ao decodificar, a ferramenta detecta qual alfabeto a cadeia usa, então você não precisa saber de antemão. Ao codificar, escolha Seguro para URL e a opção de retirar os sinais = finais. Não confunda com a codificação por porcentagem, em que os caracteres viram códigos como %20; é outro trabalho, feito pelo codificador e decodificador de URL.
Quando uma decodificação falha ou parece errada
| O que você vê | Causa provável | Solução |
|---|---|---|
| Erro de comprimento ou de preenchimento | Falta ou sobra um = no final, ou a cadeia foi cortada | Copie a cadeia inteira de novo; restaure o preenchimento |
| Caractere desconhecido | Um espaço, aspa ou quebra de linha colado junto, ou texto seguro para URL lido como padrão | Deixe o alfabeto em Detectar; retire as aspas sobrando |
| Pontos de interrogação ou símbolos estranhos | Os bytes não são texto UTF-8 | Mude a codificação de texto do resultado, ou decodifique para arquivo |
| O resultado parece lixo aleatório | Os dados não são texto: são uma imagem, um PDF ou um arquivo compactado | Defina a saída como Arquivo e baixe |
| A imagem não aparece a partir de uma URI de dados | Falta o prefixo data:image/...;base64, ou há uma quebra de linha dentro dele | Ative a opção de URI de dados e deixe a quebra de linha desativada |
Lembre-se de que decodificar uma cadeia Base64 não torna legível um arquivo ilegível. Se o original era um ZIP ou uma foto, a decodificação devolve o ZIP ou a foto, não texto. A camada Base64 é apenas a embalagem.
Vale a pena usar Base64?
Use quando um canal só aceita texto e você precisa enviar dados binários por ele: ícones pequenos embutidos, um campo de uma API JSON, o corpo de um e-mail, um cabeçalho. Evite quando houver uma transferência de arquivo normal, porque os mesmos dados viajam 33% mais pesados e perdem as vantagens do cache e do streaming. Para escolher entre formatos de texto em geral, veja JSON, CSV ou XML, que explica onde cada um se encaixa.
Perguntas frequentes
O que é codificação Base64, em palavras simples?
É uma forma de escrever qualquer dado com apenas 64 caracteres comuns (letras, dígitos, + e /) para que ele passe por sistemas feitos para texto. Cada três bytes viram quatro caracteres, e o destinatário consegue reverter exatamente.
Como decodifico uma cadeia Base64?
Cole no decodificador Base64 e escolha se o resultado deve ser texto ou arquivo. Se ela começar com data:image/png;base64,, o prefixo é reconhecido e removido para você, e o tipo de arquivo correto é usado no download.
Como transformo uma imagem em Base64?
Solte a imagem no codificador e ative a opção de URI de dados. Você recebe uma cadeia que começa com data:image/...;base64, e pode colocá-la em uma tag img do HTML ou em um fundo CSS. Mantenha a imagem pequena, pois o Base64 acrescenta cerca de 33% ao tamanho dela.
Por que o Base64 é maior que o original?
Porque três bytes são escritos como quatro caracteres. Quatro dividido por três dá cerca de 1,33, então a saída fica uns um terço maior, um pouco mais com quebras de linha e preenchimento.
O Base64 é seguro ou criptografado?
Não. O Base64 não tem chave e qualquer pessoa o decodifica na hora. É uma mudança de formato, não uma proteção. Não o use para esconder senhas nem dados privados.
Qual é o limite gratuito da ferramenta Base64?
O plano grátis codifica ou decodifica um arquivo por vez, de até 25 MB. O Pro coloca até 100 arquivos em fila e os baixa em um único ZIP. O texto digitado é convertido ao vivo enquanto você escreve.