Reference on vanityURLs

Analytics

Mon, 01 Jan 0001 00:00:00 +0000

Les analytics vanityURLs s’exécutent dans le Cloudflare Worker. Elles ne demandent pas de JavaScript de tracking navigateur, de cookies ou de compte visiteur.

Cloudflare Web Analytics et Real User Measurement (RUM) ne font pas partie du baseline vanityURLs. Gardez Cloudflare RUM désactive sauf si un opérateur veut explicitement de la telémetrie navigateur en dehors du modèle d’événements serveur du redirecteur.

Le Worker envoie les analytics avec ctx.waitUntil().¹ Les redirections et les pages devraient continuer à répondre même si le fournisseur analytics est lent ou indisponible.

Marque

Mon, 01 Jan 0001 00:00:00 +0000

Les normes de marque vanityURLs vivent maintenant sur brand.vanityurls.link. Utilisez ce site pour les regles de logo, couleurs, typographie, badges, interface produit et assets.

La marque contrôle le wordmark public et la courte ligne sous les pages publiques générées. Ces valeurs vivent dans custom/v8s-site-config.json et sont appliquées au build, donc une instance de marque normale n’a pas besoin de copier les pages par défaut dans custom/public/.

Vous pouvez personnalisér pendant npm run setup ou en mettant à jour manuellement les fichiers dans custom/.

Aide-mémoire

Mon, 01 Jan 0001 00:00:00 +0000

Utilisez cet aide-mémoire lorsque vous connaissez déjà le produit et voulez retrouver rapidement la bonne action. La page est conçue pour l’écran et pour l’export PDF depuis le navigateur.

Workflow quotidien

Besoin	Action / fichier	Notes
Installer	`npm install`	À lancer après checkout ou changement de dépendances.
Démarrer localement	`npm run dev`	Lance le Worker avec Wrangler pour les tests locaux.
Valider	`npm run check`	Construit et vérifie les artefacts runtime avant déploiement.
Déployer	`git push`	GitHub et Cloudflare publient le Worker automatiquement.

Dépôts

Surface	Dépôt	Déploie vers
Redirecteur	`vanityURLs/code`	`https://VanityURLs.link`
Documentation	`vanityURLs/website`	`https://www.VanityURLs.link`
Sorties générées	`build/`, `src/`	Ne pas modifier directement.

Fichiers clés

Fichier	Utilisation	Responsable
`custom/v8s-links.txt`	Liste des redirections éditée à la main.	Instance
`custom/v8s-site-config.json`	Marque, contacts, langues, fuseau horaire.	Instance
`custom/v8s-policies.json`	Domaines permis, domaines bloqués, politique de mots-clés.	Instance
`defaults/`	Baseline produit copiée ou fusionnée par le build.	Produit

Format d'un lien

Champ	Exemple	Notes
Slug	`docs`	Segment public. Gardez-le lisible et durable.
Cible	`https://example.com/docs`	URL de destination après contrôles de politique.
État	`active`	Détermine si la redirection doit résoudre.
Métadonnées	`title`, `owner`, `notes`	Aide la revue, l'audit, le tableau de bord et le transfert.

Horaires

Besoin	Syntaxe	Notes
Cible temporaire	`@schedule`	Indentez les blocs sous la ligne du lien.
Fuseau horaire	`America/Toronto`	Utilisez les noms IANA acceptés par le runtime.
Liens exacts	`/launch`	Les horaires s'appliquent aux liens exacts, pas aux namespaces splat.
Repli	Cible de la ligne	La cible normale reste utilisée hors des fenêtres horaires.

Comportement

Entrée	Comportement	À vérifier
Slug actif connu	Redirige vers la cible.	Confirmez la cible et la politique.
Slug inactif ou expiré	Affiche la page de statut correspondante.	Revoyez l'état, les dates et le registre généré.
Destination bloquée	Ne redirige pas.	Vérifiez la politique source et la blocklist générée.
Chemin inconnu	Retourne le comportement introuvable.	Vérifiez le slug et les routes générées.

Personnaliser

Objectif	Utiliser	Éviter
Changer les liens	`custom/v8s-links.txt`	Modifier `build/v8s.json`.
Marquer les pages	`custom/v8s-site-config.json`	Copier les templates complets sans besoin.
Surcharger des assets	`custom/public/`	Changer les defaults produit pour une instance.
Changer le Worker	`scripts/workers/`	Modifier le `src/` généré.

