Qué significa "almacenamiento de archivos CDN"
La mayoría de las CDN funcionan en modo Pull: el edge conserva tu servidor de origen existente y obtiene (pull) el contenido desde ahí a medida que los visitantes lo piden. Eso está genial cuando ya tienes un sitio web funcionando. Pero si solo tienes archivos que servir — un logo, un PDF, una descarga, un vídeo, los assets compilados de una app — levantar y mantener un servidor de origen solo para eso es excesivo.
El almacenamiento de archivos CDN funciona al revés. En lugar de apuntar la CDN a tu servidor, guardas los archivos en la propia CDN y los sirves directamente desde el edge. La CDN es el origen. No hay ningún servidor que tengas que ejecutar, parchear o escalar: subes un archivo, obtienes una URL, y cada visitante recibe el archivo desde una ubicación edge cercana por HTTPS. Esto es lo que se quiere decir con "servir archivos desde una CDN" o "cdn origin storage" — la CDN guarda el archivo y lo entrega.
Opción A — subir desde el panel (sin CLI)
La forma más simple es directamente desde el panel de cdn.com.tr. Abre el área Files de tu cuenta, sube los archivos que quieras servir y organízalos en carpetas como en cualquier gestor de archivos normal. No hay nada que instalar ni que configurar: la subida llega directamente al almacenamiento CDN de tu cuenta.
Una vez subido, el archivo se sirve a través de la CDN mediante su URL, se cachea en el edge y queda cubierto por SSL automático, así que el enlace es HTTPS desde el primer momento. Este es el camino adecuado cuando tienes un puñado de archivos, cuando quieres verlos y gestionarlos de forma visual, o cuando no eres de los que viven en una terminal. Para subidas masivas, pasos repetibles o automatización, la CLI de abajo es más rápida.
Opción B — la CLI cdnctl (funciona como scp)
cdnctl es la herramienta de línea de comandos del operador para cdn.com.tr, y hace que subir archivos se sienta como usar scp. Primero, inicia sesión una vez y elige tu cuenta para que cada comando sepa dónde colocar las cosas: ejecuta cdnctl login --email you@example.com --password ... (o cdnctl configure --endpoint https://cdn.com.tr --token <token> si usas un token de API), y luego cdnctl accounts use <account_uuid> para fijar la cuenta por defecto. A partir de ahí, los comandos con alcance de cuenta simplemente funcionan.
Para subir archivos, usa cp igual que scp — primero la ruta local, después la remota: cdnctl cp ./logo.png images/logo.png coloca un solo archivo en images/logo.png dentro de tu almacenamiento CDN. Añade -r para enviar un directorio completo: cdnctl cp -r ./dist assets/ sube cada archivo bajo ./dist dentro de assets/. Pasa --force para sobrescribir archivos que ya existan. También puedes apuntar a una cuenta concreta en línea con account_uuid:remotepath si no has fijado una cuenta por defecto.
Si prefieres subcomandos explícitos, el grupo files hace el mismo trabajo e imprime JSON que puedes parsear en scripts: cdnctl files put --file ./logo.png --target-path images/logo.png [--force] sube un archivo, cdnctl files ls [--path <path>] lista lo que hay almacenado, cdnctl files mkdir --path <path> crea una carpeta, y cdnctl files rm --path <path> --yes elimina algo. Es el mismo almacenamiento que el panel, solo que manejado desde tu terminal.
Cuándo usar object storage compatible con S3 en su lugar
El almacenamiento de archivos es la forma más simple de alojar y servir archivos estáticos y medios a través de la CDN. Cuando necesitas más — buckets, access keys, o manejar subidas de forma programática con herramientas S3 existentes — recurre a object storage compatible con S3, respaldado por Ceph RGW.
Con cdnctl creas un bucket con cdnctl object-storage buckets create --account <uuid> --name <bucket>, los listas con cdnctl object-storage buckets list --account <uuid>, y generas access key y secret key de S3 con cdnctl object-storage access-keys create --bucket <bucket_uuid>. A partir de ahí, cualquier cliente o SDK compatible con S3 puede leer y escribir en el bucket. También puedes vincular un bucket directamente a una container app para que llegue como variables de entorno — cdnctl object-storage bindings create ... --env-prefix S3 —, que es la forma limpia de darle a una app su propio almacenamiento. Regla práctica: almacenamiento de archivos para alojar y servir archivos por la CDN; object storage cuando quieras buckets, keys, acceso programático/S3, o almacenamiento que respalde una app.
Entrega, caché y purge
Los archivos que guardas en la CDN se sirven desde el edge y se cachean ahí, de modo que las peticiones repetidas se responden desde una ubicación cercana al visitante en lugar de viajar hasta un único origen. Cada URL servida obtiene HTTPS automático, así que tus enlaces son seguros sin que tengas que gestionar certificados.
Algo que conviene recordar con el cacheo en el edge: cuando sobrescribes un archivo con una nueva versión, la copia antigua puede seguir cacheada en el edge durante un tiempo. Si reemplazas un archivo y necesitas que el cambio esté disponible de inmediato, haz un purge (desde el panel o la API) para que el edge obtenga la copia nueva. Un patrón habitual para evitar esto por completo es incluir una versión en el nombre del archivo o en la ruta — logo.v2.png, o assets bajo un build hash — de modo que un archivo nuevo tenga una URL nueva y nunca choque con una copia cacheada.
CI y automatización con cdnctl
Como cdnctl es una única herramienta de línea de comandos que se autentica con un token, encaja perfectamente en CI/CD. Un paso de build típico se autentica una vez (cdnctl configure --endpoint https://cdn.com.tr --token <token> y cdnctl accounts use <uuid>), y luego sube los assets recién compilados: cdnctl cp -r ./dist assets/ --force. Tu pipeline sube los artefactos, el edge los sirve, y nunca vuelves a copiar archivos a mano.
El mismo enfoque sirve para publicar una nueva descarga, rotar un asset de marketing, o desplegar la salida de un sitio estático en cada commit — todo scriptable, todo repetible, sin ningún servidor de origen que mantener vivo.
Qué sirve la gente desde el almacenamiento CDN
Aloja logos, fotos de producto, vídeo y audio en la CDN y sírvelos rápido desde el edge — sin servidor de medios que mantener.
Pon instaladores, PDFs y archivos de release en el almacenamiento y reparte enlaces de descarga rápidos por HTTPS que escalan bajo demanda.
Sube el JS, CSS e imágenes de un build desde CI con cdnctl cp -r y sirve todo el paquete estático desde el edge.
Preguntas frecuentes sobre almacenamiento de archivos CDN
¿Necesito mi propio servidor para servir archivos desde la CDN?
No. Con el almacenamiento de archivos CDN, la propia CDN es el origen: subes archivos a tu cuenta y se sirven desde el edge. No hay ningún servidor de origen que tengas que ejecutar, parchear o escalar.
¿Cómo subo archivos — desde el panel o la línea de comandos?
Ambas vías usan el mismo almacenamiento. Usa el área Files del panel para una subida visual y sin código, o la CLI cdnctl cuando quieras automatizarlo con scripts. cdnctl cp funciona como scp: cdnctl cp ./logo.png images/logo.png para un archivo, o cdnctl cp -r ./dist assets/ para una carpeta entera.
¿Cuál es la diferencia entre file storage y object storage?
File storage es la forma más simple de alojar y servir archivos estáticos y medios a través de la CDN. Object storage es compatible con S3: obtienes buckets y access keys y puedes usar herramientas S3 estándar o vincular un bucket a una app. Usa file storage para servir archivos; usa object storage cuando necesites buckets, keys o acceso programático.
Reemplacé un archivo pero sigue mostrándose el antiguo — ¿por qué?
Los archivos servidos se cachean en el edge, así que un archivo sobrescrito puede seguir sirviendo la copia antigua hasta que la caché se actualice. Haz un purge del archivo después de sobrescribirlo, o incluye una versión en el nombre o la ruta para que la nueva versión tenga una URL nueva.
¿Las URLs de los archivos se sirven por HTTPS?
Sí. Los archivos servidos a través de la CDN obtienen SSL automático, así que sus URLs son HTTPS sin ningún certificado que tengas que gestionar.