중국에서 Gatsby 사이트를 배포하는 방법: 국내 전송과 ICP 비안

Gatsby 사이트 배포는 한 번 해 보고 나면 팀들이 가장 적게 걱정하는 부분입니다: Gatsby는 귀사 프로젝트를 정적 파일로 컴파일하고, 정적 파일은 거의 어디로든 갑니다. 그 사이트가 중국 본토를 서비스할 수 있는지 실제로 결정하는 것은 빌드 명령어가 아니라 — 배포를 어디로 향하게 하는가입니다. 그 파일들이 본토 안에서 서비스되는 순간, 두 관문이 동시에 열리며, 그것이 진짜 작업입니다. 이 가이드는 실무 단계를 유지하되, 어떤 배포 설정보다 오래가는 질문에 그것을 정박시킵니다: 그 사이트는 중국에서 운영할 자격을 갖췄는가, 그리고 그것은 중국 안에서 전송되는가?

솔직한 출발점이 여기 있고, 모처럼 좋은 소식입니다. Gatsby는 호스팅 플랫폼이 아니라 정적 사이트 생성기입니다 — 부족할 “Gatsby region”도, 이전할 계정도 없습니다. 빌드 출력물은 평범한 정적 콘텐츠이며, 바로 그래서 Gatsby 사이트는 호스팅 전용 서비스가 할 수 없는 방식으로 중국 본토 안의 인프라에서 돌아갈 수 있습니다. 그 자유에서 따라오는 것은 책임입니다: 본토 호스트에 대한 ICP 비안, 국경 통과를 없애는 국내 전송, 그리고 귀사 페이지가 수집하는 무엇에 대해서든 PIPL 점검. 아래는 Gatsby 자신의 출력물 설명, 본토 호스트 자신의 비안 규칙, 그리고 각 관문이 촉발하는 법이며, 법률 자문에 가져갈 수 있도록 했습니다.

한눈에 보는 중국에서의 Gatsby

”Gatsby 배포”란 실제로 무엇인가

모든 Gatsby 배포는 하나의 명령어와 하나의 폴더로 귀결됩니다. gatsby build를 실행하면 귀사 프로젝트가 — Gatsby의 표현으로 “the output is static content: HTML, CSS, JavaScript, images, etc.” — public/ 디렉터리로 컴파일되고, 배포란 그 폴더의 내용을 웹 호스트에서 서비스하는 것에 지나지 않습니다. 전형적인 정적 사이트 구성은 어디서 돌아가든 똑같아 보입니다:

그중 어느 것도 특정 플랫폼에 묶이지 않기 때문에, 명령줄이 결코 묻지 않는 한 가지 결정이 가장 중요합니다: 어느 호스트가 public/을 서비스하는가. 그것을 역외 호스트로 향하게 하면 단지 국경 너머 중국에서 닿기만 하는 글로벌 사이트가 되고. 그것을 본토 안의 호스트로 향하게 하면 국내 사이트 — 그리고 같은 획으로 ICP 의무 — 가 됩니다. 프레임워크가 아니라 그 하나의 선택이 이 글이 실제로 다루는 것입니다.

관문 1: 본토 안에서의 전송

중국 본토 밖에서 서비스되는 Gatsby 빌드는 고장 난 것이 아닙니다; 단지 혼잡하고 필터링된 국경의 저편에 있을 뿐입니다. 팀들이 보고하는 증상은 깔끔한 실패가 아니라 — 비일관성입니다. 같은 페이지가 아침엔 빠르고 저녁엔 불안정하며, 빌드가 끌어오는 자산(웹 폰트, 임베드된 영상, 서드파티 스크립트)이 각자의 일정으로 실패합니다. 콘텐츠 전송 계층은 그 거점이 진정으로 본토 안에 있을 때만 여기서 도움이 됩니다; 홍콩과 싱가포르는 지도상 가까워 보이지만 통과의 잘못된 쪽에 있습니다. 빌드를 중국 본토 안에서 전송하는 것이 그 국경 왕복을 없앱니다. 그것이 관문 1이고, 그것만 떼어 놓으면 성능 질문입니다 — 그러나 혼자 있지 않습니다, 그것을 고치는 행위가 다음 관문도 열기 때문입니다.

관문 2: 이제 호스트가 필요로 하는 ICP 비안

