우리가 Cloudflare 위에서 개발하는 이유

한눈에 보기

nextpdf/cloudflare 패키지를 사용하면 NextPDF가 엣지에서 PDF를 렌더링하고, 생성된 파일을 R2에 보관하며, API 요청이 워커에 닿기 전에 걸러 낼 수 있습니다. 이 섹션의 다른 페이지들은 그 방법을 정확히 설명합니다. 이 페이지는 조금 다릅니다. 우리가 애초에 이걸 만들면서 왜 그렇게 설렜는지에 대한 짧고 솔직한 이야기, 그리고 감사의 글입니다.

Cloudflare를 택한 이유

그냥 솔직하게 말하겠습니다. NextPDF 팀은 Cloudflare 위에서 개발하기를 좋아합니다. 기꺼이 손이 가는 플랫폼이고, 진심으로 넉넉한 무료 플랜이 그 이유의 큰 부분을 차지합니다. 그 넉넉함은 우리에게 부수적인 것이 아닙니다. 바로 그 덕분에 작은 팀이 오픈 소스 커뮤니티에 평소보다 더 많은 것을 돌려줄 수 있습니다. 엔진을 더 많이 공개하고, 모두에게 도움이 되는 부분에 더 많은 시간을 쓰고, 프로젝트의 이로움보다 인프라 비용에 좌우되는 결정을 줄일 수 있습니다. 플랫폼이 그렇게 문턱을 낮춰 주면, 그 위에서 하는 일은 더 야심 차질 수 있습니다.

무엇이 가능해지는가

이 부분은 정말 들려드리고 싶습니다. 새로운 문을 열어 준다고 생각하기 때문입니다. NextPDF를 Cloudflare 위에서 쓰면, PHP 애플리케이션은 HTML을 들고 있고 Cloudflare Worker는 헤드리스 브라우저를 들고 있습니다. 브리지가 마크업을 내보내고 렌더링된 PDF 바이트를 되받아 오기 때문에, 헤드리스 Chromium을 PHP 프로세스 안에서 돌릴 필요가 전혀 없습니다. 여기서부터 생성된 파일을 R2에 보관하고 서명된 URL을 돌려주며, 들어오는 API 요청을 워커에 닿기도 전에 패키지 수준에서 걸러 낼 수 있습니다.

한 가지 일에 집중해 그 일을 잘 해내는 작은 패키지이고, 우리는 이를 정성껏 만들었습니다. 그런데 우리가 이걸 얼른 여러분 손에 쥐여 드리고 싶었던 이유는 코드가 아닙니다. 그 뒤에 있는 질문입니다. 이렇게 강력한 PDF 엔진이 이렇게 강력한 플랫폼을 만났을 때, 사람들은 얼마나 더 깊고, 더 넓고, 더 흥미로운 것을 만들어 낼까요? 우리는 그 전부를 상상해 냈다고 생각하지 않습니다. 오히려 그게 핵심입니다. 개요나 빠른 시작에서 출발해, 어디까지 이어지는지 직접 확인해 보세요.

정성껏 만들었습니다

HTML을 프로세스 밖으로 내보내 다른 곳에서 렌더링하는 것은 신뢰 경계이고, 우리는 그것을 신뢰 경계답게 다뤘습니다. 브리지는 무언가를 보내기 전에 요청이 어디로 갈 수 있는지 먼저 검증하는데, 이는 서버 측 요청 위조에 관한 OWASP 지침의 정신을 따른 것입니다. 그리고 전송 계층은 예상하는 정확한 공개 키를 고정할 수 있습니다(RFC 7469). URL 검증, 크기 제한, 키 고정, R2 제어 같은 세부 사항은 Cloudflare 보안 및 운영에 담겨 있습니다.

고맙습니다, Cloudflare

그러니 간단히 전합니다. 고맙습니다. 넉넉한 무료 플랜과 믿을 수 있는 플랫폼 덕분에 우리는 NextPDF를 오픈 상태로 유지하기가 더 쉬워졌고, 이 글을 읽는 개발자들은 청구서가 먼저 결정해 버리는 일 없이 야심 찬 시도를 해 보기가 더 쉬워졌습니다.

이 문서 사이트 자체도 Cloudflare 위에서 제공되고 있습니다. 그러니 지금 이 글을 읽고 계신다면, 그 실제 모습을 직접 보고 계신 것입니다.

함께 보기

NextPDF Cloudflare — 섹션 전체.
개요 — 브리지가 하는 일과 그 경계.
빠른 시작 — 엣지에서 렌더링한 첫 PDF.
Cloudflare 보안 및 운영 — 신뢰 경계에 대한 자세한 설명.

Cloudflare 및 Cloudflare Workers와 R2 같은 관련 제품 이름은 Cloudflare, Inc.의 상표이며, 여기서는 NextPDF가 이 플랫폼과 어떻게 연동되는지 설명하기 위해서만 사용되었습니다. NextPDF는 Cloudflare, Inc.와 어떠한 기업적 제휴 관계도 없는 독립 프로젝트이며, Cloudflare의 보증이나 후원을 받지 않습니다.