4.0 KiB
4.0 KiB
Cloudflare Pages & Workers Setup — Linear Void
Linear Void uses two Cloudflare products:
| Product | Purpose | What |
|---|---|---|
| Pages | Static SPA hosting | Vite-built frontend (frontend/dist) deployed via Git integration or Direct Upload |
| Workers | Edge cache logic | infrastructure/cloudflare/worker.js — adds immutable cache headers to HLS segments |
Both are managed under Workers & Pages in the Cloudflare dashboard.
Dashboard URLs
| Resource | URL |
|---|---|
| Workers & Pages overview | https://dash.cloudflare.com/deb11491c54ec53a24772e98ac6d8128/workers-and-pages |
| Worker: linearvoid | https://dash.cloudflare.com/deb11491c54ec53a24772e98ac6d8128/workers/services/view/linearvoid/production/settings |
| Pages project | https://dash.cloudflare.com/deb11491c54ec53a24772e98ac6d8128/pages/view/linearvoid |
| API tokens | https://dash.cloudflare.com/profile/api-tokens |
Worker: linearvoid (edge cache headers)
The Worker at infrastructure/cloudflare/worker.js runs on the linearvoid Workers service. It intercepts requests and adds immutable Cache-Control headers to .m4s segment files.
Deploy via Wrangler CLI:
npx wrangler deploy infrastructure/cloudflare/worker.js
Or paste into the Workers dashboard at the URL above (Quick Edit).
Pages: Static frontend
Direct Upload via Gitea Actions
Use .gitea/workflows/pages-deploy.yml to build in Gitea Actions and upload via the Cloudflare API.
See gitea-cloudflare-pages.md for the workflow.
Variables and secrets
On Cloudflare pages, set the following environment variables (needed to run the frontend)
| Type | Name | Value |
|---|---|---|
| Secret | ADMIN_PASSWORD | not-a-real-admin-password |
| Plaintext | ADMIN_SESSION_TTL_HOURS | 12 |
| Plaintext | ADMIN_USERNAME | boogers |
| Plaintext | HLS_SEGMENT_DURATION | 6 |
| Plaintext | HLS_WINDOW_SIZE | 24 |
| Plaintext | PLAYLIST_PATH | /app/playlist/playlist.txt |
| Plaintext | VITE_PUBLIC_ADMIN_DEFAULT_MODERATOR | boogers |
| Plaintext | VITE_PUBLIC_ADMIN_DEFAULT_ROOM | main |
| Plaintext | VITE_PUBLIC_ADMIN_MODERATION_LOG_LIMIT | 50 |
| Plaintext | VITE_PUBLIC_APP_URL | https://linearvoid.tv |
| Plaintext | VITE_PUBLIC_HLS_URL | https://media.linearvoid.tv/hls/playlist.m3u8 |
| Plaintext | VITE_PUBLIC_WS_URL | wss://linearvoid.tv/ws |
Custom domains
linearvoid.tv→ Pages projectwww.linearvoid.tv→ redirect tolinearvoid.tvmedia.linearvoid.tv→ R2 bucket (separate; not Pages)