귀사의 public/ 폴더가 본토 안의 서버에서 서비스되는 순간, 허가 의무가 그 호스트에 붙습니다. 한 본토 제공자는 모호함 없이 진술합니다: “resolving to servers in the Chinese mainland” 도메인은 “must obtain an ICP filing before providing services,”이며, 비안 없는 도메인은 비안이 완료될 때까지 네트워크에서 차단됩니다. ICP 비안(备案)은, 국무원령 제292호와 공업정보화부령 제33호에 따라, 허가받은 본토 호스팅 자원과 본토 법인에 묶입니다 — 바로 그래서 외국 회사는 보통 자기 이름으로 비안할 수 없고, “we will just put the files on a Chinese server”가 기술적 과제만큼이나 회사 구조의 과제로 드러나는 이유입니다. 그 구체적 절차는 중국 ICP 라이선스가 무엇이며 어떻게 받는가를 보십시오.

호스트를 고르기 전에 체득할 가치가 있는 부분이 이것입니다: 관문 1을 고치는 움직임이 관문 2를 여는 움직임입니다. 국내 전송은 국경 통과를 없애고, 그 동일한 단계에서 비안을 의무로 만듭니다. 국내 전송을 얻으면서 비안을 비켜 가게 해 주는 구성은 없습니다 — 속도와 라이선스는 같은 거래에서 함께 획득되거나, 아니면 둘 다 아닙니다.

PIPL 질문 — 귀사 페이지가 수집하는 만큼만 크다

정적 사이트가 데이터가 많은 애플리케이션과 진정으로 다른 지점이 여기이며, 부풀리기보다 솔직할 가치가 있습니다. 아무것도 수집하지 않는 브로슈어형 Gatsby 빌드는 개인정보 노출이 적으므로, 많은 정적 사이트에게 ICP 비안과 국내 전송이 컴플라이언스 이야기의 전부입니다. 페이지가 본토 방문자에 대한 데이터를 포착하기 시작하는 순간 그림이 바뀝니다. 문의 폼, 뉴스레터 가입, 댓글 위젯, 애널리틱스 비컨 — 각각이 개인정보를 수집할 수 있고, 방문자의 실제 IP 주소는 그 자체로 개인정보에 해당합니다. 그중 무엇이든 본토 밖의 엔드포인트로 보내는 것은 PIPL이 규율하는 개인정보의 국경 간 이전입니다(제38~43조: 고지, 별도 동의, 그리고 허용되는 이전 메커니즘 하나). 솔직한 경험칙은 PIPL 노력을 귀사 Gatsby 페이지가 실제로 수집하는 것에 비례시키되, ICP 비안과 국내 전송은 어느 쪽이든 기본선으로 유지하는 것입니다.

이는 계획을 위한 리스크 지도이지 법적 판정이 아닙니다: 어느 관문이 먼저 구속하는지, 그리고 PIPL이 얼마나 미치는지는 귀사의 법인, 호스트, 그리고 페이지가 포착하는 데이터에 달려 있으며 — 모두 출시 전에 법률 자문과 함께 정리할 가치가 있습니다.

21YunBox가 들어맞는 곳 — 마이그레이션이 아니라 규정에 맞는 오버레이

귀사는 오늘과 똑같이 Gatsby로 계속 빌드하고 배포합니다 — 같은 gatsby build, 같은 public/ 출력물, 같은 워크플로. 21YunBox가 더하는 것은 빌드 도구가 구조상 혼자 공급할 수 없는 단 하나의 조각입니다: 본토 내부로부터의 ICP 비안 전송을, 귀사가 이미 운영하는 오리진 앞단에 둡니다 — 재구축도, 두 번째 코드베이스도, 귀사가 이미 운영하는 스택을 떠나는 일도 없이. 귀사의 Gatsby 빌드는 원본으로 남습니다; 저희 중국 팀은 어떤 의무가 귀사의 법인과 페이지가 수집하는 데이터에 적용되는지 지도화하고, 국내 호스팅 자원에 대한 ICP 비안을 처리하며, 본토 대상을 서비스하는 규정에 맞는 국내 전송을 세웁니다. 프레임워크는 결코 어려운 부분이 아니었습니다 — 운영할 라이선스, 그리고 그 라이선스가 허락하는 전송이 어려운 부분이며, 그것이 바로 저희가 쥐는 절반입니다.

컴플라이언스 진단 받기 →

함께 읽기:

• 중국 ICP 라이선스란 무엇이며, 어떻게 받나요?
• PIPL상의 국경 간 데이터 이전