---
title: Cloudflare Workers for nybegynnere · Digitalt kompass
description: "Cloudflare Workers og Assets forklart rolig: publisere statisk side, redirect og /api/subscribe. Norsk guide fra HoliSti og Snarveien Del 7."
url: "https://digitaltkompass.holisti.no/bibliotek/cloudflare-workers"
---

# Cloudflare Workers for nybegynnere

Cloudflare Workers er lite kode som kjører på Cloudflare edge: redirect www, håndtere API som subscribe, og levere statiske filer fra Assets. Det er deploy-laget for egen maskin uten egen server.

Passer for deg hvis du følger Snarveien og vil forstå hva skjer når du «deployer til Cloudflare», ikke bare kopierer wrangler-kommando.

Bra om du har domene på Cloudflare, har kjørt build lokalt, og er klar for Snarveien Del 7 publiser. Du trenger ikke å forstå alt på forhånd, bare følge steglisten én gang.

## Workers vs. «vanlig hosting»

Tradisjonelt: server som alltid kjører. Workers: funksjoner som kjører ved forespørsel. For statisk side + lite API er det ofte enklere og billigere enn VPS.

Cloudflare Assets holder dist/ fra Vite build. Worker kjører først (run_worker_first) for redirect og API.

## Typiske oppgaver i stacken jeg dokumenterer

- **301** www og http → https canonical host.

- **/api/subscribe** → MailerLite (se [MailerLite-oppsett](/bibliotek/mailerlite-oppsett)).

- **AI/markdown**: valgfritt markdown for assistenter (Stien ut).

- **404**: not_found_handling med egen 404-side.

## wrangler og deploy

wrangler.jsonc definerer Worker-navn, assets, routes. wrangler deploy etter npm run build. CI på Cloudflare Workers Builds bruker monorepo-script med override per app (stienut, snarveien, hub).

Snarveien Del 7 ([publiser](https://snarveien.holisti.no/stien/publiser)) er handholdt første deploy.

## Secrets

API-nøkler settes med wrangler secret put, ikke i git. Lokalt: .env for dev middleware. Samme subscribe-modul begge steder.

## Slik så det ut hos meg

stienut.holisti.no, snarveien.holisti.no og hub deployes som separate Workers med egne wrangler-filer. Subscribe-logikk deles fra lib/subscribe.mjs. Første gang var forvirrende. Nå er mønsteret gjentakbart.

Prerender + Assets gir SEO HTML per route. Worker gir kontroll uten å miste statisk hastighet.

## Med AI

Cloudflare Workers feilsøk:
Worker: [navn]
Problem: [deploy feiler / subscribe 500 / redirect loop]
wrangler.jsonc snippet: [lim inn config UTEN secrets]
Hva sjekke? Norsk, steg for steg.

## html_handling og canonical

Jeg bruker drop-trailing-slash slik canonical uten skråstrek er konsistent. Redirect www og http til https host. Små detaljer, men de påvirker hvilken URL Google og AI lagrer.

## Lokal vs prod

npm run dev for UX. npm run build og statisk server eller wrangler for prerender-sjekk. Ikke stol på Vite preview for title per path.

## Første deploy-sjekkliste

Før du sier «live»: build uten feil, wrangler deploy fullført, https fungerer, www redirecter, test subscribe med egen e-post, sjekk én dyp route for riktig title i kildekoden. Én time sjekkliste slår panikk neste morgen.

Hvis subscribe feiler i prod men virker i dev: sammenlign secrets og group ID. Det er klassikeren.

## Når du ikke trenger Worker ennå

Første grunnmur på Stien ut kan bruke enklere hosting eller mal. Worker blir relevant når du vil egen API, redirect-disiplin og samme stack som Snarveien. Ikke last deg med Worker før du har noe å deploye.

## Vanlige spørsmål

### Er Workers gratis?

Gratisnivået dekker mye for små sider. Sjekk Cloudflare priser når trafikk vokser.

### Må jeg bruke Workers for Stien ut?

Stien ut i prod bruker Worker. Første grunnmur kan være enklere hosting til du er klar for Snarveien.

### Hva er Assets?

Statiske filer fra build, servert via Cloudflare med HTML-håndtering for trailing slash.

[Gå til Snarveien](https://snarveien.holisti.no)