Por qué 21YunBox Presupuesto Contacto Iniciar sesión
Asesoría (EN) Probar un sitio web para China (EN)

¿Funciona PocketBase en China? Residencia de datos, ICP y reglas transfronterizas

PocketBase es un backend de código abierto que usted mismo ejecuta — un único ejecutable, sin nube gestionada —, así que para China continental la pregunta decisiva es dónde lo despliega, no la velocidad. Alójelo en el extranjero y la base de datos SQLite, los registros de autenticación y los archivos subidos de sus usuarios chinos quedan fuera del país bajo la PIPL; despliéguelo dentro del país y los datos permanecen en suelo chino.

¿Funciona PocketBase en China?

Que pueda usar PocketBase en China es una cuestión de residencia de datos, no de velocidad. PocketBase es un backend de código abierto que usted mismo ejecuta — un único ejecutable sin nube gestionada —, así que su conformidad depende de dónde lo despliegue, no de lo rápido que cargue.

Según la propia documentación del proyecto, PocketBase es “self-hosted only” y “could be deployed by just uploading the executable on your server” (solo autoalojado; se despliega con solo subir el ejecutable a su servidor); todo lo que guarda — una base de datos SQLite integrada, los registros de autenticación de sus usuarios, los archivos subidos y las credenciales S3/SMTP almacenadas — vive en un directorio pb_data en el host que usted elija. Si ese host está en el extranjero, los datos personales de sus usuarios en China quedan fuera del país: una transferencia transfronteriza que regula la PIPL (notificación, consentimiento separado, un mecanismo de transferencia) y, para un operador de infraestructuras de información críticas o un tratante de grandes volúmenes, los datos recogidos en China deben permanecer en el continente (CSL artículo 39 (antes artículo 37)). Despliegue el binario dentro del país y esos datos — y esos secretos — permanecen en suelo chino.

Esto es una imagen de riesgo, no un veredicto — sus obligaciones dependen de sus volúmenes de datos y de su papel. Nuestro equipo de China puede cartografiar con usted su despliegue de PocketBase →

Instantánea de cumplimiento

  • ! No hay nube de PocketBase — es un único binario autoalojado, así que decide dónde lo despliega
  • ! La base de datos SQLite de su aplicación, los registros de autenticación y los archivos subidos están todos en pb_data
  • ! Alójelo en el extranjero y los datos de sus usuarios en China quedan fuera del país — una transferencia transfronteriza según la PIPL
  • ! Los operadores de infraestructuras críticas y los tratantes de grandes volúmenes deben mantener en el país los datos personales de China (CSL artículo 39 (antes 37))
  • ✓ La palanca: desplegar el binario dentro del país y registrar por ICP su aplicación orientada a China
Hablar con nuestro equipo de China

Lo que la documentación oficial de PocketBase dice sobre China

HechoFuente primaria
En palabras de PocketBase: es “completely portable” y “doesn't require any external dependency and could be deployed by just uploading the executable on your server.” No existe ninguna nube gestionada por PocketBase — su FAQ afirma “PocketBase is self-hosted only” —, así que no hay ninguna región de proveedor que elegir, y dónde residen los datos es enteramente decisión del operador: el host en el que despliega el único ejecutable. PocketBase Docs — Going to production, y FAQ, consultado el 2026-10-13
PocketBase almacena los datos de su aplicación en una base de datos SQLite integrada, junto con los registros de autenticación/cuenta de sus usuarios y los archivos que suben, todo dentro de un directorio pb_data en el servidor en el que ejecuta el binario; según la guía de producción, su configuración almacenada incluye incluso “SMTP password and S3 storage credentials.” Despliegue ese binario en un alojamiento en el extranjero y los datos personales de sus usuarios en China — y esos secretos — reposan fuera del país; despliéguelo dentro del país y reposan en China. PocketBase Docs — Going to production (Backup and Restore; Enable settings encryption), consultado el 2026-10-13
Como su instancia de PocketBase guarda las cuentas, los registros y los archivos que usted recoge de usuarios en China — datos personales —, alojarla en el extranjero transfiere esos datos fuera del país. La PIPL regula esa transferencia transfronteriza (artículos 38 a 40): el responsable del tratamiento de los datos personales — usted, el operador, no PocketBase — debe notificar, obtener consentimiento separado y cumplir un mecanismo de transferencia (una evaluación de seguridad de la CAC, el contrato estándar de la CAC o una certificación). PIPL — transferencia transfronteriza de datos personales (artículos 38–40)
Para un operador de infraestructuras de información críticas o un tratante de grandes volúmenes, los datos personales recogidos en China deben almacenarse dentro del continente (PIPL artículo 40; 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 artículo de localización de datos del 37 al 39, sin cambios de fondo). Un despliegue de PocketBase en el extranjero no puede cumplir ese deber; ejecutar el binario en infraestructura dentro del país sí puede, y poner en marcha legalmente una superficie pública en el continente hace entrar en escena un registro ICP. Ley de Ciberseguridad artículo 39 (antes artículo 37); PIPL artículo 40

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