Dépannage

Symptôme	Vérifier	Correctif probable
OK localement, pas en ligne	Action GitHub et statut de déploiement Worker.	Poussez, attendez le déploiement, retestez.
Lien absent	`build/v8s.json` généré.	Corrigez la ligne source, puis rebuildez.
Mauvaise langue	Langues configurées et surcharges localisées.	Ajoutez la page localisée ou utilisez le fallback.
Horaire surprenant	Fuseau horaire opérateur et fenêtre de dates.	Utilisez des noms IANA explicites.

Comparaisons rapides

Choix	À utiliser quand	À retenir
`defaults/`	Vous changez la baseline produit pour toutes les instances.	À revoir comme comportement produit.
`custom/`	Vous changez une instance déployée.	Meilleur endroit pour les changements opérateur.
Slug exact	Le chemin public doit résoudre vers une seule destination connue.	Supporte le comportement horaire.
Namespace splat	Un préfixe stable doit transmettre des chemins imbriqués.	À éviter pour les redirections sensibles au temps.

Produits Cloudflare

Mon, 01 Jan 0001 00:00:00 +0000

vanityURLs est un raccourcisseur d’URL qui fonctionne sur le réseau edge de Cloudflare avec votre propre domaine.

Produit	Role dans vanityURLs
Cloudflare DNS	DNS autoritatif du domaine court, incluant l'enregistrement proxifie du domaine personnalisé du Worker
Cloudflare Workers	Runtime pour les redirections, les pages opérationnelles protégées, les ressources statiques générées et l'envoi d'analytics côté serveur
Cloudflare Access	Protection Zero Trust Network Access (ZTNA) pour les surfaces opérationnelles protégées, comme le tableau de bord Stats et la matrice de tests runtime
Cloudflare SSL/TLS	Certificats edge, Universal SSL, enforcement HTTPS et configuration TLS minimale

Protection réseau avant que le trafic atteigne l’instance vanityURLs

Produit ou surface	Role dans vanityURLs
Web Application Firewall	Regles de sécurité personnalisées pour les sondes de scanner, les methodes inattendues, les clients suspects, les crawlers IA non désirés et les autres trafics bloques à l'edge
Cloudflare Rate Limiting	Limitation de debit pour les comportements abusifs qui ne devraient pas consommer de ressources Worker
Distributed Denial-of-Service (DDoS) Protection	Protection réseau toujours active
Cloudflare Bot Management	Contrôles bot utilises pour réduire l'abus automatise avant que les requêtes atteignent le Worker
Cloudflare AI Crawl Control	Contrôles propres a certaines familles de crawlers IA
Cloudflare Rules	Managed Transforms et normalisation des URL avant que le trafic atteigne l'instance vanityURLs
Cloudflare Security Events	Surface de revue pour les mitigations appliquees avant l'execution du Worker

Cloudflare est une plateforme de type logiciel-service en évolution continue : fonctionnalites, API, libellés du tableau de bord et navigation peuvent changer sans numero de version majeur. Pour garder la documentation alignee avec cette surface mouvante, vanityURLs maintient une capture structuree du tableau de bord Cloudflare en JSON. Cette capture aide les mainteneurs a comparer les changements d’interface dans le temps et a mettre la documentation à jour de facon délibérée. Pour le raisonnement de maintenance, consultez ADR 0012 et The JSON audit ledger behind the Cloudflare setup docs.

Fichiers de configuration

Mon, 01 Jan 0001 00:00:00 +0000

vanityURLs garde les valeurs par défaut du produit, les choix propres à l’instance, les réglages locaux du poste et les artefacts runtime générés dans des fichiers séparés.

Utilisez cette page pour identifier les fichiers de configuration actuels et la forme de schéma que chacun suit. Le contrat exact reste les fichiers Git et les scripts dans le dépôt de code.

Configuration source

