Bot protection & link safety
Operator guide
Bot protection & link safety
Two admin-controlled settings protect your node from automated abuse and malicious links. Both are free, self-hosted and privacy-friendly.
ALTCHA (bot protection)
Settings → Bot Protection — ALTCHA is a self-hosted, cookie-free proof-of-work challenge shown on the registration and password-reset forms. It raises the cost of automated sign-ups without fingerprinting users.
| Setting | Meaning |
|---|---|
| Enabled | Show the challenge on guest forms |
| Secret | HMAC secret (use Generate to auto-create) |
| Algorithm | PBKDF2/SHA-256 (bundled) or Argon2id (needs a client worker) |
| Cost | Work factor (higher = harder for bots, slower for users; 50000 is a sane default) |
| Expires | Seconds a challenge stays valid |
Enable it to slow spam registrations. The widget is self-hosted — no third party sees your visitors.
Link safety
Settings → Link Safety — every URL attached to a post is checked against enabled sources before the post is published/clicked.
| Source | What it catches | Cost |
|---|---|---|
| Spamhaus DBL | DNS blocklist: spam, phishing, malware, botnets | Free, open data |
| URLhaus / abuse.ch | URL-level malware distribution list | Free, open data |
| Local heuristics | On-node suspicious patterns (e.g. denylisted domains) | Free |
| Google Safe Browsing | v4 lookup (non-commercial only) | Free tier, opt-in |
Denylist domains: one per line — domains you always treat as suspicious.
Recommended defaults
ALTCHA_SECRET=<generated> # or Generate in the admin panel
GOOGLE_SAFE_BROWSING_KEY= # leave empty unless you need it
Enable ALTCHA, Spamhaus, URLhaus and local heuristics for a good baseline with zero cost.
Related
Still stuck? Contact the node administrator.