Go를 쓰면 PDF가 나온다.

gpdf는 표준 라이브러리만으로 동작하는 Go PDF 라이브러리입니다. 12열 그리드로 페이지를 짜고, 한국어·일본어·중국어 폰트를 임베드하며, 한 페이지를 약 13 µs에 렌더링합니다.

$go get github.com/gpdf-dev/gpdf

동작 방식

invoice.go

doc := template.New(template.WithPageSize(document.A4))
page := doc.AddPage()

page.AutoRow(func(r *template.RowBuilder) {
    r.Col(6, func(c *template.ColBuilder) {
        c.Text("ACME Corporation", template.FontSize(24),
            template.Bold(), template.TextColor(navy))
    })
    r.Col(6, func(c *template.ColBuilder) {
        c.Text("INVOICE", template.FontSize(28),
            template.Bold(), template.AlignRight())
    })
})

page.AutoRow(func(r *template.RowBuilder) {
    r.Col(12, func(c *template.ColBuilder) {
        c.Table(header, items,
            template.ColumnWidths(40, 15, 20, 25),
            template.TableStripe(pdf.RGBHex(0xF5F5F5)),
        )
    })
})

data, err := doc.Generate()

invoice.pdfPDF 열기

gpdf로 생성한 청구서 PDF: 회사 헤더, 청구 대상, 줄무늬 품목 표, 합계

순수 Go, 그것뿐.

go.mod에는 Go 자체만 있습니다. cgo도, 헤드리스 브라우저도, 서비스 옆에 둘 네이티브 바이너리도 필요 없습니다.

익숙한 레이아웃.

행과 12열 그리드가 페이지에 흘러 들어갑니다. 표는 페이지를 넘어 나뉘고 글은 자동으로 줄바꿈됩니다.

어떤 문자든 임베드.

TrueType 폰트는 사용한 글리프만 서브셋으로 넣어, 한중일 문자가 어느 서버에서나 똑같이 보입니다.

벤치마크

요청 안에서 생성할 수 있는 속도.

같은 4개의 문서를 gpdf, go-pdf/fpdf, signintech/gopdf, maroto v2로 만들었습니다. 문서당 시간과 메모리, 낮을수록 좋습니다.

직접 실행하기 빠른 시작 읽기

단일 페이지

제목과 문단이 있는 A4 한 페이지

gpdf

13 µs

fpdf

132 µs

gopdf

423 µs

maroto v2

237 µs

10–33배 빠름시간

표 (4×10)

헤더 행이 있는 스타일 표

gpdf

108 µs

fpdf

241 µs

gopdf

835 µs

maroto v2

8,600 µs

2–80배 빠름시간

100페이지

같은 페이지를 100번 반복

gpdf

683 µs

fpdf

11,700 µs

gopdf

8,600 µs

maroto v2

19,800 µs

13–29배 빠름시간

복합 문서

제목, 표, 텍스트가 섞인 문서

gpdf

133 µs

fpdf

254 µs

gopdf

997 µs

maroto v2

10,400 µs

2–78배 빠름시간

단일 페이지 메모리

한 페이지를 만드는 동안 할당된 양

gpdf

16 KB

fpdf

1,200 KB

gopdf

1,800 KB

maroto v2

61 KB

메모리 4–113배 적음메모리

100페이지 메모리

100페이지를 만드는 동안 할당된 양

gpdf

909 KB

fpdf

121,000 KB

gopdf

83,000 KB

maroto v2

4,000 KB

메모리 4–133배 적음메모리

5회 실행의 중앙값, 각 100회 반복. Apple M1, Go 1.25. 벤치마크 코드는 gpdf 저장소에 있습니다.

벤치마크 코드 보기

Go 네이티브 아키텍처

Go로 만들었다. 따로 돌릴 것은 없다.

Go용 PDF 구성의 상당수는 언어 밖에 기댑니다. 사이드카의 헤드리스 브라우저, HTTP로 호출하는 HTML→PDF 서비스, 네이티브 라이브러리 바인딩. 모두 배포하고 패치하고 모니터링할 런타임이 하나 더 늘어납니다.

gpdf는 첫 줄부터 Go로 작성되었습니다. 여러분의 바이너리에 컴파일되어 Go가 도는 곳이면 어디서나 동작하고, 의존성 트리는 표준 라이브러리뿐이라 보안팀이 추가로 감사할 것이 없습니다.

go get 한 번, 바이너리 하나. 개발과 운영에서 같은 출력.

흔한 구성

여러분의 Go 앱

HTTP 호출 또는 cgo 바인딩

헤드리스 브라우저 · JVM · 네이티브 라이브러리

배포하고 패치하고 모니터링할 런타임이 또 하나.

gpdf

여러분의 Go 앱

go get

github.com/gpdf-dev/gpdf

바이너리 하나 · 표준 라이브러리만 · cgo 없음

실행 환경

LinuxmacOSWindowsDockerServerless

CJK 우선

한국어·일본어·중국어를 쓴 그대로.

많은 PDF 라이브러리가 CJK를 뒷전으로 둡니다. gpdf는 처음부터 CJK를 전제로 만들었습니다.

어떤 TrueType 폰트든 임베드할 수 있고, 파일에는 사용한 글리프만 기록됩니다.
한국어, 일본어, 중국어, 라틴 문자를 한 문단이나 표에 섞을 수 있습니다.
두부(□)도, 글자 깨짐도 없고, 서버에 설치된 폰트에 좌우되지 않습니다.

폰트 가이드 읽기

日本語 · 中文 · 한국어

레이아웃 그 이상.

보존, 보안, 후처리도 같은 모듈에 들어 있습니다. 그래도 의존성은 Go 표준 라이브러리뿐입니다.

PDF/A

XMP 메타데이터를 갖춘 PDF/A-1b·PDF/A-2b. 수십 년 동안 읽혀야 하는 문서에.

AES-256 암호화

소유자·사용자 비밀번호와 인쇄·복사·편집 권한 제어.

디지털 서명

완성된 PDF에 RFC 3161 타임스탬프가 있는 PKCS#7 서명을 적용합니다.

머리글과 바닥글

모든 페이지에 반복되는 머리글, 바닥글, 페이지 번호.

QR 코드와 바코드

QR과 Code 128을 네이티브로 생성하고 PNG·JPEG 이미지와 함께 배치합니다.

병합과 분할

Go 안에서 PDF를 합치거나 페이지 범위를 꺼냅니다.

그 밖에도…

기존 PDF에 오버레이를 찍고, 입력된 AcroForm 필드를 정적 콘텐츠로 평탄화합니다.

예제 둘러보기

gpdf와 다른 선택지

PDF 라이브러리 선택은 기능만으로 정해지지 않는다.

무엇을 배포하고, 무엇에 비용을 내고, 무엇을 계속 패치해야 하는가.

	gpdf	상용 Go SDK	HTML→PDF (헤드리스 브라우저)
라이선스	MIT, 상업적 사용 무료	유료 라이선스 또는 종량 키	오픈소스지만 브라우저는 직접 운영
의존성	Go 표준 라이브러리만	벤더 모듈	모든 이미지에 브라우저
배포	Go 바이너리 안에	Go 바이너리 + 라이선스 키	사이드카 또는 별도 서비스
CJK 텍스트	기본 지원, 서브셋 임베드	폰트 설정에 따라	이미지 안의 폰트에 따라
단일 페이지	약 13 µs	제품마다 다름	요청마다 브라우저 렌더링