ZIP в Base64

Как конвертировать ZIP в Base64

1. Перетащите файл .zip в поле или выберите его через диалог.
2. По умолчанию Формат вывода выдаёт Чистый Base64. Выберите JSON, если нужны ещё имя файла, тип и размер, или HTML <a download> для ссылки на скачивание.
3. Не включайте Перенос по 76, если строка не идёт в тело MIME-письма.
4. Нажмите Скопировать результат или, для больших архивов, Сохранить как .txt.

Сначала архив, потом кодирование

Base64 добавляет примерно треть к тому, что ему дают. Сжатие уменьшает текст, JSON, CSV, HTML и логи ещё до этого, поэтому порядок важен. Небольшой тест с JSON-файлом на 219 398 байт, HTML-страницей и таблицей стилей:

Картинки, видео, MP3 и готовые архивы уже сжаты и почти не уменьшаются, но упаковка в ZIP всё равно превращает много файлов в одно поле. Если текстовый файл всего один, проще взять gzip; см. Gzip и Base64.

Где используют ZIP в Base64

• API деплоя и автоматизации. Некоторые сервисы, которые запускают код или хостят сайты, принимают весь пакет как ZIP в Base64 внутри JSON-запроса.
• CI и хранилища секретов. Папку с сертификатами или конфигами можно запаковать и хранить как один секрет в Base64, а в пайплайне восстановить через base64 -d.
• Массовая выгрузка и вложения. Набор отчётов или счетов уходит одним запросом, без отдельного поля на каждый файл.

Сборка ZIP в коде

Python может создать архив в памяти и закодировать его без временного файла:

import base64, io, zipfile
from pathlib import Path

buf = io.BytesIO()
with zipfile.ZipFile(buf, "w", zipfile.ZIP_DEFLATED) as z:
    for path in Path("site").rglob("*"):
        if path.is_file():
            z.write(path, path.relative_to("site"))

package = base64.b64encode(buf.getvalue()).decode("ascii")

ZIP_DEFLATED важен: режим по умолчанию ZIP_STORED вообще не сжимает. О потоковой обработке и окончаниях строк написано в статье Base64 в Python.

Проверка ZIP в Base64

Если строка начинается с UEsFBg, архив создан без файлов; так часто бывает при неверном пути в скрипте сборки. Base64 в ZIP декодирует строку и показывает список файлов внутри: так быстрее всего убедиться, что в архиве лежит то, что вы ожидаете.

Вопросы и ответы