Fichier	Format	Forme de schéma	Proprietaire
`wrangler.toml`	TOML, selon la configuration Cloudflare Wrangler	`name`, `main`, `compatibility_date`, `workers_dev`, `preview_urls`, `[build]`, `[assets]`, `[vars]`, `[[routes]]`, `[observability]`	Instance
`package.json`	Manifeste npm JSON	`scripts`, `devDependencies`, metadonnées du paquet	Produit
`package-lock.json`	Lockfile npm JSON	Graphe de dependances verrouille génère par npm	Produit
`defaults/v8s-site-config.json`	Configuration de site vanityURLs JSON, `schema_version: "1.0"`	Base produit pour `i18n`, `links`, et `operator`	Produit
`custom/v8s-site-config.json`	Configuration de site vanityURLs JSON, `schema_version: "1.0"`	Surcharges d’instance pour `i18n`, `links`, `operator`, et `branding`; `operator.operator_domain` peut piloter le domaine par défaut des contacts	Instance
`defaults/v8s-links.txt`	Texte delimite par pipes avec blocs `@schedule` inline optionnels	`slug\|target\|state\|title\|description\|tags\|owner\|expires_at\|notes`, suivi de directives d’horaire indentées au besoin	Liens de départ produit
`custom/v8s-links.txt`	Texte delimite par pipes avec blocs `@schedule` inline optionnels	Meme format que `defaults/v8s-links.txt`; c’est la source de vérité rédigée par un humain pour les liens	Instance
`custom/v8s-schedules.json`	Horaire vanityURLs JSON hérité	Source de compatibilité 3.x dépréciée lue par le build et la commande actuelle `lnk schedule`; les blocs `@schedule` inline ont priorité	Instance
`defaults/v8s-policies.json`	Politique vanityURLs JSON, `schema_version: "1.0"`	`defaults`, `allow_domains`, `blocked_keywords`, `block_domains`, `generated_sources` optionnel	Produit
`custom/v8s-policies.json`	Politique vanityURLs JSON, `schema_version: "1.0"`	Meme format que `defaults/v8s-policies.json`; la politique custom remplace la politique source par défaut avant la fusion des feeds génères	Instance
`defaults/v8s-blocklist-categories.json`	Taxonomie de politique vanityURLs JSON, `schema_version: "1.0"`	`categories`, `severities`, `sources`	Produit
`custom/v8s-blocklist-categories.json`	Taxonomie de politique vanityURLs JSON, `schema_version: "1.0"`	Extension ou surcharge optionnelle des categories, sevérités et sources de blocklist générée	Instance
`defaults/v8s-language-metadata.json`	Métadonnées de langue vanityURLs JSON	Libellés produit pour les listes de pages localisées générées et la navigation des pages d’état	Produit
`defaults/legal/v8s-legal-content.json`	Contenu légal vanityURLs JSON	Contenu par défaut des pages légales, Confiance et sécurité, sécurité et délais de réponse rendus par le build	Produit
`defaults/v8s-local-config.json`	Configuration locale vanityURLs JSON, `schema_version: "1.0"`	`shell_helper`, `lnk_cli`, `local_publish`, `registry`, `repository`	Produit
`custom/v8s-local-config.json`	Configuration locale vanityURLs JSON, `schema_version: "1.0"`	Chemins du helper propres au poste et réglages de publication locale écrits par `npm run local-install`	Poste
`defaults/public/_headers`	Regles d’en-têtes pour assets statiques Cloudflare	Motif de chemin suivi de lignes d’en-têtes indentees	Produit ou surcharge d’instance

Anciens noms de fichiers blocklist Modifié en 3.0.0

Registre runtime

Mon, 01 Jan 0001 00:00:00 +0000

build/v8s.json est le registre runtime génère et consomme par le Worker. Les humains modifient les fichiers source comme custom/v8s-links.txt; le build valide et compile ces fichiers vers cette forme runtime.

Schéma 3.0

Le schéma 3.0 est d’abord arborescent :

Champ	Rôle
`schema_version`	Version du contrat du registre runtime, actuellement `3.0`
`generated_at`	Horodatage du build
`generated_timezone`	Fuseau horaire opérateur utilisé par les tableaux protégés pour afficher l’heure de build
`default_state`	État de cycle de vie par défaut, normalement `permanent`
`routing`	Carte état-vers-résultat utilisée par le Worker
`tree`	Structure imbriquée canonique pour la résolution runtime
`links[]`	Tableau de compatibilite pour tableaux de bord, helpers locaux et revue

Chaque noeud de tree contient un objet children et peut contenir un link. Chaque link garde les mêmes champs que dans links[], dont slug, match, target, state, les metadonnées et un schedule optionnel.

Surcharges custom

Mon, 01 Jan 0001 00:00:00 +0000

Utilisez custom/ pour les fichiers propres à l’instance. Cela garde les déploiements faciles à mettre à jour pendant que les pages par défaut, la logique Worker, la politique source et les réglages locaux évoluent.

