¿Funciona Gatsby en China continental?

Sí; pero «Gatsby» nunca fue lo que tiene que funcionar en China. Gatsby solo produce archivos estáticos, y estos pueden funcionar desde dentro del continente, que es precisamente lo que hace entrar al proyecto en el régimen del registro ICP.

En las propias palabras de Gatsby, "When you build your Gatsby application, the output is static content: HTML, CSS, JavaScript, images, etc.," y ese contenido es "incredibly easy and affordable to host with any provider." La cuestión de cumplimiento está en esas últimas palabras: en cuanto "any provider" es un alojamiento dentro del continente, se aplica la propia norma de un proveedor del continente: un dominio que, "resolving to servers in the Chinese mainland," "must obtain an ICP filing before providing services" (Decreto n.º 292 del Consejo de Estado; Decreto n.º 33 del MIIT). Si, en cambio, sirve la misma compilación desde el extranjero, cada visitante del continente sigue cruzando la frontera filtrada; y si alguna de sus páginas incluye un formulario, un cuadro de comentarios o una analítica que capture datos de un visitante, enviarlos fuera del continente constituye además una transferencia transfronteriza según la PIPL. La tabla siguiente recoge la formulación de Gatsby, la norma de un proveedor de alojamiento del continente y la ley que activa cada puerta.

Esto es un mapa de riesgos, no un veredicto: qué puerta surte efecto primero depende de dónde aloje y de qué datos capturen sus páginas. Nuestro equipo de China puede cartografiar su exposición con usted →

Instantánea de cumplimiento

  • ✓ Gatsby solo produce archivos estáticos: no hay nada que reconstruir y la misma compilación puede funcionar en un alojamiento del continente
  • ✕ Servido desde fuera del continente, un sitio Gatsby no puede sostener un registro ICP
  • ! Alojar la compilación dentro del continente activa un registro ICP vinculado a una entidad jurídica del continente
  • ! La entrega dentro del país y el registro ICP son una sola decisión, no dos: la vía rápida es la vía registrada
  • ! Añada un formulario, un cuadro de comentarios o una analítica que capture datos de visitantes, y la PIPL se aplica en la frontera
Obtener una evaluación de cumplimiento
Cartografiamos las dos puertas para su compilación; no se necesita una entidad en China para empezar

Lo que realmente determina si un sitio Gatsby es conforme en China continental

HechoFuente primaria
Gatsby es una herramienta de compilación, no un alojamiento, así que no hay nada que «portar» a China. En las propias palabras de Gatsby, "When you build your Gatsby application, the output is static content: HTML, CSS, JavaScript, images, etc.," y ese contenido es "incredibly easy and affordable to host with any provider." Nada en la compilación está ligado a una plataforma extranjera, de modo que los mismos archivos pueden servirse desde un alojamiento dentro de China continental. «¿Funciona Gatsby en China?» es en realidad «¿en qué alojamiento despliega la compilación?», y ahí es donde empieza el cumplimiento. Gatsby — Deploying and Hosting (documentación de v2.gatsbyjs.com), consultado el 2026-10-07
Alojar la compilación dentro del continente es el acto que activa el registro ICP. Un proveedor de alojamiento del continente formula la norma sin ambigüedad: los servicios "with domain names resolving to servers in the Chinese mainland" "must obtain an ICP filing before providing services," y "ICP filing applies only to servers located in the Chinese mainland." Se trata del régimen del registro ICP (备案) conforme al Decreto n.º 292 del Consejo de Estado y al Decreto n.º 33 del MIIT: un registro que se vincula a un recurso de alojamiento autorizado en el continente y a una entidad jurídica del continente, y que una empresa extranjera no puede tener a su propio nombre. Alibaba Cloud — What is an ICP filing? (alibabacloud.com), consultado el 2026-10-07; Decreto n.º 292 del Consejo de Estado; Decreto n.º 33 del MIIT
Sin registro no hay servicio, aunque los archivos estén físicamente dentro del país. Para un dominio que apunta a un servidor del continente sin haber completado el registro, el mismo proveedor advierte que "the Alibaba Cloud monitoring system blocks access to the domain name and prompts you to complete the filing process." Esa es la interdependencia en torno a la cual hay que planificar: trasladar la entrega al interior del país elimina el cruce de frontera y, con el mismo gesto, hace que el registro deje de ser opcional; la velocidad que gana y el registro que asume son una sola decisión. Alibaba Cloud — What is an ICP filing? (alibabacloud.com), consultado el 2026-10-07
Un sitio estático apenas maneja datos personales, hasta que una página empieza a recogerlos. Una compilación de Gatsby de tipo folleto que no captura nada mantiene baja la exposición a la PIPL, y esa es la razón honesta por la que el ICP y la entrega dentro del país —no el derecho de transferencia de datos— suelen ser aquí la puerta dominante. Pero añada un formulario de contacto, un cuadro de comentarios o una etiqueta de analítica que capture los datos personales de un visitante del continente (incluida su dirección IP real) y los envíe a un punto final en el extranjero, y se tratará de una transferencia transfronteriza de datos personales regulada por la PIPL (capítulo III, artículos 38 a 43: información, consentimiento separado y un mecanismo de transferencia autorizado). La exposición a la PIPL crece con lo que sus páginas recogen realmente. PIPL, capítulo III, artículos 38 a 43