Para una audiencia en China continental, la verdadera pregunta sobre PocketBase no es si carga ni lo rápido que responde — PocketBase es un backend que usted mismo ejecuta, así que eso está enteramente en sus manos —, sino dónde se permite que acaben reposando los datos que guarda. PocketBase es un backend de código abierto distribuido como un único ejecutable: guarda la base de datos de su aplicación, las cuentas y los registros de autenticación que crean sus usuarios y los archivos que suben. No existe ninguna nube gestionada por PocketBase; según la propia FAQ del proyecto, es “self-hosted only” (solo autoalojado). Esa es a la vez la palanca y el riesgo de cumplimiento — como usted elige el servidor, puede mantener los datos de sus usuarios chinos en suelo chino o, si lo despliega en un alojamiento en el extranjero, dejarlos fuera del país. Que el punto de conexión responda es la mitad fácil; dónde se almacenan los datos es la mitad de la que depende la ley.

Documentación «Going to production» de PocketBase que describe el despliegue mínimo: PocketBase es completamente portátil, no requiere ninguna dependencia externa y se despliega subiendo el único ejecutable a su propio servidor — lo que muestra que es un único binario autoalojado sin nube gestionada
La propia guía «Going to production» de PocketBase: PocketBase es “completely portable,” así que “doesn't require any external dependency and could be deployed by just uploading the executable on your server.” (No requiere ninguna dependencia externa y puede desplegarse con solo subir el ejecutable a su servidor.) Es un único binario que usted ejecuta en la infraestructura que elija — así que es usted, y no el menú de regiones de un proveedor, quien decide dónde residen físicamente sus datos. Fuente: pocketbase.io/docs/going-to-production

PocketBase en China de un vistazo

Qué lo decide En los propios términos de PocketBase — y la ley china
Dónde reposan físicamente los datos PocketBase lo guarda todo en un directorio pb_data en el servidor en el que usted despliega el único ejecutable — no en el menú de regiones de un proveedor. Ejecute el binario en el extranjero y los datos reposan fuera del país; ejecútelo en infraestructura dentro del país y reposan en China. Con PocketBase, esa decisión le corresponde a usted.
Qué guarda, y por qué son datos personales Una base de datos SQLite integrada, los registros de autenticación y de cuenta de sus usuarios y los archivos que suben — de modo que los datos personales de las personas en China acaban reposando físicamente dentro de su instancia de PocketBase.
¿Existe una nube gestionada? No. En la propia FAQ de PocketBase, a la pregunta “Do you offer hosting?”, la respuesta es “No. PocketBase is self-hosted only.” No hay ningún SaaS propio ni ninguna región que elegir — y precisamente por eso la residencia está enteramente en manos del operador.
Los registros de sus usuarios en China, conservados en el extranjero Si se despliega en un alojamiento en el extranjero, los datos personales de sus usuarios chinos constituyen una transferencia transfronteriza que regula la PIPL (artículos 38 a 40) — notificación, consentimiento separado y un mecanismo de transferencia.
El deber de almacenamiento dentro del país Un operador de infraestructuras de información críticas o un tratante de grandes volúmenes debe almacenar en el continente los datos personales recogidos en China (PIPL artículo 40; Ley de Ciberseguridad artículo 39 (antes artículo 37)). Un despliegue en el extranjero no puede cumplirlo; uno dentro del país, sí.

Usted elige dónde se ejecuta PocketBase — así que puede mantener los datos en China

