Server/Links

Server-seitiges Addon secretary-server-links zum Prüfen gespeicherter Links in VJOURNAL-Einträgen unter /links/.

Zweck

Prüft X-LINK-URLs aller VJOURNALs im /links/-Namespace
Aktualisiert Status, Hash-Werte und Fehlerinformationen
Markiert Änderungen (X-LINK-CHANGED) und speichert Defekte (X-LINK-LAST-ERROR)
Führt Retries bei vorübergehenden Abruffehlern durch
Wird vom Secretary Server im User-Kontext periodisch gestartet (kein eigenes systemd-Unit)

Namespace: /links/ (CalDAV-artig, VJOURNAL)
Collections unter /links/<collection>/ (z. B. main)
VJOURNAL-Einträge enthalten Link-Informationen (URL, Titel etc.) mit X-LINK-Properties
Properties u.a.: X-LINK-URL, X-LINK-LAST-CHECKED, X-LINK-LAST-ERROR, X-LINK-HASH, X-LINK-CHANGED

[links]-Sektion in secretary-server.toml:

active (bool, Default: false) – aktiviert das Addon
interval (humantime, Default: "30m") – Abstand zwischen Läufen, erster Lauf sofort nach Serverstart
timeout_secs (u64, Default: 30) – HTTP-Timeout pro Abruf
touch_last_checked (bool, Default: false) – X-LINK-LAST-CHECKED bei jedem Lauf aktualisieren
retries (usize, Default: 2) – Wiederholungen bei vorübergehenden Abruffehlern (Transportfehler, HTTP 408/425/429/5xx)
insecure_tls (bool, Default: false) – TLS-Zertifikatsprüfung abschalten (nur für interne Dienste)
user_agent, max_body_chars, prune_* – weitere Optionen (von jeweiliger Binärdatei gelesen)

2026-10-09: Version 0.34.0 – insecure_tls hinzugefügt
2026-10-09: Version 0.33.0 – Retries, Baseline-Schreiben, Flag-Rücksetzung bei unverändertem Inhalt
2026-10-08: Version 0.31.0 – defekte Links als X-LINK-LAST-ERROR markiert statt Lauf-Fehler
2026-10-08: Version 0.29.0 – humantime-Format für interval
2026-10-08: Version 0.28.0 – ins Server-Addon-System integriert
2026-10-07: Version 0.25.0 – Links-Namespace aktiviert, RRULE-Endpoint