Fuentes verificadas por el Equipo de Cumplimiento de 21YunBox el 7 de octubre de 2026.

Desplegar un sitio Gatsby es lo que menos preocupa a los equipos una vez que lo han hecho por primera vez: Gatsby compila su proyecto en archivos estáticos, y los archivos estáticos pueden ir casi a cualquier parte. Lo que realmente decide si ese sitio puede atender a China continental no es el comando de compilación, sino el lugar al que apunta el despliegue. En el momento en que esos archivos se sirven desde dentro del continente, se abren dos puertas a la vez, y son ellas el verdadero trabajo. Esta guía conserva los pasos prácticos, pero los ancla a la pregunta que sobrevive a cualquier configuración de despliegue: ¿está el sitio autorizado para operar en China y se entrega desde dentro?

Este es el punto de partida honesto, y por una vez es una buena noticia. Gatsby es un generador de sitios estáticos, no una plataforma alojada: no hay ninguna «región de Gatsby» que pueda faltar ni ninguna cuenta que migrar. La salida de la compilación es contenido estático corriente, y precisamente por eso un sitio Gatsby puede funcionar desde infraestructura situada dentro de China continental de un modo que un servicio exclusivamente alojado no puede. De esa libertad se deriva una responsabilidad: un registro ICP sobre el alojamiento en el continente, una entrega dentro del país que elimine el cruce de frontera y una verificación de la PIPL sobre todo lo que recojan sus páginas. A continuación encontrará la propia descripción que hace Gatsby de su salida, la norma de registro que aplica un proveedor de alojamiento del continente y la ley que activa cada puerta, para que pueda llevarlo a su asesor jurídico.

La propia documentación «What is an ICP filing?» de Alibaba Cloud, que indica que los sitios web, aplicaciones y otros servicios cuyos nombres de dominio se resuelven a servidores en China continental deben obtener un registro ICP antes de prestar servicios, y que el registro ICP solo se aplica a servidores situados en China continental
La propia documentación sobre ICP de un proveedor de alojamiento del continente: los servicios “with domain names resolving to servers in the Chinese mainland” (cuyos dominios se resuelven a servidores en China continental) “must obtain an ICP filing before providing services,” (deben obtener un registro ICP antes de prestar servicios) y “ICP filing applies only to servers located in the Chinese mainland.” (el registro ICP solo se aplica a servidores situados en China continental). La exigencia sigue a la ubicación del servidor, que es exactamente lo que crea alojar una compilación de Gatsby dentro del país. Fuente: Alibaba Cloud — What is an ICP filing?

Gatsby en China de un vistazo

Qué lo determina En sus propios términos — y según la ley china
Qué es Gatsby Un generador de sitios estáticos, no un alojamiento. En palabras de Gatsby, la salida de la compilación es “static content: HTML, CSS, JavaScript, images, etc.,” y resulta “incredibly easy and affordable to host with any provider.” No hay ninguna plataforma que abandonar ni ninguna región del continente que pueda faltar: la misma compilación puede funcionar dentro del país.
Puerta 1 — la entrega dentro del país Si sirve esa compilación desde el extranjero, cada solicitud del continente cruza una frontera congestionada y filtrada. Alojarla dentro del continente elimina ese cruce. Es la mitad de «rendimiento» de la pregunta, y no permanece sola por mucho tiempo.
Puerta 2 — el registro ICP Un dominio “resolving to servers in the Chinese mainland” “must obtain an ICP filing before providing services” (Decreto n.º 292 del Consejo de Estado; Decreto n.º 33 del MIIT). El registro se vincula al alojamiento autorizado en el continente y a una entidad jurídica del continente.
Por qué son una sola decisión La entrega dentro del país es el mismo acto que activa el registro, de modo que la decisión sobre la velocidad y la decisión sobre la autorización son una sola, no dos. No se puede alojar dentro del continente para ganar velocidad y quedar fuera del régimen de registro.
Datos de los visitantes (PIPL) Una página puramente estática recoge poco. Añada un formulario, un cuadro de comentarios o una analítica que capture datos de un visitante y los envíe al extranjero, y se aplican las normas transfronterizas de la PIPL (artículos 38 a 43). La exposición varía con lo que las páginas recogen realmente.
El diseño que funciona Siga construyendo con Gatsby y añada una entrega con registro ICP dentro del país delante de su origen. Una capa, no una migración: sin reconstrucción y sin una segunda base de código.

