Codificar / decodificar Base64 — texto ⇄ Base64

Codificar e decodificar Base64 online — rápido, correto e privado

O Base64 aparece em todo lugar quando você começa a trabalhar com desenvolvimento web, APIs ou e-mail. Cabeçalhos de autenticação, payloads JSON, data URLs, tokens JWT, arquivos de configuração e anexos de e-mail o usam. Mais cedo ou mais tarde você precisa transformar um texto em Base64 ou descobrir o que uma string longa como SGVsbG8sIFdvcmxkIQ== realmente diz. Este codificador e decodificador Base64 grátis faz as duas coisas, na hora, no seu navegador.

Ele acerta os detalhes que muitas ferramentas rápidas erram. O texto é convertido em UTF-8 antes da codificação, então hindi, tâmil, bengali, chinês e emojis sobrevivem à ida e volta sem mudança. Suporta Base64url seguro para URL em links e tokens, quebra MIME opcional de 76 caracteres para e-mail e uma decodificação que tolera espaços, quebras de linha e preenchimento faltando. Quando a entrada não é válida, ele diz exatamente o motivo em vez de mostrar lixo. Nada do que você cola é enviado a lugar nenhum.

Como usar a ferramenta

1. Escolha um sentido. Codificar → Base64 transforma texto em Base64. Decodificar Base64 → transforma Base64 de volta em texto.
2. Cole ou digite a sua entrada. Com Converter enquanto digito ativado, o resultado é atualizado ao vivo. Desative para entradas muito grandes e clique em Converter quando estiver pronto.
3. Escolha opções, se precisar. Marque Seguro para URL para strings que vão em URLs, nomes de arquivos ou JWTs. Marque Quebrar linhas em 76 caracteres apenas se um sistema esperar uma saída no estilo MIME.
4. Use o resultado. Copie-o, baixe-o como arquivo .txt ou clique em Trocar para usar a saída de volta como entrada — um jeito rápido de confirmar que a ida e volta é perfeita.

Como o Base64 funciona

Os computadores guardam dados como bytes, e um byte pode ter qualquer um de 256 valores. Muitos desses valores são caracteres de controle invisíveis ou têm significado especial em e-mails, URLs ou JSON. O Base64 resolve isso usando apenas 64 caracteres seguros quase em qualquer lugar: as 26 letras maiúsculas, 26 minúsculas, 10 dígitos e + e /.

O algoritmo pega três bytes (24 bits) por vez e os divide em quatro grupos de 6 bits. Cada grupo de 6 bits é um número de 0 a 63, que escolhe um caractere do alfabeto. Então cada 3 bytes de entrada viram 4 caracteres de saída — e por isso o Base64 é cerca de 33% maior que o original.

Quando o tamanho da entrada não é múltiplo de três, o último bloco é preenchido. Um byte sobrando produz dois caracteres mais ==; dois bytes sobrando produzem três caracteres mais =. Você pode ver isso com entradas bem curtas:

Por que o UTF-8 importa (hindi e emojis)

O Base64 codifica bytes, não letras. Antes de o texto ser codificado, ele precisa virar bytes, e a forma padrão é o UTF-8. Letras inglesas ocupam um byte cada, mas uma letra devanágari ocupa três e muitos emojis ocupam quatro. A palavra नमस्ते tem seis caracteres, mas 18 bytes UTF-8, então o Base64 dela é 4KSo4KSu4KS44KWN4KSk4KWH — 24 caracteres.

A função nativa btoa() do navegador só trata caracteres até o código 255, então ferramentas ingênuas dão erro com texto em hindi ou o corrompem em silêncio. Esta ferramenta codifica primeiro com TextEncoder e decodifica com um decodificador UTF-8 estrito, então todo idioma volta exatamente como entrou. Se os bytes decodificados não forem UTF-8 válidos, a ferramenta avisa em vez de mostrar símbolos quebrados.

Base64 padrão vs seguro para URL

Os caracteres +, / e = têm significados especiais em URLs: + pode virar um espaço, / separa segmentos de caminho e = separa chaves de valores na query. A variante segura para URL, chamada Base64url na RFC 4648, troca + por - e / por _ e geralmente omite o preenchimento. Por exemplo, o texto hello?> é aGVsbG8/Pg== em Base64 padrão e aGVsbG8_Pg em Base64url.

Os JSON Web Tokens usam Base64url em cada uma das três partes, assim como muitas chaves de API, URLs assinadas e parâmetros OAuth. Ao decodificar, você não precisa dizer à ferramenta qual variante tem — ela aceita as duas automaticamente e adiciona de volta qualquer preenchimento faltando.

Usos comuns do Base64