La característica que diferencia a PocketBase de un backend gestionado es también la que lo deja preparado para el cumplimiento: usted mismo lo instala y lo ejecuta. Según su propia guía de producción, “one of the best PocketBase features is that it’s completely portable” — “doesn’t require any external dependency and could be deployed by just uploading the executable on your server.” Su FAQ describe lo mismo desde el otro lado: PocketBase se creó “to assist building self-contained applications that can run on a single server,” (para ayudar a construir aplicaciones autocontenidas que puedan ejecutarse en un solo servidor) y, a la pregunta de si ofrece alojamiento, responde sin rodeos que “PocketBase is self-hosted only.” Dicho de otro modo, su backend acaba reposando en la única máquina en la que usted coloca el binario. Dirija esa máquina a infraestructura dentro del país y su base de datos — y los datos personales que contiene — permanece en suelo chino por construcción. Por tanto, la cuestión de la residencia para PocketBase no es «¿hay una región en China?», sino «¿lo hemos desplegado en China?».

Lo que guarda PocketBase son datos personales

PocketBase no es una caché ni un nodo perimetral delante de sus datos — PocketBase son sus datos. Almacena los registros de su aplicación en una base de datos SQLite integrada, junto con los registros de autenticación y de cuenta que crean sus usuarios y los archivos que suben, todo dentro de un único directorio pb_data en el servidor en el que se ejecuta. Para un producto orientado a China, eso significa que los datos personales de las personas del continente residen físicamente allí. Mantenga esa instancia en un alojamiento en el extranjero y, conforme a la Ley de Protección de Información Personal de China, estará realizando una transferencia transfronteriza: el responsable del tratamiento — usted, el operador, no PocketBase — debe notificar, obtener consentimiento separado y cumplir un mecanismo de transferencia, ya sea una evaluación de seguridad de la CAC, el contrato estándar de la CAC o una certificación (PIPL artículos 38 a 40). «Es solo un backend que alojamos» no resuelve nada de eso; llegar a la instancia y estar autorizado para almacenar en ella los datos de usuarios chinos son cuestiones distintas.

Los secretos también residen en el mismo host

Hay una segunda exposición que una comprobación de accesibilidad nunca ve. Según las indicaciones de producción de PocketBase, la configuración de aplicación que almacena incluye “the SMTP password and S3 storage credentials” (la contraseña SMTP y las credenciales de almacenamiento S3) — por eso ofrece una clave de cifrado opcional para ellas — y puede gestionar el inicio de sesión mediante los proveedores OAuth2 que usted active, cuyos secretos de cliente también guarda. Así, el host que usted elige no solo lleva los registros de sus usuarios, sino también las credenciales que PocketBase usa para llegar a sus proveedores de correo y de almacenamiento de objetos. Justamente aquí un motor autoalojado es la palanca y no el lastre: a diferencia de una plataforma en el extranjero cuyo funcionamiento normal llevaría sus datos de China al otro lado de la frontera y concentraría sus secretos fuera del país, PocketBase mantiene los datos regulados y esos secretos juntos en un único lugar que usted controla. Despliegue el binario en el extranjero y ambos quedan fuera del país; despliéguelo dentro del país y ambos permanecen en suelo chino.

Cuánto está en juego depende de su volumen y de su papel

El peso de estos deberes no es uniforme. Según las Disposiciones de la CAC de marzo de 2024 para promover y regular los flujos transfronterizos de datos, un responsable que no sea operador de infraestructuras de información críticas y transfiera datos personales no sensibles de menos de 100.000 personas en un año natural queda exento de la evaluación de seguridad, del contrato estándar y de la certificación — una vía realmente más ligera para una aplicación pequeña. En el otro extremo, un operador de infraestructuras de información críticas o un tratante de grandes volúmenes tiene un deber de residencia de datos: los datos personales recogidos en China deben almacenarse dentro del continente (PIPL artículo 40; 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 artículo de localización de datos del 37 al 39, sin cambios de fondo). Ningún host en el extranjero puede cumplirlo — y como PocketBase es autoalojado, la salida viene de serie: ejecute el binario en infraestructura dentro del continente; poner en marcha legalmente ese despliegue detrás de una superficie pública es lo que hace entrar en escena un registro ICP.

Por qué una comprobación de accesibilidad pasa por alto la verdadera cuestión

