¿Funciona Composer (Packagist) en China? Residencia de datos, ICP y reglas transfronterizas
Sus paquetes privados de Composer son código PHP propietario — secretos comerciales — que a menudo incorpora tokens de API y secretos. Packagist.org y los registros privados alojados funcionan en el extranjero, sin ninguna instancia en China continental, de modo que ese código y su cadena de suministro residen fuera del país. Autoalojar un repositorio privado dentro del país es la palanca de residencia según la PIPL.
¿Funciona Composer (Packagist) en China?
La verdadera cuestión de China para Composer no es si su compilación puede alcanzar los paquetes — es dónde residen sus paquetes privados. Los paquetes privados de Composer con el ámbito de su organización son código fuente propietario (secretos comerciales) y habitualmente llevan tokens de API, claves de despliegue y secretos de configuración. Alojados en Packagist.org o en un registro privado alojado, ese código concentrado y esos secretos residen en el extranjero — una exposición de residencia de datos y de secretos comerciales —, mientras la cadena de suministro de dependencias de su compilación para China cruza la frontera en cada resolución.
Si algún paquete o fixture de pruebas contiene datos personales de personas en China, llevarlo al extranjero es una transferencia transfronteriza según la PIPL; para un operador de infraestructuras de información críticas, el artículo 39 de la Ley de Ciberseguridad (antes artículo 37) añade un deber de almacenamiento dentro del país.
La palanca es un repositorio privado de Composer autoalojado y dentro del país (Satis, o un registro privado on-premise) que mantiene residentes su código propietario y sus secretos incorporados, con la cadena de suministro de su compilación para China dentro del país — nunca ninguna forma de elusión. Trate los detalles como un riesgo que debe confirmar con su asesoría legal.
Instantánea de cumplimiento
- ! Sus paquetes privados de Composer son código propietario y a menudo incorporan secretos.
- ! Packagist.org es el registro público de PHP — alojado en el extranjero, sin instancia en China continental.
- ! Los paquetes privados en un registro alojado en el extranjero son una exposición de residencia y de secretos comerciales.
- ! La cadena de suministro de dependencias de su compilación para China cruza entonces la frontera en cada resolución.
- ✓ Autoaloje dentro del país un repositorio privado de Composer (Satis) para que el código y los secretos permanezcan residentes.
Lo que la documentación oficial de Composer (Packagist) dice sobre China
| Hecho | Fuente primaria |
|---|---|
| Packagist.org es el registro de paquetes PHP público y en el extranjero — no hay ninguna instancia en China continental. La propia página «About» de Packagist afirma: “Packagist is the default Composer package repository. It lets you find packages and lets Composer know where to get the code from,” (Packagist es el repositorio de paquetes predeterminado de Composer; le permite encontrar paquetes e indica a Composer de dónde obtener el código) y que “aggregates public packages that anyone can install with Composer.” (agrega paquetes públicos que cualquiera puede instalar con Composer). | Packagist.org, «About» (packagist.org), consultado el 2026-10-13 |
| Composer admite un registro privado autoalojado y dentro del país. La propia documentación «Handling private packages» de Composer afirma que Satis “is open source but only a static composer repository generator” (es de código abierto, pero solo un generador de repositorios estáticos de Composer) que “can be used to host the metadata of your company's private packages, or your own,” (puede usarse para alojar los metadatos de los paquetes privados de su empresa, o los suyos propios) y que Private Packagist está “available as a hosted SaaS solution or as an on-premise self-hosted package.” (disponible como solución SaaS alojada o como paquete autoalojado on-premise). | Documentación de Composer, «Handling private packages» (getcomposer.org), consultado el 2026-10-13 |
| Enviar al extranjero datos personales de China es una transferencia transfronteriza regulada. Si un paquete privado, un artefacto de compilación o un fixture de pruebas contiene información personal de personas en China continental, enviarlo a un registro en el extranjero activa los artículos 38 a 40 de la PIPL: notificación, un consentimiento separado y un mecanismo de transferencia — una evaluación de seguridad de la CAC, el contrato estándar de la CAC o una certificación. | PIPL, capítulo III, artículos 38–40 (Ley de Protección de Información Personal de la RPC); explicación de 21YunBox sobre la transferencia transfronteriza de datos, consultado el 2026-10-13 |
| Un operador de infraestructuras de información críticas afronta un deber de almacenamiento dentro del país. El artículo 39 de la Ley de Ciberseguridad de China (antes artículo 37) exige que la información personal y los datos importantes generados en China continental se almacenen dentro del país — una obligación de residencia que un registro solo en el extranjero no puede cumplir. | Ley de Ciberseguridad de la RPC, artículo 39 (antes artículo 37) (Ley de Ciberseguridad reformada, en vigor desde el 2026-01-01); explicación de 21YunBox sobre la localización de datos, consultado el 2026-10-13 |
Fuentes verificadas por el Equipo de Cumplimiento de 21YunBox el 13 de octubre de 2026.
Pregunte si Composer «funciona» en China continental y la respuesta honesta no empieza por si su compilación puede descargar paquetes rápidamente desde Shanghái. Composer es el gestor de dependencias de PHP, y Packagist.org es el registro público contra el que resuelve — pero la cuestión de cumplimiento está en la otra cara de un registro de paquetes. Los paquetes privados de Composer con el ámbito de su organización son su código fuente propietario — secretos comerciales —, y habitualmente llevan tokens de API, claves de despliegue y secretos de configuración, y a veces datos personales dentro de un fixture de pruebas. Alojados en Packagist.org o en un registro privado alojado, ese código concentrado y esos secretos residen en el extranjero, fuera del continente, y la cadena de suministro de dependencias de su compilación para China — qué código entra en su despliegue en China, con qué procedencia e integridad — cruza la frontera cada vez que resuelve. Que el registro sea accesible es una cuestión real, pero es la menor de las que está decidiendo.
Composer en China de un vistazo
| Qué lo decide | Para Composer (Packagist) |
|---|---|
| Dónde se ejecuta | Packagist.org es, en sus propias palabras, “the default Composer package repository” (el repositorio de paquetes predeterminado de Composer) — un registro público alojado en el extranjero. Los paquetes privados residen en un registro privado alojado (por ejemplo, el SaaS de Private Packagist), salvo que usted los autoaloje. Ninguno de los dos tiene una instancia en China continental. |
| Qué contiene | Sus paquetes privados, con el ámbito de su organización, son su código fuente PHP propietario — secretos comerciales. Habitualmente incorporan tokens de API, claves de despliegue y secretos de configuración, y a veces datos personales olvidados en un fixture de pruebas. Es su propiedad intelectual más concentrada, no dependencias de la comunidad. |
| Dónde residen esos datos | En el extranjero, salvo que usted lo autoaloje. Concentrar código propietario y secretos incorporados en un registro en el extranjero es una exposición de residencia de datos y de secretos comerciales; cualquier dato personal dentro de un paquete o fixture se convierte en una transferencia transfronteriza regida por la PIPL. |
| Su cadena de suministro de dependencias | Qué código entra en su despliegue en China — y con qué procedencia e integridad — se decide al resolver e instalar. Si el registro privado funciona en el extranjero, esa cadena de suministro cruza la frontera en cada compilación, fuera de su control dentro del país. |
| ¿Una opción autoalojada? | Sí. La documentación de Composer describe Satis, un “static composer repository generator” (generador de repositorios estáticos de Composer) de código abierto que aloja “the metadata of your company's private packages” (los metadatos de los paquetes privados de su empresa), y señala que Private Packagist se distribuye “as an on-premise self-hosted package” (como paquete autoalojado on-premise). Ejecute uno dentro del país para que el código y los secretos permanezcan residentes. |
| ¿Es accesible? | Que la compilación pueda resolver paquetes desde el continente es una cuestión de entrega — distinta de, y menor que, la de si usted está habilitado siquiera para mantener este código propietario y estos secretos en el extranjero. |
Dónde residen sus paquetes privados — y eso zanja la primera cuestión
Un registro de paquetes tiene dos caras. Una es la cara pública, de código abierto: descargar dependencias de la comunidad, que es un tema de accesibilidad y de réplicas. La otra es la que decide la cuestión de China — sus propios paquetes privados. Packagist.org es, según su propia página «About», “the default Composer package repository” (el repositorio de paquetes predeterminado de Composer) que “aggregates public packages that anyone can install with Composer” (agrega paquetes públicos que cualquiera puede instalar con Composer); es un único servicio alojado que funciona en el extranjero, sin ninguna instancia en China continental. Sus paquetes privados no van allí — residen en un registro privado alojado (como el SaaS de Private Packagist), salvo que usted aloje el suyo propio. En cualquier caso, los paquetes privados que contienen su código propietario y sus secretos quedan en el extranjero desde el momento en que se publican. Ese único hecho decide la cuestión de cumplimiento antes de que se mida siquiera la accesibilidad: no se trata de si composer install termina rápido, sino de dónde se almacenan su código de secreto comercial y sus credenciales incorporadas.
Primera vertiente — sus paquetes privados son código propietario y secretos incorporados, mantenidos en el extranjero
La función de Composer en este eje es almacenar y distribuir sus paquetes privados, y esos paquetes son su propiedad intelectual más concentrada: código fuente PHP propietario que usted decidió deliberadamente no publicar como código abierto. Dentro de ellos viajan, en la práctica, los tokens de API, las claves de despliegue, las credenciales de bases de datos y los secretos de configuración que usan sus servicios — incluidas las claves que llegan a sistemas dentro de China — y, de vez en cuando, datos personales olvidados en un fixture de pruebas. Alojado en un registro que funciona en el extranjero, ese corpus de código y secretos reside fuera del continente, concentrado en un solo lugar en el extranjero. Si una parte de él es información personal de personas en China, llevarla al extranjero activa la Ley de Protección de Información Personal: notificación, un consentimiento separado y un mecanismo de transferencia habilitado — una evaluación de seguridad de la CAC, el contrato estándar de la CAC o una certificación, conforme a los artículos 13/23 y 38 a 40 de la PIPL. Para un operador de infraestructuras de información críticas o un tratante de grandes volúmenes, la información personal generada en China debe almacenarse en el continente (artículo 39 de la Ley de Ciberseguridad (antes artículo 37); artículo 40 de la PIPL) — un deber de residencia que un registro solo en el extranjero no puede cumplir. Una comprobación que solo confirma que la compilación resuelve nunca ve que su código propietario y sus secretos residen en el extranjero.
Segunda vertiente — la cadena de suministro de dependencias de su compilación para China cruza la frontera
Composer no solo almacena código; lo ensambla. Cada composer install o composer update resuelve su grafo de dependencias contra un registro y descarga los paquetes que se convierten en su despliegue en China en ejecución. Cuando el registro privado que sirve esos paquetes está en el extranjero, la cadena de suministro de su compilación para China — qué código entra en el despliegue, desde dónde, con qué procedencia e integridad — cruza la frontera en cada compilación, fuera de su gobernanza dentro del país. Esa es la segunda mitad, la distintiva, que ninguna sonda de accesibilidad llega a ver: puede confirmar que el registro respondió, pero no puede ver que los paquetes privados de confianza que alimentan su versión para China se gobiernan en el extranjero, ni que sus secretos viajan con ellos. Una réplica o caché legítima del registro dentro del país puede acelerar y reforzar la forma en que se obtienen las dependencias públicas, pero replicar la cara pública no traslada al país sus paquetes privados ni su cadena de suministro — su código propietario y sus secretos siguen en el extranjero.
Por qué una comprobación de accesibilidad pasa todo esto por alto
Una prueba que solo pregunta «¿puede la compilación descargar paquetes desde Shanghái?» mide lo que no es. No puede ver que sus paquetes privados — su código propietario — se mantienen en un registro fuera del continente, no puede ver los tokens de API y las credenciales incorporados en ellos, y no puede ver los deberes de notificación, consentimiento y mecanismo que acompañan a cualquier dato personal de China dentro de un paquete o fixture. Hacer que el registro público sea simplemente accesible o replicado no traslada al país el código regulado, los secretos ni la cadena de suministro, y no crea la base de transferencia que exige la PIPL. Llegar a un público chino y estar habilitado para mantener y transportar su código privado y sus secretos son dos pruebas distintas — y solo una de ellas aparece en un gráfico de latencia.
Dónde encaja 21YunBox — cartografiar, localizar, entregar
No le pedimos que abandone Composer ni Packagist. Añadimos la capa que un registro alojado en el extranjero no puede aportar. Cartografiar: inventariamos cuáles de sus paquetes y artefactos de compilación son privados — su código propietario —, si incorporan secretos, dónde está alojado ese registro privado y qué incorpora la cadena de suministro de dependencias de su compilación para China. Localizar y gobernar: le ayudamos a operar el registro privado y el almacén de artefactos dentro del país, para que el código propietario y los secretos incorporados permanezcan residentes — Composer lo admite directamente mediante un repositorio Satis autoalojado (un generador de repositorios estáticos de Composer para los metadatos de sus paquetes privados) o un registro privado on-premise —, a mantener dentro del país la cadena de suministro de su compilación para China y a minimizar lo que cruza la frontera. Entregar: ponemos en marcha dentro del país el registro de paquetes privado conforme y la entrega de artefactos, por delante de (o en lugar de) la nube en el extranjero, y tramitamos el registro ICP de cualquier superficie orientada a China — sin reconstruir, sin una segunda base de código. 21YunBox nunca utiliza ni recomienda ninguna forma de elusión.
Esto es un mapa de riesgo, no un veredicto: si usted debe notificación y consentimiento, un mecanismo de transferencia, almacenamiento dentro del país, un registro ICP o alguna combinación de ellos depende de su entidad, de sus volúmenes de datos y de lo que transportan sus paquetes y fixtures — conviene concretarlo con asesoría legal antes de enviar versiones compiladas con Composer a trabajos orientados a China.
Solicitar una evaluación de cumplimiento →
Lectura relacionada:
- Transferencias transfronterizas de datos conforme a la PIPL
- La Ley de Protección de Información Personal de China (PIPL)
- La Ley de Ciberseguridad de China y la localización de datos
- Cómo obtener un registro ICP para China
Preguntas frecuentes
¿Está bloqueado Composer o Packagist en China continental?
La accesibilidad no es la cuestión de China para Composer. Que su compilación pueda resolver paquetes desde el continente es una cuestión de entrega; lo decisivo es dónde residen sus paquetes privados y sus artefactos de compilación. Sus paquetes privados, con el ámbito de su organización, son código propietario y a menudo incorporan tokens de API y claves de despliegue, y el registro público (Packagist.org) y los registros privados alojados funcionan en el extranjero, sin instancia en China continental — así que la verdadera prueba es la residencia de ese código y esos secretos, y la procedencia de la cadena de suministro de dependencias de su compilación para China. La respuesta nunca es un atajo de red. Confirme los detalles con su asesoría legal.
¿Dónde residen realmente mis paquetes privados de Composer y mis secretos?
Salvo que usted los autoaloje, sus paquetes privados residen en un registro alojado que funciona en el extranjero — Packagist.org para los paquetes públicos y un registro privado alojado (como el SaaS de Private Packagist) para los privados. Eso concentra fuera de China continental su código fuente PHP propietario — secretos comerciales — y las credenciales, los tokens de API y los secretos de configuración que los paquetes incorporan habitualmente. Si algún paquete o fixture contiene datos personales de personas en China, mantenerlo en el extranjero es una transferencia transfronteriza según la PIPL. Una comprobación que solo confirma que la compilación puede resolver paquetes nunca ve dónde residen ese código y esos secretos.
¿Cómo mantengo dentro del país mis paquetes privados de Composer y mis secretos?
Composer admite un repositorio privado autoalojado que usted puede ejecutar dentro de China continental: Satis, un generador de repositorios estáticos de Composer de código abierto que aloja los metadatos de los paquetes privados de su empresa, o un registro privado on-premise — lo que mantiene residentes su código propietario y sus secretos incorporados, con la cadena de suministro de dependencias de su compilación para China dentro del país. Una réplica o caché del registro para las dependencias públicas es una medida legítima de la cadena de suministro, pero por sí sola no es la respuesta de residencia. 21YunBox cartografía qué contienen sus paquetes y artefactos, pone en marcha dentro del país el registro privado y el almacén de artefactos conformes sin reconstruir nada, y nunca utiliza ni recomienda ninguna forma de elusión.
