Unos 5 minutos
Cómo usar Aktar con Cloudflare R2
Cloudflare R2 encaja muy bien con Aktar: no cobra por el tráfico de salida, tiene un nivel gratuito que cubre la mayoría de los usos con capturas de pantalla y ofrece dominios personalizados servidos a través de la red de Cloudflare. Aktar incluye un ajuste predefinido para R2, así que solo necesitas tu Account ID, un token de API y un bucket.
Qué necesitas
- Una cuenta de Cloudflare con R2 activado
- Un dominio en Cloudflare si quieres enlaces con tu propio dominio (opcional)
- Aktar instalada en tu Mac
Paso a paso
- 1
Crea un bucket
En el panel de Cloudflare, abre R2 Object Storage y haz clic en Create bucket. Elige un nombre corto, como
screenshots, y deja la ubicación automática. - 2
Dale al bucket una dirección pública
Abre los Settings del bucket. En Custom Domains, conecta un dominio o subdominio que gestiones en Cloudflare, por ejemplo
files.example.com. Es la mejor opción para el uso real.Para una prueba rápida puedes activar en su lugar la Public Development URL (
pub-….r2.dev). Cloudflare limita la frecuencia de peticiones a esa URL y no la recomienda para producción. - 3
Crea un token de API
De vuelta en la página de resumen de R2, abre Manage API tokens y crea un token con permiso Object Read & Write, limitado a tu bucket. Copia el Access Key ID y el Secret Access Key: el secreto solo se muestra una vez.
Tu Account ID aparece en esa misma página, y también es la primera parte del endpoint S3
https://<ACCOUNT_ID>.r2.cloudflarestorage.com. - 4
Añade el destino en Aktar
Abre Settings → Destinations → Add Destination en Aktar, elige Cloudflare R2 y rellena los campos con los valores de la tabla de abajo. Aktar obtiene el endpoint a partir de tu Account ID.
- 5
Prueba y guarda
Haz clic en Test Connection. Aktar sube un pequeño archivo de prueba, comprueba que es accesible a través de tu dirección pública y lo vuelve a eliminar. Cuando todo esté en verde, haz clic en Save y suelta tu primer archivo en el icono de la barra de menús.
Ajustes en Aktar
Introduce estos valores en Settings → Destinations → Add Destination. Los nombres de los campos coinciden con los de la app.
| Campo | Valor de ejemplo |
|---|---|
| Provider | Cloudflare R2 |
| Profile Name | PersonalEl nombre que quieras. |
| Account ID | 3f9a71c0e2b8…De la página de resumen de R2. |
| Region | autoDeja el valor predeterminado. |
| Access Key ID | a1b2c3d4…Del token de API de R2. |
| Secret Access Key | ••••••••Se guarda en el llavero de macOS. |
| Bucket | screenshots |
| Public Base URL | files.example.comTu dominio personalizado o la URL r2.dev. |
| Object Path | {year}/{month}/{uuid}.{ext}Opcional, consulta nombres de archivo y carpetas. |
Consejos
- Limita el token de API al único bucket que usa Aktar. Si el token se filtra alguna vez, no queda nada más expuesto.
- Cloudflare almacena en caché los dominios personalizados, así que los enlaces populares cargan rápido en todo el mundo sin coste adicional.
- ¿Quieres carpetas ordenadas? Cambia la ruta del objeto, por ejemplo a
shots/{date}/{filename}-{random}.{ext}. Consulta nombres de archivo y carpetas.
Solución de problemas
El enlace devuelve Access Denied o 403
Asegúrate de que la Public Base URL sea tu dominio personalizado o la URL r2.dev. El endpoint …r2.cloudflarestorage.com es solo para la API y nunca sirve archivos públicos. Más información en errores Access Denied.
Test Connection dice que las credenciales no son válidas
Usa el Access Key ID y el Secret Access Key del token de API de R2, no un token de API normal de Cloudflare ni tu Global API Key. Comprueba que el Account ID no tenga espacios de más.
Las subidas funcionan, pero los enlaces van lentos o tienen límite de peticiones
Probablemente estés usando la URL de desarrollo r2.dev. Conecta un dominio personalizado para el uso en producción.
¿Sigues atascado?Consulta las preguntas frecuentes o pregunta en GitHub.