Un usuario del continente puede abrir y usar una instancia de PocketBase alojada en el extranjero, así que una prueba de accesibilidad o de latencia dirá «funciona». Pero la accesibilidad es la mitad de entrega, no la mitad jurídica. El incumplimiento que una prueba de conexión nunca puede ver es que los datos regulados están almacenados en el extranjero: la base de datos SQLite, los registros de autenticación, los archivos subidos y las credenciales S3/SMTP almacenadas reposan todos fuera del país, y una instancia en el extranjero no puede contener ni la copia dentro del país que exige un deber de localización ni la base con registro ICP que necesita una superficie pública del continente (Orden n.º 292 del Consejo de Estado; Orden n.º 33 del MIIT). Hacer que la instancia sea simplemente accesible no responde a la pregunta; almacenar los datos y los secretos dentro del país, sí.

Esto es un mapa de riesgo, no un veredicto: si debe un mecanismo de transferencia, almacenamiento dentro del país o ambos depende de los datos que conserva, de sus volúmenes y de a quién pertenecen — conviene concretarlo con asesoría legal antes de construir.

Usted conserva PocketBase como backend. Lo que 21YunBox añade es la capa de cumplimiento que nunca se pensó para aportar por sí solo, organizada alrededor del stack que ya utiliza — sin reconstruir, sin una segunda base de código y sin migrar fuera de PocketBase.

  • Cartografiar. Nuestro equipo de China inventaría lo que contiene su instancia de PocketBase (la base de datos SQLite, los registros de autenticación y de cuenta, los archivos subidos y los secretos S3/SMTP/OAuth almacenados) y dónde se ejecuta el binario, y luego lo contrasta con sus obligaciones de transferencia transfronteriza, de residencia de datos y de localización de datos (infraestructuras críticas) según la PIPL, y con cualquier deber de ICP.
  • Localizar. Donde la ley exige que los datos de sus usuarios en China permanezcan en el continente, le ayudamos a ejecutar el binario de PocketBase en infraestructura dentro del país para que el directorio pb_data — y los secretos con él — estén en China; con la notificación del artículo 13/23 y el consentimiento separado, y con el mínimo posible de datos cruzando la frontera. Localizar significa un despliegue dentro del país, no una ruta de vuelta hacia un punto de conexión en el extranjero.
  • Entregar. Cualquier superficie orientada a China situada delante de su backend — la aplicación, el borde de la API, el panel de administración al que llegan sus usuarios del continente — funciona sobre una entrega dentro del país con registro ICP (el 21YunBox Optimizer), delante del PocketBase desplegado dentro del país.

El resultado funciona de forma legal y conforme para sus usuarios en China. 21YunBox nunca utiliza ni sugiere ninguna forma de elusión. Somos una capa de cumplimiento y un socio de su forma actual de construir, no un competidor ni una migración.

Solicitar una evaluación de cumplimiento →


Lectura relacionada:

Preguntas frecuentes

¿Almacena PocketBase los datos de los usuarios chinos en China?

Depende enteramente de dónde lo despliegue. PocketBase no tiene nube gestionada — es un único binario autoalojado, y su FAQ dice que es “self-hosted only” —, así que sus datos residen allí donde ejecute el ejecutable. Despliéguelo en un alojamiento en el extranjero y la base de datos SQLite, los registros de autenticación y los archivos subidos quedan fuera del país; despliéguelo en infraestructura dentro del país y permanecen en suelo chino.

¿Es ilegal usar PocketBase en China?

No de por sí. Como PocketBase es autoalojado, el software en sí no tiene nada de ilícito — las cuestiones son dónde lo aloja y qué datos guarda. Alojar en el extranjero una instancia orientada a China supone una transferencia transfronteriza de datos personales, que la PIPL permite si usted notifica, obtiene consentimiento separado y cumple un mecanismo de transferencia; si además debe almacenamiento dentro del país depende de su papel (por ejemplo, si es operador de infraestructuras de información críticas) y de sus volúmenes de datos. Trátelo como un riesgo que evaluar con asesoría legal, no como una prohibición general.

¿Puede 21YunBox ayudarnos a que nuestro stack de PocketBase sea conforme en China?

Sí. Nuestro equipo de China puede cartografiar su exposición transfronteriza y de residencia de datos según sus volúmenes de datos y su papel, ayudarle a ejecutar PocketBase en infraestructura dentro del país para que los datos y los secretos que almacena permanezcan en el continente, y poner en marcha la entrega dentro del país, con registro ICP, que necesita una superficie pública en China. Póngase en contacto para analizar su caso concreto.

Artículos sobre PocketBase