¿Funciona PyPI en China? Residencia de datos, ICP y reglas transfronterizas
Sus paquetes privados de Python son código propietario que a menudo incorpora credenciales y tokens de API, y PyPI (pypi.org) no los aloja — así que residen en un registro privado en el extranjero mientras la cadena de suministro de dependencias de su compilación en China cruza la frontera. Un análisis con el cumplimiento por delante de la exposición de residencia y de cadena de suministro, y de la palanca de un índice privado autoalojado dentro del país.
¿Funciona PyPI en China?
La pregunta que decide PyPI en China no es si pip install llega al índice — es dónde tienen permitido residir sus paquetes privados y los secretos incrustados en ellos. PyPI (pypi.org, el índice público de la Python Software Foundation) no aloja paquetes privados, así que su código propietario reside en un registro privado en el extranjero mientras la cadena de suministro de dependencias de su compilación en China cruza la frontera: un problema de residencia y de cadena de suministro, no de rendimiento.
Sus distribuciones privadas son SDK internos, bibliotecas cliente y lógica de compilación — código fuente propietario, es decir, secretos comerciales — y suelen incorporar credenciales, tokens de API y configuración, a veces datos personales de fixtures de prueba. Como PyPI “does not support publishing private packages” (no admite publicar paquetes privados), ese código concentrado y sus secretos residen en un registro privado alojado (a menudo la nube de un proveedor en el extranjero) o en un servidor que usted opera, y pip resuelve por defecto las compilaciones desde “https://pypi.org/simple”. Cuando un paquete incorpora datos personales de usuarios chinos, mantenerlo en el extranjero es una transferencia transfronteriza según la PIPL (artículos 38–40), con un deber de almacenamiento en el continente para los operadores de infraestructuras de información críticas y los tratantes de grandes volúmenes (Ley de Ciberseguridad, artículo 39, antes artículo 37). La palanca legal es mantener los paquetes privados, los artefactos y los secretos dentro del país en un índice privado autoalojado — no hacer accesible el endpoint público; el registro ICP recae sobre la aplicación situada por delante del stack.
Esto es un mapa de riesgo, no un veredicto — qué mecanismo de transferencia encaja, y si se aplica un deber de localización, depende de su entidad, de sus volúmenes de datos y de quién son esos datos. Nuestro equipo de China puede cartografiar su exposición →
Instantánea de cumplimiento
- ! Los paquetes privados de Python son código propietario — secretos comerciales, no dependencias públicas
- ! Los wheels privados suelen incorporar credenciales, tokens de API y secretos de configuración
- ! PyPI es el índice público; no aloja paquetes privados, así que residen en otra parte
- ! Por defecto, pip resuelve su compilación en China desde pypi.org — una cadena de suministro en el extranjero
- ✓ Vía legal: autoalojar un índice privado dentro del país; mantener residentes el código y los secretos
Lo que la documentación oficial de PyPI dice sobre China
| Hecho | Fuente primaria |
|---|---|
| PyPI es el índice público y no aloja paquetes privados — así que su código propietario reside en otra parte. Ante la pregunta “How can I publish my private packages to PyPI?” (¿cómo puedo publicar mis paquetes privados en PyPI?), la página de ayuda de PyPI responde: “PyPI does not support publishing private packages.” (PyPI no admite publicar paquetes privados). El índice lo mantienen “by the Python Software Foundation and Python community, for the Python community” (la Python Software Foundation y la comunidad de Python, para la comunidad de Python) y se sirve desde fuera de China continental. Para un paquete privado, la vía que recomienda el propio PyPI es “run your own deployment of the devpi project,” (ejecutar su propio despliegue del proyecto devpi) y, para la disponibilidad, “consider either a mirror or a private index” (considerar una réplica o un índice privado) — de modo que sus paquetes privados residen en un registro privado alojado (a menudo en el extranjero) o en un servidor que usted opera. | PyPI — Help (Python Software Foundation), pypi.org, consultado el 2026-10-13 |
| La cadena de suministro de dependencias de su compilación en China se resuelve por defecto en el extranjero — y puede apuntarse a su propio índice dentro del país. El índice por defecto documentado de pip es la “Base URL of the Python Package Index (default https://pypi.org/simple),” (URL base del Python Package Index, por defecto https://pypi.org/simple), un endpoint en el extranjero, y los paquetes privados proceden de los índices añadidos con “--extra-index-url.” La Python Packaging User Guide confirma la vía de autoalojamiento: “If you wish to host your own simple repository … you can either use a software package like devpi.” (si desea alojar su propio repositorio simple… puede usar un paquete de software como devpi). Así, qué código entra en su despliegue en el continente, y desde dónde, es gobernable — un índice autoalojado dentro del país mantiene residente la cadena de suministro. | Documentación de pip — pip install (pip.pypa.io); Python Packaging User Guide — Hosting your own index (packaging.python.org), consultado el 2026-10-13 |
| Cuando un paquete privado incorpora datos personales de usuarios chinos, almacenarlo en el extranjero es una transferencia transfronteriza según la PIPL. Las distribuciones privadas y los fixtures de prueba pueden contener datos personales; poblar o alojar un paquete así en un registro en el extranjero activa los artículos 38–40 de la PIPL — el responsable del tratamiento (usted, no PyPI) debe notificar, obtener un consentimiento separado y cumplir un mecanismo de transferencia (una evaluación de seguridad de la CAC, el contrato estándar o una certificación). Véase la Ley de Protección de Información Personal y las transferencias transfronterizas de datos conforme a la PIPL. | PIPL artículos 38–40; normas chinas sobre transferencia transfronteriza de datos, consultado el 2026-10-13 |
| Para algunos responsables, los datos deben quedarse en China — y un registro privado en el extranjero no tiene dónde guardarlos dentro del país. Un operador de infraestructuras de información críticas, o un responsable por encima de los umbrales de volumen de los reguladores, debe almacenar en el continente los datos personales recogidos en China (artículo 40 de la PIPL; Ley de Ciberseguridad, artículo 39, antes artículo 37; la reforma de 2025, en vigor desde el 1 de enero de 2026, renumeró el 37 como 39, sin cambios de fondo). El remedio dentro del país es un índice privado autoalojado en infraestructura del continente, que mantiene residentes los paquetes privados, los artefactos y los secretos. | PIPL artículo 40; Ley de Ciberseguridad artículo 39 (antes artículo 37), consultado el 2026-10-13 |
Fuentes verificadas por el Equipo de Cumplimiento de 21YunBox el 13 de octubre de 2026.
Para un equipo de ingeniería orientado a China, la pregunta decisiva sobre PyPI no es si pip install puede llegar al índice desde Shanghái — es dónde tienen permitido residir sus paquetes privados y los secretos incrustados en ellos. El Python Package Index de pypi.org es el índice público y comunitario que opera la Python Software Foundation, y es donde se comparten las dependencias de código abierto. Sus propios paquetes son algo completamente distinto: un SDK interno, una biblioteca cliente compartida, lógica de compilación y despliegue, módulos de producto — código fuente propietario y, por tanto, secretos comerciales. Esas distribuciones privadas suelen incorporar credenciales, tokens de API, cadenas de conexión y configuración, y a veces contienen datos personales de fixtures de prueba. Tres frentes deciden la respuesta: que sus paquetes privados son código propietario más secretos incorporados; dónde reposan físicamente ese código concentrado y esos secretos; y la cadena de suministro de dependencias de su compilación en China — qué código entra en su despliegue en el continente, y desde dónde. La accesibilidad del índice público no es el eje.
PyPI en China de un vistazo
| Qué lo decide | En los propios términos de PyPI — y la ley china |
|---|---|
| Qué son sus paquetes privados | No son dependencias comunitarias — son sus propios SDK internos, bibliotecas cliente, lógica de compilación y módulos de producto. Eso es código fuente propietario: secretos comerciales, concentrados en un solo lugar. |
| Qué contienen | Las distribuciones privadas suelen incorporar credenciales, tokens de API, cadenas de conexión y configuración, y a veces datos personales de fixtures de prueba. Un artefacto de compilación rara vez es solo código. |
| Dónde residen | PyPI “does not support publishing private packages” (no admite publicar paquetes privados), así que sus paquetes privados están en otra parte — un registro o feed privado alojado (a menudo la nube de un proveedor en el extranjero) o un servidor que usted opera. La vía que recomienda el propio PyPI es “run your own deployment of the devpi project” (ejecutar su propio despliegue del proyecto devpi). |
| La cadena de suministro de su compilación en China | pip resuelve por defecto desde “https://pypi.org/simple” — en el extranjero — y los índices privados se añaden con --extra-index-url. Qué código entra en su despliegue en el continente, con qué procedencia e integridad, es una cuestión transfronteriza de cadena de suministro. |
| La ley | Cuando un paquete privado incorpora datos personales de usuarios chinos, o su tratamiento implica datos personales, almacenarlo en el extranjero es una transferencia transfronteriza (artículos 38–40 de la PIPL), con un deber de almacenamiento en el continente para los operadores de infraestructuras de información críticas y los tratantes de grandes volúmenes (artículo 40 de la PIPL; artículo 39 de la Ley de Ciberseguridad, antes artículo 37). |
| La accesibilidad no es el eje | Conseguir que el índice público sea simplemente accesible, o replicarlo, no traslada al país sus paquetes privados ni sus secretos. La palanca legal es un índice privado autoalojado dentro del país; el registro ICP recae sobre la aplicación situada por delante del stack, no sobre el índice. |
Qué es en realidad un paquete privado de Python — código propietario, con secretos dentro
Una dependencia que usted descarga de pypi.org es código abierto de otra persona. Los paquetes que publica su propio equipo son lo contrario: un SDK interno, una biblioteca compartida de acceso a datos, sus herramientas de compilación y publicación, módulos de producto que nunca piensa liberar como código abierto. Eso es código fuente propietario, y la ley trata el código fuente concentrado y no público como un secreto comercial. Peor aún para la residencia, una distribución privada rara vez es pura lógica. Los equipos empaquetan configuración, clientes de servicios con tokens de API incrustados, cadenas de conexión y credenciales, y fixtures de prueba que pueden contener datos personales reales. Así que un índice privado de paquetes no es una caché de conveniencia — es un almacén concentrado de su propiedad intelectual y de sus secretos. Dónde reposa físicamente ese almacén es una decisión de residencia de datos, y PyPI, por diseño, no es donde reposa.
Dónde residen sus paquetes privados — y por qué no es PyPI
PyPI es el índice público, y lo dice con sus propias palabras. Su página de ayuda responde a la pregunta “How can I publish my private packages to PyPI?” (¿cómo puedo publicar mis paquetes privados en PyPI?) con una única frase tajante: “PyPI does not support publishing private packages.” (PyPI no admite publicar paquetes privados). El índice de pypi.org existe para compartir distribuciones de código abierto con la comunidad; lo mantienen, según el propio pie de página de la Fundación, “by the Python Software Foundation and Python community, for the Python community,” (la Python Software Foundation y la comunidad de Python, para la comunidad de Python) y se sirve globalmente desde fuera de China continental. Como sus paquetes privados no pueden residir allí, residen en otro sitio — y ese «otro sitio» es la exposición. La mayoría de los equipos acaba en un registro o feed privado alojado, lo que significa que su código propietario y los secretos que incorpora residen en la nube de un proveedor en el extranjero: una concentración de residencia de datos y de secretos comerciales fuera del país. La propia orientación de PyPI apunta en la dirección contraria — para un paquete privado, “the recommended solution is to run your own deployment of the devpi project,” (la solución recomendada es ejecutar su propio despliegue del proyecto devpi) y, para la disponibilidad, le dice que “consider either a mirror or a private index.” (considere una réplica o un índice privado). Una comprobación de accesibilidad nunca ve nada de esto. Pregunta si el endpoint responde; no puede ver que su código propietario y sus secretos están aparcados en el extranjero.
La cadena de suministro de dependencias de su compilación en China cruza la frontera
La segunda mitad que la mayoría de los equipos pasa por alto es la procedencia. Un pip install es una cadena de suministro: su compilación en el continente resuelve y descarga distribuciones, y todo lo que descarga pasa a formar parte de lo que usted despliega en China. El propio valor por defecto de pip deja clara la forma — el índice es la “Base URL of the Python Package Index (default https://pypi.org/simple),” (URL base del Python Package Index, por defecto https://pypi.org/simple), un endpoint en el extranjero, y los paquetes privados proceden de los índices que usted añade con --extra-index-url. Cuando tanto el índice público como el privado están fuera del país, cada compilación cruza la frontera en busca del código exacto — y de los secretos exactos — que se ejecutarán en su despliegue en China, con una integridad y una procedencia sobre las que ahora tiene que razonar a través de un enlace transfronterizo. La pregunta de cumplimiento no es «¿puede la compilación resolver paquetes rápido?», sino «¿qué código entra en mi despliegue en China, desde dónde, y dónde reposan mis paquetes privados y mis secretos mientras tanto?».
Por qué una comprobación de accesibilidad pasa todo esto por alto
Las pruebas de rendimiento y las comprobaciones de «¿funciona desde China?» responden a una pregunta distinta de la que decide el cumplimiento. Un endpoint puede responder rápido y su postura puede seguir siendo incorrecta, porque la velocidad y la disponibilidad no dicen nada de la residencia. Una réplica o caché del registro mejora la disponibilidad de los paquetes públicos — una medida legítima de cadena de suministro —, pero no traslada al país sus paquetes privados ni los secretos que incorporan, y no cambia dónde reposa su código propietario. El eje aquí es la residencia y la cadena de suministro: si sus distribuciones privadas, artefactos de compilación, credenciales y cualquier dato personal incorporado permanecen en el continente, y si el código que entra en su compilación en China procede de una fuente dentro del país que usted gobierna. Eso es exactamente lo que una prueba de accesibilidad no puede ver — y exactamente lo que resuelve un índice privado autoalojado dentro del país.
Esto es un mapa de riesgo, no un veredicto: que se aplique un deber de localización, y qué mecanismo transfronterizo encaja, depende de su entidad, de cuántos datos personales conserva y de quién son — concrete los detalles con asesoría legal antes de construir.
La vía legal — cartografiar, localizar, entregar
PyPI sigue siendo su fuente pública de dependencias de código abierto; nada se reconstruye ni se migra. Lo que añade 21YunBox es la capa de cumplimiento y de entrega en torno a sus paquetes privados y su compilación.
- Cartografiar. Inventariamos cuáles de sus paquetes son privados — su código propietario —, si incorporan credenciales, tokens o datos personales, dónde está alojado hoy ese registro privado y cómo resuelve su compilación en China su cadena de suministro de dependencias.
- Localizar. Le ayudamos a mantener residentes los paquetes privados, los artefactos de compilación y sus secretos ejecutando un índice privado autoalojado dentro del país (por ejemplo, un devpi, Nexus o Artifactory autogestionado en infraestructura del continente), apuntamos su compilación en China hacia él y minimizamos lo que cruza la frontera — de modo que el código propietario y los secretos incorporados permanezcan en el continente. Mantenerlo dentro del país significa exactamente eso. 21YunBox nunca utiliza ni recomienda ninguna forma de elusión.
- Entregar. La aplicación construida sobre esos paquetes tiene un deber de registro ICP y necesita una entrega conforme dentro del país — el 21YunBox Optimizer, por delante del stack que ya utiliza, sin reconstruir.
21YunBox es una capa de cumplimiento y un socio, no un competidor de PyPI ni de ninguna herramienta de registro de paquetes. El objetivo es sencillo: que su compilación de Python y los paquetes privados que la sustentan funcionen de forma legal y conforme para su equipo en China, con su código propietario y sus secretos donde la ley los quiere.
Solicitar una evaluación de cumplimiento →
Lectura relacionada:
- La Ley de Protección de Información Personal de China (PIPL)
- Transferencias transfronterizas de datos conforme a la PIPL
- La Ley de Ciberseguridad de China — localización de datos (artículo 39, antes artículo 37)
- Cómo obtener un registro ICP para China
Preguntas frecuentes
¿Basta con que pip install funcione desde China para que PyPI sea conforme?
No — la accesibilidad no es el eje. Que el índice público responda desde el continente no dice nada de dónde reposan sus paquetes privados, artefactos de compilación y secretos incorporados, ni de dónde procede el código que entra en su compilación en China. PyPI no aloja paquetes privados, así que su código propietario reside en un registro privado alojado (a menudo la nube de un proveedor en el extranjero) o en un servidor que usted opera. Las cuestiones de cumplimiento son la residencia y la cadena de suministro: mantener dentro del país sus paquetes privados, artefactos y secretos, y gobernar qué código entra en su despliegue en el continente. Un índice privado autoalojado dentro del país resuelve ambas; una réplica o caché de paquetes públicos únicamente aporta disponibilidad.
¿Dónde residen realmente nuestros paquetes privados de Python, y por qué es eso un problema de residencia?
No en pypi.org. La página de ayuda de PyPI afirma sin rodeos que “PyPI does not support publishing private packages” (PyPI no admite publicar paquetes privados), así que las distribuciones privadas van a un registro o feed privado alojado — con frecuencia la nube de un proveedor en el extranjero — o a un servidor que usted despliega por su cuenta. Esos paquetes privados son código fuente propietario (secretos comerciales) y suelen incorporar credenciales, tokens de API y configuración, a veces datos personales de fixtures de prueba. Concentrados en el extranjero, constituyen una exposición de residencia de datos y de secretos comerciales, y allí donde incorporan datos personales hay una transferencia transfronteriza según la PIPL. La solución limpia es mantener ese almacén dentro del país en un índice privado autoalojado.
¿Puede 21YunBox ayudarnos a operar nuestro índice privado de Python en China de forma conforme?
Sí. Nuestro equipo de China cartografía cuáles de sus paquetes son privados, si incorporan credenciales, tokens o datos personales, dónde está alojado hoy ese registro y cómo resuelve sus dependencias su compilación en China — y después le ayuda a mantener residentes los paquetes privados, los artefactos y los secretos ejecutando un índice privado autoalojado dentro del país (por ejemplo, un devpi, Nexus o Artifactory autogestionado en infraestructura del continente) y apuntando su compilación hacia él, sin abandonar PyPI para las dependencias públicas. A continuación ponemos en marcha la entrega dentro del país, con registro ICP, para la aplicación situada por delante del stack, sin reconstruir. Póngase en contacto para estudiar su caso concreto.