• Autenticação HTTP Basic. O cabeçalho Authorization: Basic … carrega username:password em Base64 — e por isso só deve ser usado por HTTPS.
• Data URLs. Pequenas imagens e fontes podem ser incorporadas direto em HTML ou CSS como data:image/png;base64,…. Use a nossa ferramenta de imagem Base64 para isso.
• Tokens JWT. O cabeçalho e o payload de um JWT são JSON codificado em Base64url. O nosso decodificador de JWT os decodifica e mostra o horário de expiração.
• Anexos de e-mail. O MIME codifica anexos em Base64 com linhas de 76 caracteres.
• APIs e arquivos de configuração. Valores binários, certificados e chaves muitas vezes são guardados como Base64 dentro de JSON, YAML ou variáveis de ambiente.

Base64 não é criptografia

Esta é a coisa mais importante de entender. O Base64 não tem chave nem segredo: é uma transformação pública e reversível, e qualquer pessoa a decodifica em um segundo com uma ferramenta como esta. Ele não dá nenhuma confidencialidade. Se você encontrar uma senha, chave de API ou dado pessoal «criptografado» em Base64, trate como texto simples. Para verificações de integridade, use um hash do nosso gerador de hash; para sigilo de verdade, use criptografia adequada com uma chave, gerenciada por uma biblioteca bem testada.

Decodificando Base64 à mão: um exemplo prático

Para ver que não há mágica, decodifique TWFu manualmente. No alfabeto Base64, T é 19, W é 22, F é 5 e u é 46. Escritos como binário de 6 bits, são 010011, 010110, 000101 e 101110. Juntos formam 24 bits: 01001101 01100001 01101110. Divididos em bytes, são 77, 97 e 110 — os códigos ASCII de M, a e n. Então TWFu se decodifica como «Man». A ferramenta faz exatamente isso, só que milhões de vezes mais rápido, e depois lê os bytes como UTF-8.

Base64 no código

Se você precisa do mesmo resultado dentro de um programa, a maioria das linguagens tem Base64 embutido. No JavaScript, os navegadores oferecem btoa() e atob(), mas eles trabalham com «strings binárias», então combine-os com TextEncoder e TextDecoder para texto Unicode — é isso que esta ferramenta faz. O Node.js usa Buffer.from(text).toString('base64') e 'base64url' para a forma segura para URL. O Python tem o módulo base64 com b64encode, b64decode e urlsafe_b64encode. No Linux e macOS, a ferramenta de linha de comando base64 codifica e decodifica arquivos. Todas seguem a RFC 4648, então a saída delas coincide com a desta ferramenta para a mesma entrada e opções — um jeito prático de conferir o que o seu código deveria produzir.

Quando não usar Base64

Como acrescenta um terço ao tamanho, o Base64 é uma má escolha para arquivos grandes. Incorporar imagens grandes como data URLs deixa o HTML e o CSS mais pesados e impede o navegador de guardá-las em cache separadamente, então reserve os data URLs para ícones pequenos. Enviar uploads grandes como Base64 dentro de JSON é mais lento que um upload de arquivo normal. E, como visto acima, nunca deve ser usado como medida de segurança. Use-o para o que ele faz bem: mover pequenas quantidades de dados binários com segurança por canais só de texto.

Uma dica relacionada: se uma string Base64 parecer suspeita — por exemplo em um e-mail de phishing ou em uma configuração estranha de extensão do navegador — decodificá-la aqui é seguro, porque a ferramenta só exibe o resultado como texto simples e nunca o executa ou abre. Isso a torna um primeiro passo útil quando você quer entender o que um dado codificado realmente contém.

Entendendo as mensagens de erro

• Caracteres inválidos. O Base64 só contém letras, dígitos, +, /, -, _ e =. Qualquer outra coisa — uma aspa solta, uma vírgula, uma letra não inglesa — significa que a string foi cortada ou copiada errado. Espaços e quebras de linha são ignorados automaticamente.
• Tamanho errado. Uma string Base64 válida, sem preenchimento, nunca pode ter um tamanho que deixe resto 1 quando dividido por 4. Isso geralmente significa que um caractere se perdeu na cópia.
• Não é texto UTF-8. A string foi decodificada normalmente, mas os bytes são um arquivo — muitas vezes uma imagem ou PDF — e não texto. Decodifique imagens com a ferramenta de imagem Base64.

Privacidade e desempenho

Desenvolvedores muitas vezes precisam decodificar tokens e valores de configuração que contêm informações sensíveis. Colá-los em um site qualquer é arriscado. Esta ferramenta roda inteiramente no seu navegador com funções nativas — não há processamento no servidor, registro nem upload. Ela processa a entrada em pedaços para textos grandes não estourarem o navegador e, depois que a página carrega, continua funcionando offline. Para codificar caracteres especiais em links, veja o nosso codificador de URL e, para entidades HTML, o codificador de HTML.

Codificar / decodificar Base64 — fatos principais

Perguntas frequentes

Conheça mais ferramentas da Prompt Minds

O Codificar / decodificar Base64 combina muito bem com as nossas outras ferramentas grátis. Toda ferramenta do Prompt Minds roda inteiramente no seu navegador — sem cadastro, sem uploads, sem marcas d'água. Veja todas as ferramentas grátis.