Qué significa realmente «desplegar Gatsby»

Todo despliegue de Gatsby se reduce a un comando y una carpeta. Ejecutar gatsby build compila su proyecto —en las propias palabras de Gatsby, “the output is static content: HTML, CSS, JavaScript, images, etc.”— en un directorio public/, y desplegar no es más que servir el contenido de esa carpeta desde un alojamiento web. Una configuración típica de sitio estático tiene el mismo aspecto se ejecute donde se ejecute:

Parámetro Valor
Comando de compilación gatsby build (o yarn && yarn build)
Directorio de publicación public/
Salida de la compilación HTML, CSS, JavaScript e imágenes estáticos, que cualquier alojamiento puede servir

Como nada de esto está ligado a una plataforma concreta, la única decisión que la línea de comandos nunca le plantea es la que más importa: qué alojamiento sirve public/. Si lo apunta a un alojamiento en el extranjero, tendrá un sitio global que simplemente resulta accesible desde China al otro lado de la frontera. Si lo apunta a un alojamiento dentro del continente, tendrá un sitio dentro del país y, con el mismo gesto, una obligación de ICP. Esa elección, y no el framework, es de lo que realmente trata este artículo.

Puerta 1: la entrega desde dentro del continente

Una compilación de Gatsby servida desde fuera de China continental no está rota; simplemente se encuentra en el lado equivocado de una frontera congestionada y filtrada. El síntoma que describen los equipos rara vez es un fallo claro: es la irregularidad. La misma página va rápida por la mañana y resulta poco fiable por la noche, y cada recurso que carga su compilación (una fuente web, un vídeo incrustado, un script de terceros) falla según su propio calendario. Una capa de entrega de contenido solo ayuda aquí si sus puntos de presencia están realmente dentro del continente; Hong Kong y Singapur parecen cercanos en un mapa, pero quedan en el lado equivocado del cruce. Entregar la compilación desde dentro de China continental es lo que elimina el viaje de ida y vuelta a través de la frontera. Esa es la puerta 1 y, por sí sola, es una cuestión de rendimiento; pero no se queda sola, porque el acto que la resuelve abre también la puerta siguiente.

Puerta 2: el registro ICP que ahora necesita el alojamiento

En el momento en que su carpeta public/ se sirve desde un servidor dentro del continente, una obligación de autorización recae sobre ese alojamiento. Un proveedor del continente lo expresa sin ambigüedad: un dominio “resolving to servers in the Chinese mainland” “must obtain an ICP filing before providing services,” y un dominio que no lo tenga queda bloqueado a nivel de red hasta que se complete el registro. El registro ICP (备案), conforme al Decreto n.º 292 del Consejo de Estado y al Decreto n.º 33 del MIIT, se vincula al recurso de alojamiento autorizado en el continente y a una entidad jurídica del continente; por eso una empresa extranjera normalmente no puede tramitarlo en su propio nombre, y por eso «simplemente pondremos los archivos en un servidor chino» resulta ser una tarea de estructura societaria tanto como técnica. Para conocer el procedimiento, consulte qué es la licencia ICP de China y cómo se obtiene.

Esto es lo que conviene interiorizar antes de elegir un alojamiento: el movimiento que resuelve la puerta 1 es el mismo que abre la puerta 2. La entrega dentro del país elimina el cruce de frontera y, en ese mismo paso, hace obligatorio el registro. No existe ninguna configuración que le dé entrega dentro del país y a la vez le mantenga al margen del registro: la velocidad y la autorización se obtienen en la misma operación, o no se obtienen.

La cuestión de la PIPL: tan grande como lo que recojan sus páginas

