Gatsby fonctionne-t-il en Chine continentale ?
Oui — mais « Gatsby » n'a jamais été ce qui doit fonctionner en Chine. Gatsby ne produit que des fichiers statiques, et ceux-ci peuvent tourner depuis l'intérieur du continent — ce qui est précisément ce qui fait entrer le projet dans le régime de la déclaration ICP.
Dans les propres mots de Gatsby, "When you build your Gatsby application, the output is static content: HTML, CSS, JavaScript, images, etc.," et ce contenu est "incredibly easy and affordable to host with any provider." La question de conformité vit dans ces derniers mots : à l'instant où "any provider" est un hébergeur à l'intérieur du continent, la règle propre à un hébergeur du continent s'applique — un domaine qui, "resolving to servers in the Chinese mainland," "must obtain an ICP filing before providing services" (décret du Conseil des affaires de l'État n° 292 ; décret MIIT n° 33). Servez plutôt le même build depuis l'étranger, et chaque visiteur du continent franchit toujours la frontière filtrée ; et si l'une de vos pages porte un formulaire, une boîte de commentaires ou de l'analytics qui capture les données d'un visiteur, les envoyer hors du continent est en outre un transfert transfrontalier au titre de la PIPL. Le tableau ci-dessous reprend la formulation de Gatsby, la règle propre à un hébergeur du continent, et le droit que chaque porte déclenche.
Il s'agit d'une carte des risques, non d'un verdict — quelle porte prend effet en premier dépend de l'endroit où vous hébergez et des données que vos pages capturent. Notre équipe Chine peut cartographier votre exposition avec vous →
Aperçu de conformité
- ✓ Gatsby ne produit que des fichiers statiques — rien à reconstruire ; le même build peut tourner sur un hébergeur du continent
- ✕ Servi depuis l'extérieur du continent, un site Gatsby ne peut pas tenir de déclaration ICP
- ! Héberger le build à l'intérieur du continent déclenche une déclaration ICP liée à une entité juridique du continent
- ! La diffusion sur le territoire et la déclaration ICP sont une seule décision, non deux — la voie rapide est la voie déclarée
- ! Ajoutez un formulaire, une boîte de commentaires ou de l'analytics qui capture les données des visiteurs, et la PIPL s'applique à la frontière
Ce qui détermine réellement si un site Gatsby est conforme en Chine continentale
| Fait | Source primaire |
|---|---|
| Gatsby est un outil de build, pas un hébergeur — il n'y a donc rien à « porter » vers la Chine. Dans les propres mots de Gatsby, "When you build your Gatsby application, the output is static content: HTML, CSS, JavaScript, images, etc.," et ce contenu est "incredibly easy and affordable to host with any provider." Rien dans le build n'est lié à une plateforme étrangère, de sorte que les fichiers identiques peuvent être servis depuis un hébergeur à l'intérieur de la Chine continentale. « Gatsby fonctionne-t-il en Chine ? » est en réalité « vers quel hébergeur déployez-vous le build ? » — et c'est là que commence la conformité. | Gatsby — Deploying and Hosting (v2.gatsbyjs.com docs), consulté le 2026-10-07 |
| Héberger le build à l'intérieur du continent est l'acte qui déclenche la déclaration ICP. Un hébergeur du continent énonce la règle sans équivoque : les services "with domain names resolving to servers in the Chinese mainland" "must obtain an ICP filing before providing services," et "ICP filing applies only to servers located in the Chinese mainland." C'est le régime de la déclaration ICP (备案) au titre du décret du Conseil des affaires de l'État n° 292 et du décret MIIT n° 33 — une déclaration qui se lie à une ressource d'hébergement agréée du continent et à une entité juridique du continent, qu'une entreprise étrangère ne peut pas détenir en son propre nom. | Alibaba Cloud — What is an ICP filing? (alibabacloud.com), consulté le 2026-10-07 ; décret du Conseil des affaires de l'État n° 292 ; décret MIIT n° 33 |
| Pas de déclaration, pas de service — même si les fichiers sont physiquement sur le territoire. Pour un domaine qui pointe vers un serveur du continent sans déclaration, le même hébergeur avertit que "the Alibaba Cloud monitoring system blocks access to the domain name and prompts you to complete the filing process." C'est l'imbrication autour de laquelle planifier : déplacer la diffusion sur le territoire supprime le franchissement de frontière et, du même geste, rend la déclaration non optionnelle — la vitesse que vous gagnez et la déclaration que vous assumez sont une seule décision. | Alibaba Cloud — What is an ICP filing? (alibabacloud.com), consulté le 2026-10-07 |
| Un site statique est léger en données personnelles — jusqu'à ce qu'une page commence à en collecter. Un build Gatsby de style brochure qui ne capture rien garde l'exposition PIPL faible, et c'est la raison honnête pour laquelle l'ICP et la diffusion sur le territoire — non le droit du transfert de données — sont ici généralement la porte dominante. Mais ajoutez un formulaire de contact, une boîte de commentaires ou une balise d'analytics qui capture les données personnelles d'un visiteur du continent (son adresse IP réelle comprise) et les envoie à un point de terminaison à l'étranger, et c'est un transfert transfrontalier de données personnelles que la PIPL encadre (chapitre III, articles 38 à 43 : information, consentement distinct, et un mécanisme de transfert autorisé). L'exposition PIPL augmente avec ce que vos pages collectent réellement. | PIPL chapitre III, articles 38 à 43 |
Sources vérifiées par Équipe Conformité 21YunBox le 7 octobre 2026.
Déployer un site Gatsby est la partie dont les équipes s’inquiètent le moins une fois qu’elles l’ont fait une fois : Gatsby compile votre projet en fichiers statiques, et les fichiers statiques vont presque partout. Ce qui décide réellement si ce site peut servir la Chine continentale n’est pas la commande de build — c’est l’endroit vers lequel vous dirigez le déploiement. À l’instant où ces fichiers sont servis depuis l’intérieur du continent, deux portes s’ouvrent en même temps, et elles sont le vrai travail. Ce guide conserve les étapes pratiques, mais les ancre à la question qui survit à toute configuration de déploiement : le site est-il autorisé à opérer en Chine, et est-il diffusé depuis l’intérieur ?
Voici le point de départ honnête, et c’est une bonne nouvelle pour une fois. Gatsby est un générateur de site statique, pas une plateforme hébergée — il n’y a aucune « région Gatsby » qui manquerait et aucun compte à migrer. La sortie du build est du contenu statique ordinaire, et c’est précisément pourquoi un site Gatsby peut tourner depuis une infrastructure à l’intérieur de la Chine continentale d’une manière qu’un service hébergé-seulement ne peut pas. Ce qui découle de cette liberté, c’est une responsabilité : une déclaration ICP sur l’hébergeur du continent, une diffusion sur le territoire pour supprimer le franchissement de frontière, et une vérification PIPL sur tout ce que vos pages collectent. Vous trouverez ci-dessous la propre description par Gatsby de sa sortie, la règle de déclaration propre à un hébergeur du continent, et le droit que chaque porte déclenche, afin que vous puissiez le soumettre à un conseil juridique.
Gatsby en Chine en un coup d’œil
| Ce qui le détermine | Dans leurs propres termes — et au regard du droit chinois |
|---|---|
| Ce qu'est Gatsby | Un générateur de site statique, pas un hébergeur. Dans les mots de Gatsby, la sortie du build est du “static content: HTML, CSS, JavaScript, images, etc.,” et elle est “incredibly easy and affordable to host with any provider.” Il n'y a aucune plateforme à quitter et aucune région du continent qui manquerait — le même build peut tourner sur le territoire. |
| Porte 1 — la diffusion sur le territoire | Servez ce build depuis l'étranger et chaque requête du continent franchit une frontière congestionnée et filtrée. L'héberger à l'intérieur du continent supprime le franchissement. C'est la moitié « performance » de la question — et seule, elle ne reste pas seule longtemps. |
| Porte 2 — la déclaration ICP | Un domaine “resolving to servers in the Chinese mainland” “must obtain an ICP filing before providing services” (décret du Conseil des affaires de l'État n° 292 ; décret MIIT n° 33). La déclaration se lie à l'hébergeur agréé du continent et à une entité juridique du continent. |
| Pourquoi elles sont une seule décision | La diffusion sur le territoire est le même acte qui déclenche la déclaration — de sorte que la décision de vitesse et la décision d'autorisation sont une seule décision, non deux. Vous ne pouvez pas héberger à l'intérieur du continent pour la vitesse et rester hors du régime de la déclaration. |
| Données des visiteurs (PIPL) | Une page purement statique collecte peu. Ajoutez un formulaire, une boîte de commentaires ou de l'analytics qui capture les données d'un visiteur et les envoie à l'étranger, et les règles transfrontalières de la PIPL s'appliquent (articles 38 à 43). L'exposition varie avec ce que les pages collectent réellement. |
| La conception qui fonctionne | Continuez de construire avec Gatsby ; ajoutez une diffusion déclarée à l'ICP, sur le territoire, devant votre origine. Une couche, pas une migration — pas de reconstruction, pas de seconde base de code. |
Ce qu’est réellement « déployer Gatsby »
Chaque déploiement Gatsby se réduit à une commande et un dossier. Exécuter gatsby build compile votre projet — dans les propres mots de Gatsby, “the output is static content: HTML, CSS, JavaScript, images, etc.” — dans un répertoire public/, et déployer n’est rien de plus que servir le contenu de ce dossier depuis un hébergeur web. Une configuration de site statique typique a la même allure où qu’elle tourne :
| Paramètre | Valeur |
|---|---|
| Commande de build | gatsby build (ou yarn && yarn build) |
| Répertoire de publication | public/ |
| Sortie du build | HTML, CSS, JavaScript et images statiques — servables par n'importe quel hébergeur |
Parce que rien de tout cela n’est lié à une plateforme particulière, la seule décision que la ligne de commande ne vous demande jamais est celle qui compte le plus : quel hébergeur sert public/. Dirigez-le vers un hébergeur à l’étranger et vous avez un site mondial qui se trouve simplement être joignable depuis la Chine de l’autre côté de la frontière. Dirigez-le vers un hébergeur à l’intérieur du continent et vous avez un site sur le territoire — et, du même geste, une obligation ICP. Ce seul choix, non le framework, est ce dont parle réellement cet article.
Porte 1 : la diffusion depuis l’intérieur du continent
Un build Gatsby servi depuis l’extérieur de la Chine continentale n’est pas cassé ; il est simplement du mauvais côté d’une frontière congestionnée et filtrée. Le symptôme que les équipes rapportent est rarement un échec net — c’est l’irrégularité. La même page est rapide le matin et peu fiable le soir, et les ressources que votre build tire (une police web, une vidéo intégrée, un script tiers) échouent chacune selon leur propre calendrier. Une couche de diffusion de contenu n’aide ici que si ses points de présence sont véritablement à l’intérieur du continent ; Hong Kong et Singapour paraissent proches sur une carte et se trouvent du mauvais côté du franchissement. Diffuser le build depuis l’intérieur de la Chine continentale est ce qui supprime l’aller-retour de frontière. C’est la porte 1, et prise seule c’est une question de performance — mais elle ne reste pas seule, car l’acte qui la corrige ouvre aussi la porte suivante.
Porte 2 : la déclaration ICP dont l’hébergeur a désormais besoin
À l’instant où votre dossier public/ est servi depuis un serveur à l’intérieur du continent, un devoir d’autorisation s’attache à cet hébergeur. Un fournisseur du continent l’énonce sans ambiguïté : un domaine “resolving to servers in the Chinese mainland” “must obtain an ICP filing before providing services,” et un domaine sans elle est bloqué au niveau du réseau jusqu’à ce que la déclaration soit achevée. La déclaration ICP (备案), au titre du décret du Conseil des affaires de l’État n° 292 et du décret MIIT n° 33, se lie à la ressource d’hébergement agréée du continent et à une entité juridique du continent — c’est pourquoi une entreprise étrangère ne peut généralement pas déclarer en son propre nom, et pourquoi « nous allons simplement mettre les fichiers sur un serveur chinois » s’avère être une tâche de structure d’entreprise autant que technique. Pour les mécanismes, voir ce qu’est la licence ICP chinoise et comment l’obtenir.
C’est la partie à intérioriser avant de choisir un hébergeur : le mouvement qui corrige la porte 1 est le mouvement qui ouvre la porte 2. La diffusion sur le territoire supprime le franchissement de frontière et, dans l’étape identique, rend la déclaration obligatoire. Il n’existe aucune configuration qui vous achète la diffusion sur le territoire tout en vous gardant à l’écart de la déclaration — la vitesse et l’autorisation sont acquises dans la même transaction, ou pas du tout.
La question PIPL — seulement aussi grande que ce que vos pages collectent
C’est ici qu’un site statique diffère véritablement d’une application riche en données, et il vaut la peine d’être honnête à ce sujet plutôt que de l’exagérer. Un build Gatsby de style brochure qui ne collecte rien porte peu d’exposition aux données personnelles, de sorte que pour beaucoup de sites statiques la déclaration ICP et la diffusion sur le territoire sont toute l’histoire de la conformité. Le tableau change à l’instant où une page commence à capturer des données sur des visiteurs du continent. Un formulaire de contact, une inscription à une newsletter, un widget de commentaires, une balise d’analytics — chacun peut collecter des informations personnelles, et l’adresse IP réelle d’un visiteur compte comme une information personnelle à part entière. Envoyer n’importe lequel de ces éléments à un point de terminaison hors du continent est un transfert transfrontalier d’informations personnelles que la PIPL encadre (articles 38 à 43 : information, consentement distinct, et un mécanisme de transfert autorisé). La règle empirique honnête est de laisser votre effort PIPL varier avec ce que vos pages Gatsby collectent réellement, tout en gardant la déclaration ICP et la diffusion sur le territoire comme base dans un cas comme dans l’autre.
Il s’agit d’une carte des risques pour la planification, non d’un verdict juridique : quelle porte lie en premier, et jusqu’où la PIPL s’étend, dépendent de votre entité, de votre hébergeur et des données que vos pages capturent — autant de choses à régler avec un conseil juridique avant le lancement.
Où s’insère 21YunBox — une couche conforme, pas une migration
Vous continuez de construire et de livrer avec Gatsby exactement comme aujourd’hui — le même gatsby build, la même sortie public/, le même flux de travail. Ce que 21YunBox ajoute, c’est la seule pièce qu’un outil de build ne peut structurellement pas fournir à lui seul : une diffusion déclarée à l’ICP depuis le territoire, placée devant votre origine existante — pas de reconstruction, pas de seconde base de code, et pas de départ du stack que vous exploitez déjà. Votre build Gatsby reste la source de vérité ; notre équipe Chine cartographie les obligations qui s’appliquent à votre entité et aux données que vos pages collectent, gère la déclaration ICP sur la ressource d’hébergement du continent, et met en place la diffusion conforme sur le territoire qui sert votre audience du continent. Le framework n’a jamais été la partie difficile — l’autorisation d’opérer, et la diffusion que cette autorisation permet, le sont, et c’est exactement la moitié que nous tenons.
Obtenir une évaluation de conformité →
À lire également :
Questions fréquentes
Si Gatsby ne construit que des fichiers statiques, puis-je héberger mon site Gatsby en Chine continentale ?
Oui — et c'est la réponse honnête qui distingue Gatsby d'une plateforme hébergée. La sortie du build de Gatsby est du contenu statique ordinaire, qui dans les propres mots de Gatsby est "incredibly easy and affordable to host with any provider," de sorte que les mêmes fichiers peuvent être servis depuis un hébergeur à l'intérieur du continent. Ce qui change dès que cet hébergeur est sur le territoire, ce n'est pas le build ; ce sont les obligations qui s'y lient — avant tout une déclaration ICP sur la ressource d'hébergement du continent. Le déploiement est la partie facile ; la porte est la déclaration.
Ai-je besoin d'une déclaration ICP pour un simple site statique Gatsby ?
S'il est hébergé sur un serveur à l'intérieur de la Chine continentale et présenté au public, traitez-le comme un oui. La règle propre à un hébergeur du continent est qu'un domaine qui, "resolving to servers in the Chinese mainland," "must obtain an ICP filing before providing services," et un domaine sans elle est bloqué jusqu'à ce que la déclaration soit achevée. L'exigence suit la localisation du serveur, non la simplicité du site — une brochure statique d'une page servie depuis l'intérieur du continent en a besoin autant qu'une application complexe. Que les règles transfrontalières de la PIPL s'appliquent en plus dépend du fait que vos pages collectent des données de visiteurs ; confirmez les détails avec un conseil juridique.
21YunBox peut-il aider à rendre un site Gatsby conforme et rapide en Chine ?
Oui. Vous continuez de construire avec Gatsby exactement comme aujourd'hui ; 21YunBox ajoute la pièce qu'un outil de build ne peut pas — une diffusion déclarée à l'ICP, sur le territoire, devant votre origine existante, de sorte que les visiteurs du continent sont servis depuis l'intérieur du continent, sans reconstruction ni seconde base de code. Notre équipe Chine cartographie les obligations qui s'appliquent à votre entité et aux données que vos pages capturent, gère la déclaration ICP sur la ressource d'hébergement du continent, et met en place la diffusion conforme. Contactez-nous pour examiner votre configuration précise.