IA no seu dispositivo — profissional e privado.

Documentos

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.

EtapaValor
TextoM, a, n
Bytes (decimal)77, 97, 110
Bits, unidos01001101 01100001 01101110
Reagrupados em 6 bits010011 010110 000101 101110
Números19, 22, 5, 46
Caracteres Base64T, 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 originalTamanho em Base64 (aprox.)A mais
3 KB4 KB+1 KB
100 KB133 KB+33 KB
1 MB1,33 MB+0,33 MB
10 MB13,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á ==.

EntradaBytesBase64Preenchimento
Man3TWFunenhum
Ma2TWE=um =
M1TQ==dois ==
Hello5SGVsbG8=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

1

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.

2

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.

3

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.

4

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.

5

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 Base64

Base64 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ãoSeguro para URL
Caractere 62+-
Caractere 63/_
Preenchimento= mantidonormalmente omitido
Uso típicoE-mail, PEM, URIs de dadosTokens, 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ávelSolução
Erro de comprimento ou de preenchimentoFalta ou sobra um = no final, ou a cadeia foi cortadaCopie a cadeia inteira de novo; restaure o preenchimento
Caractere desconhecidoUm espaço, aspa ou quebra de linha colado junto, ou texto seguro para URL lido como padrãoDeixe o alfabeto em Detectar; retire as aspas sobrando
Pontos de interrogação ou símbolos estranhosOs bytes não são texto UTF-8Mude a codificação de texto do resultado, ou decodifique para arquivo
O resultado parece lixo aleatórioOs dados não são texto: são uma imagem, um PDF ou um arquivo compactadoDefina a saída como Arquivo e baixe
A imagem não aparece a partir de uma URI de dadosFalta o prefixo data:image/...;base64, ou há uma quebra de linha dentro deleAtive 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.

Continue lendo

Mais sobre Documentos →