ZIP을 Base64로

ZIP을 Base64로 변환하는 방법

1. .zip 파일을 상자에 놓거나 파일 선택기로 고르세요.
2. 출력 형식은 일반 Base64로 시작합니다. 파일 이름, 유형, 크기를 함께 원하면 JSON을, 다운로드 링크가 필요하면 HTML <a download> 를 쓰세요.
3. 문자열을 MIME 이메일 본문에 넣는 경우가 아니면 76자에서 줄 바꿈은 꺼 두세요.
4. 출력 복사를 누르거나, 큰 아카이브는 .txt로 저장하세요.

먼저 압축하고, 그다음 인코딩

Base64는 무엇이든 약 3분의 1을 더합니다. 압축은 그 전에 텍스트, JSON, CSV, HTML, 로그를 줄여 주므로 순서가 중요합니다. 219,398바이트 JSON 파일, HTML 페이지, 스타일시트로 한 작은 테스트입니다.

이미지, 동영상, MP3, 기존 아카이브는 이미 압축되어 있어 거의 줄지 않지만, ZIP으로 묶으면 여러 파일을 필드 하나로 만들 수 있습니다. 텍스트 페이로드 하나라면 gzip이 더 가벼운 선택입니다. Gzip과 Base64를 참고하세요.

Base64 ZIP이 쓰이는 곳

• 배포와 자동화 API: 코드를 실행하거나 사이트를 호스팅하는 일부 서비스는 패키지 전체를 JSON 요청 안의 Base64 인코딩 ZIP으로 받습니다.
• 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는 전혀 압축하지 않습니다. 스트리밍과 줄 끝에 관해서는 Python에서 Base64를 참고하세요.

Base64 ZIP 확인하기

문자열이 UEsFBg로 시작하면 아카이브가 파일 없이 만들어진 것입니다. 빌드 스크립트의 경로가 틀렸을 때 흔히 생깁니다. Base64를 ZIP으로는 문자열을 디코딩해 안의 파일 목록을 보여 주므로, 아카이브에 기대한 내용이 들었는지 확인하는 가장 빠른 방법입니다.

자주 묻는 질문