Cloudflare R2 Setup - softerfish/fyuhls GitHub Wiki

Cloudflare R2 Setup

Use this page when fyuhls will store files on Cloudflare R2.

What to prepare

  • R2 bucket
  • access key ID
  • secret access key
  • account ID
  • bucket name
  • public URL or delivery strategy if you plan to expose public objects directly

In fyuhls

  1. Open Storage Nodes.
  2. Add an R2-backed node.
  3. Enter the bucket and credentials carefully.
  4. Test the connection.
  5. Confirm the endpoint and public URL behavior match your intended delivery path.

Important habits

  • align CORS with your real site origin
  • keep public and private object strategies clear in your head before testing downloads
  • if you use CDN-like public delivery, confirm the base URL and file visibility model together

Why this matters

R2 setups can look like generic upload or download bugs when the real cause is:

  • CORS mismatch
  • wrong account or bucket details
  • public URL mismatch
  • assuming public object behavior for files that still need app-controlled or signed-origin delivery

Related pages

⚠️ **GitHub.com Fallback** ⚠️