Files
StarPunk/docs/design/v2.18.3/2026-11-12-webmention-skip-hosts.md
T
PhilandClaude Opus 5.5 b9e5321df2 fix: don't send webmentions to this site or WEBMENTION_SKIP_HOSTS (v2.18.3)
Links to the site itself, and to self-hosted apps like Gitea, timed out
from inside the container and sat in the admin Log. They are now skipped
when queueing; already queued or failed ones are dropped at worker start.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-12 13:40:27 -07:00

1.7 KiB

v2.18.3: Don't send webmentions to this site or skipped hosts

Why

The admin Log showed two sends that could never succeed, both "timed out":

  • a note linking to https://starpunk.thesatelliteoflove.com/ (this site),
  • a note linking to a Gitea repository on git.thesatelliteoflove.com.

From inside the container both names resolve to the server's public address, which isn't reachable from there (no NAT hairpinning). Routing them to the internal proxy with extra_hosts wouldn't help: the SSRF guard blocks private addresses. And neither target wants the webmention: StarPunk only takes webmentions for its posts, and Gitea advertises no endpoint.

What changed

Area Change
Config WEBMENTION_SKIP_HOSTS (comma-separated, lowercased)
Sender webmention_sender.skipped_hosts(config) = SITE_URL's host + the setting; is_skipped(url, hosts) matches the exact host, any port. queue_webmentions_for_note drops those links before the 10-link cap, and from re-sends on update
Worker _send_webmention marks a skipped target no_endpoint without fetching it (rows queued before the setting changed). At startup _drop_skipped_targets does the same for pending and failed rows, so they leave the Log
Settings A Webmentions section lists the skipped hosts

no_endpoint with last_error = "Not sent: …" is used rather than a new status because webmention_queue.status has a CHECK constraint; changing it would mean rebuilding the table. The Log only lists pending and failed.

Exact host matching is deliberate: skipping thesatelliteoflove.com should not skip its subdomains, or the reverse.

Tests

tests/test_webmention_skip_hosts.py.