Pour le raisonnement de mise à jour, lisez Garder vanityURLs facile à mettre à jour avec custom. Pour l’ordre de build et les artefacts générés, lisez Fichiers de configuration.

Defaults versus custom

defaults/ est la base produit. custom/ est la couche de l’instance. Les fichiers dans custom/ remplacent certains defaults ou fournissent des données propres à l’instance qui doivent survivre aux mises à jour upstream.

Pages publiques et pages de statut

Mon, 01 Jan 0001 00:00:00 +0000

Utilisez custom/public/ lorsqu’une instance doit remplacer des pages publiques générées, ajouter des assets publics ou personnaliser les pages de statut des liens. Utilisez Surcharges custom pour la carte plus large des fichiers de configuration.

Carte des surcharges publiques

Évitez de remplacer les assets publics partagés trop facilement

Glossaire

Mon, 01 Jan 0001 00:00:00 +0000

Le glossaire definit les termes et abreviations utilises sur le site web.

Termes

Application Access: Une application Cloudflare Zero Trust qui protège certains chemins, comme les chemins stats localisés /en/_stats/ et /fr/_stats/, ainsi que /_tests/*, avant que le Worker serve ces pages.
Politique Access: Une règle Cloudflare Zero Trust qui decide quelles identités peuvent atteindre une application Access protégée.
Alias: Le chemin court ou mot-cle utilise pour atteindre une destination configuree.
Badge: Un lien visuel compact qui annonce, previsualise ou partage un alias.
Politique de blocage: Les règles propres à l’instance dans custom/v8s-policies.json qui bloquent les domaines dangereux, mots-cles, chemins de scanner ou trafic indesirable avant la recherche de redirection.
Artefact de build: Un fichier génère sous build/ ou src/. Modifiez les fichiers source dans custom/ ou defaults/, puis reconstruisez au lieu de modifier les artefacts directement.
Overlay custom: La couche propre à l’instance sous custom/. Elle remplace ou éténd les defaults produit sans modifier les fichiers upstream.
Cible par défaut: La destination fallback utilisee par un lien planifié lorsqu’aucune règle horaire n’est active.
Destination: La longue URL vers laquelle un lien court redirige. Dans le format de lien, elle est stockee dans la colonne target.
Registre génère: Le registre runtime de redirection écrit dans build/v8s.json pendant le build à partir des liens, horaires, politiques et configurations.
Page generee: Une page emise par le redirecteur pour l’expansion, le repli, le statut de lien, les pages legales, la confidentialite ou d’autres surfaces publiques runtime.
Hardening: Réduction de la surface d’attaque disponible en désactivant les fonctionnalités inutilisées, en resserrant les politiques navigateur et en gardant les contrôles de sécurité dans une source de vérité claire.
Fournisseur d'identité: Une source de connexion utilisee par Cloudflare Access, comme GitHub, Google ou un code à usage unique, pour confirmer qui essaie d’acceder à une page protégée.
Idempotent: Une commande ou opération qui peut être relancee avec les mêmes entrées sans créer d’état en double ni exiger une nouvelle installation. Dans vanityURLs, npm run setup relit les réponses existantes et met à jour les mêmes fichiers génères.
IDNA: Internationalized Domain Names in Applications, le standard qui permet aux logiciels de représenter les noms de domaine non ASCII dans une forme ASCII compatible avec DNS.
Registre de liens: L’ensemble des enregistrements de liens courts utilisés par vanityURLs. Les humains modifient custom/v8s-links.txt; le build produit le registre génère consomme par le Worker.
Operateur: La personne, l’équipe ou l’organisation responsable de l’instance vanityURLs, des pages publiques, des contacts de confiance et de la configuration des pages légales.
Libelle owner: Une courte valeur interne dans v8s-links.txt qui identifie la personne ou l’équipe responsable d’un lien.
Punycode: L’encodage ASCII utilisé par IDNA pour les libellés de domaine internationalisés, généralement visible avec le préfixe xn--.
Slug aléatoire: Un slug génère par lnk lorsque vous fournissez une destination sans choisir vous-même le chemin court.
Redirection: Une requete de lien court qui resout vers une destination configuree.
Route: Le mappage Cloudflare Workers qui envoie les requêtes pour votre domaine court vers le Worker vanityURLs.
Runtime: Le Worker Cloudflare et les assets statiques qui servent les redirections et les pages après le build et le déploiement.
Lien planifié: Un lien court dont la destination peut changer selon le jour, la fenêtre horaire et le fuseau horaire avec des règles @schedule inline dans v8s-links.txt.
Domaine court: Le domaine utilise pour les redirections, comme v8s.link ou go.example.com.
Slug: Le chemin après votre domaine court. Dans https://v8s.link/docs, le slug est docs.
Lien splat: Un lien stocke comme slug/* qui transmet le reste du chemin dans une destination contenant :splat.
Tag: Un libellé séparé par virgules sur une ligne de lien, utilise pour grouper les liens, décrire l’intention ou choisir des longueurs de slugs aléatoires propres aux tags.
Worker: L’application Cloudflare Workers qui exécute le redirecteur vanityURLs.

Abreviations

ADR ← Architecture Decision Record: Un court document qui enregistre une décision d’implementation et sa raison.
API ← Application Programming Interface: Une interface documentee qu’un logiciel peut appeler, comme un endpoint analytics ou fournisseur.
CLI ← Command Line Interface: Une interface de commande en terminal, comme le helper lnk utilise pour gerer les liens.
CI ← Continuous Integration: Des verifications automatisees lancees avant fusion ou déploiement.
CSP ← Content Security Policy: Des règles de sécurité navigateur qui limitent les scripts, styles, images et connexions qu’une page peut utiliser.
DNS ← Domain Name System: Le système qui associe les noms d’hote aux destinations réseau et permet a Cloudflare de router votre domaine court.
GDPR ← General Data Protection Regulation: Reglement europeen sur la protection des données qui peut concerner les opérateurs traitant des données personnelles de visiteurs de l’UE.
HTML ← HyperText Markup Language: Le langage de balisage utilise pour les pages web.
HTTP ← Hypertext Transfer Protocol: Le protocole utilisé par les navigateurs, clients et Workers pour demander et retourner des ressources web.
IP ← Internet Protocol: L’adressage réseau utilise pour router le trafic; les analytics et logs peuvent inclure des adresses IP visiteur.
JSON ← JavaScript Object Notation: Un format de données structurees utilisé par vanityURLs pour les registres génères et les fichiers de configuration.
OTP ← One-Time PIN: Un code de connexion temporaire que Cloudflare Access peut envoyér directement à une adresse courriel autorisee.
QR ← Quick Response: Un format de code-barres scannable souvent utilise pour partager des liens courts sur papier ou dans des diapositives.
RFC ← Request for Comments: Une publication de standard ou d’information, comme RFC 9116 pour security.txt.
SLA ← Service-Level Agreement: Un engagement de service formel; la documentation vanityURLs recommande de ne pas en promettre un à la legere.
SRI ← Subresource Integrity: Un contrôle d’intégrité navigateur qui permet au HTML d’épingler le hash attendu d’un script ou d’une feuille de style chargée.
TLS ← Transport Layer Security: Le protocole de chiffrement derrière HTTPS.
URL ← Uniform Resource Locator: L’adresse d’une ressource web, incluant le protocole, l’hote, le chemin et une eventuelle query string.
UTM ← Urchin Tracking Module: Des paramêtres de campagne dans l’URL utilisés par les outils analytics.
VDP ← Vulnerability Disclosure Policy: Une politique qui explique comment les chercheurs en sécurité devraient signaler les vulnérabilités.
WAF ← Web Application Firewall: Des règles edge Cloudflare qui bloquent le trafic suspect ou abusif avant qu’il atteigne le Worker.
YAML ← YAML Ain't Markup Language: Un format de données structurees lisible par les humains, utilisé par le site de documentation pour les données et la configuration.

Fuseaux horaires

Mon, 01 Jan 0001 00:00:00 +0000

vanityURLs accepte les noms de fuseaux horaires IANA, ainsi que UTC. N’entrez pas de décalage numérique comme -4, -5 ou GMT-0400; un décalage ne décrit pas les changements d’heure avancée.

Utilisez le fuseau basé sur un lieu qui correspond à l’opérateur ou au lien planifié. Par exemple, l’heure de l’Est devrait généralement être America/Toronto ou America/New_York. La base de fuseaux horaires JavaScript Intl gère le passage entre EST et EDT.

Internationalisation (i18n)

Mon, 01 Jan 0001 00:00:00 +0000

L’internationalisation (i18n) est le processus d’ingénierie logicielle qui consiste à concevoir une application pour qu’elle puisse facilement s’adapter à différentes langues sans changements structurels de code. vanityURLs détecte la langue du navigateur dans la requête et envoie les pages web localisées en anglais, français, allemand, italien et espagnol lorsqu’elles sont disponibles. La page anglaise est envoyée lorsqu’il n’existe pas de page localisée pour le code de langue ISO demandé.

Langues supportées

Code	Langue
`en`	Anglais
`fr`	Français
`es`	Espagnol
`it`	Italien
`de`	Allemand

Pages localisées

Les pages publiques par défaut sont disponibles dans les répertoires de langue localisés sous defaults/public/{language}/.

Format des liens

Mon, 01 Jan 0001 00:00:00 +0000

v8s-links.txt est la source de vérité humaine pour les liens. Chaque ligne non vide et non commentee est séparée par des pipes :

slug|target|state|title|description|tags|owner|expires_at|notes

Champ	Requis	Description
`slug`	oui	Chemin sans `/` initial
`target`	oui	URL `http` ou `https`, ou hostname normalise vers `https://`
`state`	non	`permanent`, `ephemeral`, `expired`, `disabled`, `maintenance`, `deactivated`
`title`	non	Titre pour le dashboard
`description`	non	Usage humain du lien
`tags`	non	Tags séparés par virgules
`owner`	recommande	Étiquette de responsabilité
`expires_at`	non	Date ou timestamp ISO
`notes`	non	Notes internes

Liens exacts

social/x|https://x.com/vanityURLs|permanent|X / Twitter|Profil social|social,x|v8s||

Le lien resout seulement /social/x.

Politique et blocklist

Mon, 01 Jan 0001 00:00:00 +0000

vanityURLs édite la politique source comme v8s-policies.json et déploie la politique runtime comme build/v8s-blocklist.json.

Les noms sont décrits comme politique source et artefact runtime de blocklist dans la documentation parce que les noms de fichiers actuels sont faciles à confondre. Un futur nettoyage avec rupture devrait utiliser des noms appariés plus clairs pour le fichier source et le fichier généré.

Les protections runtime intégrées sont documentées dans Sécurité runtime. Utilisez Politique et blocklist lorsque vous avez besoin du workflow opérateur pour changer la politique de l’instance.

Structure du dépôt

Mon, 01 Jan 0001 00:00:00 +0000

Une instance vanityURLs garde les fichiers détenus par le produit séparés des fichiers détenus par l’instance. C’est ce qui rend npm run upgrade pratique : upstream peut rafraîchir defaults/ et scripts/, tandis que vos liens, votre marque, vos choix de politique et vos réglages Cloudflare restent sous votre contrôle.

Le dépôt public v8s.link suit cette structure :

package.jsonscripts npm et dépendances
package-lock.jsongraphe de dépendances verrouillé
wrangler.tomlréglages de déploiement Cloudflare Worker
defaults/base produit rafraîchie par upgrade
- public/pages, assets, badges, pages d'état et headers par défaut
  - _headersheaders cache et no-index des assets statiques
  - robots.txt
  - style.css
  - script.js
- v8s-links.txtinventaire de liens et horaires inline de départ
- v8s-policies.jsonpolitique trust-and-safety par défaut
- v8s-blocklist-categories.jsonlibellés de catégories de politique
- v8s-language-metadata.jsonlibellés de pages générées localisées
- legal/contenu légal et confiance généré par défaut
  - v8s-legal-content.json
- v8s-site-config.jsonlangues, marque et valeurs opérateur par défaut
- v8s-local-config.jsonréglages par défaut du helper local
custom/surcharges propres à l'instance
- public/marque, pages, assets et headers de l'instance
  - _headers
  - robots.txt
  - style.css
  - script.js
- v8s-links.txtsource de vérité humaine des liens
- v8s-site-config.jsonlangues, marque, valeurs opérateur et contacts
scripts/outillage produit
- workers/source canonique du Worker et tests
  - worker.mjs
  - worker.test.mjs
- lnkCLI pour liens, horaires et politique
- build.mjsbuild defaults plus custom vers la sortie de déploiement
- setup.mjsnpm run setup
- upgrade.mjsnpm run upgrade
- local-install.mjssetup du helper local
- v8s.shhelper local en lecture seule
src/entrée Worker générée depuis scripts/workers
- worker.mjs
build/sortie de déploiement générée
- v8s.jsonregistre runtime de redirection
- v8s-blocklist.jsonartefact runtime de politique
- v8s-site-config.jsonconfiguration runtime du site
- _headers
- index.html
- _stats/shell stats protégé
  - index.html
- _tests/page de test runtime protégée
  - index.html
- en/pages publiques et assets localisés
  - index.html
  - 404.html
  - expired.html
  - disabled.html
  - maintenance.html

Defaults produit

defaults/ est la base produit. Il contient les pages publiques, pages d’état localisées, badges de redirection, pages de politique, icônes, shell stats protégé, liens de départ, horaires inline de départ, politique par défaut, configuration de site et defaults du helper local.

Approche sécurité du runtime

Mon, 01 Jan 0001 00:00:00 +0000

Le runtime vanityURLs est volontairement petit : valider le registre génère, servir les assets statiques, lire v8s.json, puis retourner un petit nombre de résultats possibles.

Pour le raisonnement de design, lisez Sécurité runtime pour un petit redirecteur. Cette page est la référence compacte des contrôles a conserver.

Runtime defensif

Le Worker garde un chemin runtime etroit :

seules les requêtes publiques GET, HEAD, et OPTIONS silencieuses sont acceptees, plus POST /lookup/resolve pour la resolution lookup et le beacon dedie POST /_analytics/lookup
l’accès direct a /v8s.json, /v8s-blocklist.json, et /v8s-site-config.json retourne 404
les redirections acceptent seulement les cibles http: et https:
les cibles avec identifiants, hostname manquant, caracteres de contrôle, ou protocoles non supportes échouent ferme
les valeurs splat sont encodees segment par segment avant insertion
les états de cycle de vie passent par des règles de routage explicites
les chemins opérationnels protégés verifient les JWT Cloudflare Access et échouent ferme si Access n’est pas configure
les probes scanner retournent un 404 simple no-store avant lookup ou analytics
les analytics sont envoyés avec ctx.waitUntil() pour qu’une panne fournisseur ne ralentisse pas les redirections

Les protections runtime par défaut incluent :

Modèle de sécurité

Mon, 01 Jan 0001 00:00:00 +0000

Cette page est écrite pour les revues de sécurité. Sécurité runtime explique comment le Worker se comporte. Protection réseau et Contrôle d’accès expliquent ce qu’un opérateur configure. Cette page relie ces vues en nommant les frontières de confiance et en montrant où chaque contrôle est appliqué : build, runtime Worker ou edge Cloudflare.

L’erreur de revue la plus courante est de considérer qu’un contrôle appliqué à l’edge ou au build manque parce qu’il n’est pas dans le code du Worker. La matrice ci-dessous rend cette séparation explicite.

Liens planifiés

Mon, 01 Jan 0001 00:00:00 +0000

Les liens planifiés permettent à un slug stable de pointer ailleurs pendant certaines plages horaires. Gardez la cible normale sur la ligne du lien dans v8s-links.txt, puis ajoutez des directives @schedule indentées sous cette ligne.

Pour les cas d’usage et la logique de décision, lisez Quand les liens planifiés sont utiles.

Les planifications s’appliquent actuellement aux liens exacts. Les liens splat restent bases sur le chemin.

Forme inline

hangout|https://discord.gg/personal|permanent|Hangout|Community hangout|community|team||
 @schedule timezone=America/Toronto
 @schedule rule=work days=mon,tue,wed,thu,fri from=09:00 to=17:00 target=https://zoom.us/j/work

La cible de la ligne du lien est la cible de repli. Les règles d’horaire choisissent seulement une cible temporaire pendant les fenêtres correspondantes.

Mettre à jour une instance

Mon, 01 Jan 0001 00:00:00 +0000

Utilisez npm run upgrade pour rafraîchir une instance vanityURLs existante. La commande met à jour les fichiers détenus par le produit et laisse vos fichiers propres à l’instance tranquilles.

Lancez-la depuis un worktree propre :

npm run upgrade

La commande récupère la source upstream configurée, rafraîchit les fichiers produit comme defaults/ et scripts/, lance les vérifications du projet et laisse un diff Git normal à réviser. Si les définitions de dépendances changent pendant le rafraîchissement, l’upgrade lance npm install avant la validation afin que l’outillage local corresponde aux fichiers produit mis à jour.