mirror of
https://github.com/4ev-link/4ev.link.git
synced 2026-01-13 16:18:05 +00:00
43 lines
1.3 KiB
Markdown
43 lines
1.3 KiB
Markdown
# 4ev.link
|
||
|
||
A minimalist, permanent URL shortener that runs entirely on Cloudflare's edge network.
|
||
No servers to maintain, no cron jobs, no expiration dates.
|
||
|
||
|
||
|
||
## What it does
|
||
|
||
- Turns long URLs into short, memorable aliases such as 4ev.link/github
|
||
- Lets every account reserve custom slugs
|
||
- Serves redirects from Cloudflare's global edge—usually under 50 ms
|
||
- Costs nothing on the free tier (1 M requests + 1 GB KV reads / month)
|
||
|
||
|
||
|
||
## Tech stack
|
||
|
||
- **Cloudflare Workers** – serve requests at the edge
|
||
- **D1 (SQLite)** – store user hashes and slug lists
|
||
- **KV** – key/value lookups for lightning-fast redirects
|
||
- **reCAPTCHA v2** – stop bots from burning your quota
|
||
|
||
|
||
## Security notes
|
||
|
||
- Client-side scrypt stretching (N=16384, r=8, p=1, 32 B) before the request ever leaves the browser
|
||
- All write endpoints require a fresh reCAPTCHA token
|
||
- Reserved-word blacklist prevents hijacking of paths such as api, dash, admin, etc
|
||
|
||
## Limits on Cloudflare free tier
|
||
|
||
- 100 000 Worker requests/day
|
||
- 1 GB KV reads/day
|
||
- 1 GB KV writes/month
|
||
- 1 GB D1 storage
|
||
|
||
For personal or small-team usage this is effectively unlimited.
|
||
|
||
## Contributions
|
||
|
||
Issues and pull requests are welcome. Open a private security advisory first if you find anything sensitive.
|