Gotenberg
Docker 기반 문서-PDF 변환 API로, 한 줄의 명령어로 시작할 수 있으며 HTML, Office, Markdown 등 다양한 형식을 지원합니다.
스마트 다운로드
프로젝트 홈페이지 방문
아직 설치 프로그램이 없습니다 — 소스 저장소로 이동하세요
Docker로 한 번에 실행하는 문서-PDF 변환 필수 도구, 복잡하게 환경을 설정할 필요가 없습니다.
주요 기능
- HTML, URL, Markdown을 PDF로 변환 지원 (Chromium 기반)
- Office 문서(Word/Excel/PPT 등 100+ 형식)를 PDF로 변환 지원 (LibreOffice 기반)
- PDF 편집: 병합, 분할, 회전, 평탄화
- PDF 보안: 워터마크, 스탬프, 암호화
- PDF 규정 준수: PDF/A, PDF/UA
할 수 없는 것
- •수백 페이지에 달하는 Office 문서와 같은 대용량 파일을 변환할 때는 Docker 컨테이너에 충분한 메모리가 있는지 확인해야 합니다(최소 2GB 권장). 그렇지 않으면 OOM이 발생할 수 있습니다.
- •기본적으로 0.0.0.0:3000에서 수신 대기하므로 프로덕션 환경에서는 방화벽 또는 리버스 프록시를 구성하는 것이 좋습니다.
- •LibreOffice는 중국어로 조판된 복잡한 문서(특수 글꼴, 텍스트 상자 등)의 복원도가 네이티브 Office보다 낮을 수 있으므로 테스트가 필요합니다.
- •버전을 적시에 업그레이드하는 데 주의하세요. 이전 버전에는 보안 취약점이 존재할 수 있습니다.
사용 사례
- 송장, 보고서, 계약서 PDF 자동 생성
- 온라인 문서 미리보기 시스템(브라우저에서 볼 수 있도록 Office를 PDF로 변환)
- 웹 페이지 스냅샷 및 아카이빙
- PDF 병합 및 분할 일괄 처리
- PDF/A 아카이빙 규정 준수가 필요한 시나리오
Gotenberg는 다양한 문서를 PDF로 변환하는 Docker 기반 API 서비스입니다. HTTP를 통해 파일(HTML, URL, Markdown 또는 Office 문서)을 전송하기만 하면 PDF 결과를 받을 수 있습니다. 내부적으로는 Headless Chromium으로 웹 페이지와 Markdown을 렌더링하고, LibreOffice로 100개 이상의 오피스 문서 형식(Word, Excel, PPT 등)을 처리합니다. 변환 외에도 PDF 병합, 분할, 회전, 워터마크 추가, 스탬프 추가, 암호화, PDF/A 및 PDF/UA 규정 준수를 지원합니다. 웹 페이지 스크린샷 캡처도 가능합니다. Chromium, LibreOffice 또는 글꼴을 수동으로 설치하거나 관리할 필요가 없으며, Docker 컨테이너를 실행하기만 하면 API를 호출할 수 있습니다. 현재 수천 개의 기업이 프로덕션 환경에서 사용하고 있으며, 많은 유명 오픈 소스 프로젝트에서도 사용하고 있습니다.
태그
시작하기
소프트웨어 설치
다운로드한 설치 프로그램을 더블 클릭하고 안내에 따르세요
1단계: Docker가 설치되어 있는지 확인하고 다음 명령어를 실행하세요: docker run --rm -p 3000:3000 gotenberg/gotenberg:8
2단계: URL을 PDF로 변환: curl --request POST http://localhost:3000/forms/chromium/convert/url --form url=https://당신의웹페이지.com -o output.pdf
3단계: 로컬 HTML 파일을 PDF로 변환: curl --request POST http://localhost:3000/forms/chromium/convert/html --form files=@yourfile.html -o output.pdf
- 1단계: Docker가 설치되어 있는지 확인하고 다음 명령어를 실행하세요: docker run --rm -p 3000:3000 gotenberg/gotenberg:8
- 2단계: URL을 PDF로 변환: curl --request POST http://localhost:3000/forms/chromium/convert/url --form url=https://당신의웹페이지.com -o output.pdf
- 3단계: 로컬 HTML 파일을 PDF로 변환: curl --request POST http://localhost:3000/forms/chromium/convert/html --form files=@yourfile.html -o output.pdf
체크섬 없음
이 프로젝트는 GitHub Release 페이지에 SHA-256 체크섬을 게시하지 않았습니다
SHA256 체크섬
체크섬 없음
GitHub Releases에서 직접 다운로드하고 파일 무결성을 직접 확인하세요
이 플랫폼의 모든 SHA-256 체크섬은 프로젝트의 공식 GitHub Release 페이지에서 추출되었으며, 어떠한 변경도 없습니다. GitHub Releases 페이지에서 직접 검증할 수 있습니다.
오픈소스 투명성
GitHub 소스 보기제거 정보
Docker 컨테이너를 삭제하면 됩니다: docker rm $(docker ps -a | grep gotenberg | awk '{print $1}'), 이미지가 더 이상 필요하지 않은 경우 docker rmi gotenberg/gotenberg:8을 실행할 수 있습니다
추가 의존성 없음
다운로드 후 바로 사용 가능. 추가 런타임이 필요하지 않습니다.
문제 발생? 아래 FAQ 확인
5 FAQs
유사한 프로젝트
Visual Studio Code (Code - OSS)
Microsoft가 만든 무료 오픈 소스 코드 편집기로, 지능형 자동 완성, 디버깅, Git 및 확장 기능을 지원하는 전 세계에서 가장 인기 있는 편집기입니다.
opencode
오픈소스 AI 코딩 에이전트로, 코드 작성, 리팩토링 및 분석을 지원하며, '빌드(Build)'와 '플랜(Plan)' 이중 에이전트 모드가 내장되어 있습니다.
scrcpy
USB 또는 무선 TCP/IP를 통해 컴퓨터에서 Android 기기로 화면 미러링 및 제어를 지원하며, 루팅 불필요, 고성능 저지연, 오디오 전달 지원.