Aquí es donde un sitio estático se diferencia de verdad de una aplicación con muchos datos, y vale la pena ser honesto al respecto en lugar de exagerarlo. Una compilación de Gatsby de tipo folleto que no recoge nada conlleva poca exposición en materia de datos personales, de modo que, para muchos sitios estáticos, el registro ICP y la entrega dentro del país son toda la historia del cumplimiento. El panorama cambia en cuanto una página empieza a capturar datos de visitantes del continente. Un formulario de contacto, una suscripción a un boletín, un widget de comentarios, una etiqueta de analítica: cada uno puede recoger información personal, y la dirección IP real de un visitante cuenta por sí misma como información personal. Enviar cualquiera de estos elementos a un punto final fuera del continente es una transferencia transfronteriza de información personal que regula la PIPL (artículos 38 a 43: información, consentimiento separado y un mecanismo de transferencia autorizado). La regla práctica honesta es dejar que su esfuerzo en materia de PIPL varíe según lo que sus páginas de Gatsby recojan realmente, manteniendo en cualquier caso el registro ICP y la entrega dentro del país como base.

Esto es un mapa de riesgos para la planificación, no un dictamen jurídico: qué puerta obliga primero y hasta dónde llega la PIPL dependen de su entidad, de su alojamiento y de los datos que capturen sus páginas, cuestiones todas ellas que conviene resolver con un asesor jurídico antes del lanzamiento.

Dónde encaja 21YunBox: una capa conforme, no una migración

Usted sigue construyendo y publicando con Gatsby exactamente como hoy: el mismo gatsby build, la misma salida public/, el mismo flujo de trabajo. Lo que añade 21YunBox es la única pieza que una herramienta de compilación no puede aportar por sí sola: una entrega con registro ICP desde dentro del país, situada delante de su origen actual, sin reconstrucción, sin una segunda base de código y sin abandonar el stack que ya utiliza. Su compilación de Gatsby sigue siendo la fuente de verdad; nuestro equipo de China cartografía las obligaciones que se aplican a su entidad y a los datos que recogen sus páginas, se encarga del registro ICP sobre el recurso de alojamiento del continente y pone en marcha la entrega conforme dentro del país que atiende a su audiencia del continente. El framework nunca fue la parte difícil: lo difícil es la autorización para operar y la entrega que esa autorización hace posible, y esa es exactamente la mitad de la que nos ocupamos.

Obtener una evaluación de cumplimiento →


Lecturas relacionadas:

Preguntas frecuentes

Si Gatsby solo genera archivos estáticos, ¿puedo alojar mi sitio Gatsby en China continental?

Sí, y es la respuesta honesta que distingue a Gatsby de una plataforma alojada. La salida de la compilación de Gatsby es contenido estático corriente que, en las propias palabras de Gatsby, es "incredibly easy and affordable to host with any provider," de modo que los mismos archivos pueden servirse desde un alojamiento dentro del continente. Lo que cambia en cuanto ese alojamiento está dentro del país no es la compilación, sino las obligaciones que lleva aparejadas: ante todo, un registro ICP sobre el recurso de alojamiento del continente. El despliegue es la parte fácil; la puerta es el registro.

¿Necesito un registro ICP para un sencillo sitio estático de Gatsby?

Si está alojado en un servidor dentro de China continental y se presenta al público, considérelo un sí. La norma de un proveedor de alojamiento del continente es que un dominio que, "resolving to servers in the Chinese mainland," "must obtain an ICP filing before providing services," y un dominio que no lo tenga queda bloqueado hasta que se complete el registro. La exigencia sigue a la ubicación del servidor, no a la sencillez del sitio: un folleto estático de una sola página servido desde dentro del continente lo necesita igual que una aplicación compleja. Que se apliquen además las normas transfronterizas de la PIPL depende de si sus páginas recogen datos de visitantes; confirme los detalles con un asesor jurídico.

¿Puede 21YunBox ayudar a que un sitio Gatsby sea conforme y rápido en China?

Sí. Usted sigue construyendo con Gatsby exactamente como hoy; 21YunBox añade la pieza que una herramienta de compilación no puede aportar: una entrega con registro ICP dentro del país, situada delante de su origen actual, de modo que los visitantes del continente reciben el sitio desde dentro del continente, sin reconstrucción ni una segunda base de código. Nuestro equipo de China cartografía las obligaciones que se aplican a su entidad y a los datos que capturan sus páginas, se encarga del registro ICP sobre el recurso de alojamiento del continente y pone en marcha la entrega conforme. Contáctenos para revisar su configuración concreta.