mirror of
https://seed.radicle.dev/rad:z4V1sjrXqjvFdnCUbxPFqd5p4DtH5.git
synced 2026-10-27 07:30:34 +08:00
60 lines
1.8 KiB
Markdown
60 lines
1.8 KiB
Markdown
# Open Graph
|
|
|
|
Worker on `open-graph.radicle.network` that serves OG meta tags and
|
|
preview card images for social media embeds.
|
|
|
|
## How it works
|
|
|
|
`radicle.network` is a plain static SPA. A Cloudflare Redirect Rule
|
|
302s social media crawlers to `open-graph.radicle.network`, which
|
|
returns HTML with OG tags. The `og:image` points to `/cards/...` on
|
|
the same domain, where the worker renders PNG cards via Satori + resvg-wasm.
|
|
|
|
Browsers and search crawlers hit the SPA directly — no worker cost.
|
|
|
|
## Routes
|
|
|
|
- `/*` — OG HTML with meta tags (cached 2 hours)
|
|
- `/cards/*` — PNG card images (cached 2 hours)
|
|
|
|
Card routes mirror app routes: `/cards/nodes/:host/:rid`,
|
|
`/cards/nodes/:host/:rid/issues/:id`, etc. When API fetches fail,
|
|
cards degrade: specific item -> repo -> node -> home.
|
|
|
|
## Cloudflare Redirect Rule
|
|
|
|
**Rules > Redirect Rules** on the `radicle.dev` zone:
|
|
|
|
```
|
|
(http.host eq "radicle.network") and (
|
|
(http.user_agent contains "Twitterbot") or
|
|
(http.user_agent contains "facebookexternalhit") or
|
|
(http.user_agent contains "Facebot") or
|
|
(http.user_agent contains "LinkedInBot") or
|
|
(http.user_agent contains "Slackbot") or
|
|
(http.user_agent contains "Discordbot") or
|
|
(http.user_agent contains "TelegramBot") or
|
|
(http.user_agent contains "WhatsApp") or
|
|
(http.user_agent contains "Pinterestbot") or
|
|
(http.user_agent contains "ZulipURLPreview") or
|
|
(http.user_agent contains "Bluesky Cardyb") or
|
|
(http.user_agent contains "Mastodon")
|
|
)
|
|
```
|
|
|
|
Dynamic 302 to `concat("https://open-graph.radicle.network", http.request.uri.path)`
|
|
|
|
## Rate Limiting
|
|
|
|
**Security > WAF > Rate limiting rules** on the `radicle.network` zone:
|
|
|
|
Verified bots are rate limited to 50 requests per 10 seconds across
|
|
all of `radicle.network`, with a 1 minute block.
|
|
|
|
## Deploy
|
|
|
|
```sh
|
|
npm run deploy:open-graph # worker
|
|
npm run start:open-graph # local dev
|
|
```
|