Conversor de archivo a Base64

¿Por qué codificar un archivo en Base64?

Muchos formatos que transportan datos entre sistemas solo admiten texto. JSON, XML, YAML, HTML y los encabezados de correo electrónico no pueden contener bytes arbitrarios, porque un archivo puede incluir bytes cero, secuencias de caracteres no válidas o finales de línea que un analizador de texto modificaría. Base64 convierte cada 3 bytes del archivo en 4 caracteres de un conjunto de 64 letras, dígitos, + y /, de modo que cualquier archivo puede viajar como una cadena de texto normal y decodificarse de nuevo exactamente en los mismos bytes.

El precio que se paga es el tamaño: el texto codificado ocupa aproximadamente un 33 % más que el archivo, y los saltos de línea añaden algo más. Un archivo de 3 MB se convierte en unos 4 MB de Base64.

Usos habituales

• API JSON y XML. Los endpoints que no aceptan subidas mediante formularios multipart suelen esperar el archivo como una cadena Base64 en un campo, con el nombre y el tipo en otros.
• Adjuntos de correo electrónico. MIME codifica los adjuntos en Base64 con líneas de 76 caracteres como máximo (RFC 2045). La opción Saltos de línea cada 76 caracteres produce el mismo formato.
• Configuración y secretos. Los valores bajo data en un Secret de Kubernetes están en Base64, así que un certificado TLS, un almacén de claves o un archivo de licencia debe codificarse antes de incluirlo en el manifiesto. Los sistemas de CI también suelen guardar secretos binarios en variables de entorno de la misma forma.
• Bases de datos y código fuente. Un binario pequeño, como una fuente, un sonido o un archivo de prueba, puede guardarse en una columna de texto o en una constante de cadena en lugar de en un archivo aparte.

Para imágenes, Imagen a Base64 añade redimensionado y fragmentos de HTML y CSS listos para usar. Para convertir Base64 de nuevo en un archivo, usa Base64 a archivo.

¿Base64 puro o data URI?

El Base64 puro contiene solo los bytes codificados. Es lo que esperan las API, Kubernetes, las bases de datos y la mayoría de las bibliotecas de programación, normalmente junto a un campo aparte para el nombre del archivo o el tipo de contenido.

Un data URI añade un prefijo con el tipo MIME, por ejemplo data:application/pdf;base64,, para que el navegador pueda usar la cadena completa como URL en src, href o en url() de CSS. No envíes ese prefijo a una API que pida Base64 sin más: muchos decodificadores lo rechazan. Para indicar tú mismo el tipo MIME o usar codificación porcentual, prueba el Generador de data URI.

Deja desactivados los saltos de línea para JSON, YAML y código fuente. Una cadena JSON no puede contener saltos de línea literales, y en YAML los valores divididos en varias líneas se rompen con facilidad.

Codificar un archivo desde la línea de comandos

# Linux (GNU coreutils): -w 0 desactiva el ajuste predeterminado a 76 caracteres
base64 -w 0 report.docx > report.txt

# macOS
base64 -i report.docx -o report.txt

# Windows PowerShell
[Convert]::ToBase64String([IO.File]::ReadAllBytes("C:\files\report.docx"))

# Kubernetes codifica el archivo por ti
kubectl create secret generic app-cert --from-file=tls.crt