Documentation on vanityURLs

Cloudflare Pages

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

vanityURLs est conçu pour fonctionner sur Cloudflare Pages. Le plan gratuit couvre tout ce dont la plupart des déploiements personnels et des petites équipes ont besoin.

Configuration du build

Lors de la connexion de votre dépôt dans le tableau de bord Cloudflare :

Paramètre	Valeur
Préréglage de framework	(laisser vide)
Commande de build	`cat static.lnk dynamic.lnk > build/_redirects`
Répertoire de sortie du build	`/build`
Répertoire racine	`/`

Domaine personnalisé

Dans votre projet Pages, allez à Custom domains → Set up a custom domain
Entrez votre domaine court (ex. mon-domaine.link)
Si votre domaine est sur Cloudflare DNS, les enregistrements nécessaires sont créés automatiquement

Tip

dynamic.lnk

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

dynamic.lnk contient vos redirections temporaires — conférences, campagnes marketing, inscriptions à des événements.

# expire : 2025-09-01
/summit2025 https://summit.example.com/2025 302

# Campagnes actives
/promo https://boutique.example.com?p=ete 302

Utilisez 302 pour indiquer aux moteurs de recherche que la destination peut changer.

lnk add --dynamic /conf2025 https://conf.example.com/2025 302

Installation

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

vanityURLs fonctionne entièrement sur l’infrastructure que vous contrôlez déjà — un dépôt GitHub, un nom de domaine, et un compte Cloudflare gratuit. Il n’y a rien à installer sur votre machine en dehors du script CLI optionnel.

Mise en place rapide

Créer un dépôt depuis le modèle

Depuis le dépôt GitHub vanityURLs, cliquez sur Use this template → Create a new repository.

Choisissez un nom qui reflète votre domaine court (p. ex. mon-domaine.link). Sélectionnez Privé — votre liste de redirections peut contenir des URL internes.

Makefile

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

Le dépôt vanityURLs inclut un Makefile qui automatise les tâches courantes de configuration et de maintenance. Toutes les cibles lisent depuis vanityURLs.conf.

Cibles disponibles

$ make help
Cibles :
 make config — Assistant de configuration interactif
 make setup — Configuration initiale complète : installer lnk, générer _headers, _redirects
 make headers — Régénérer build/_headers depuis votre domaine et URL Pages
 make install — Installer le script lnk dans SCRIPT_DIR
 make validate — Valider la syntaxe de static.lnk et dynamic.lnk
 make deploy — Committer tous les changements de liens et pousser vers origin
 make status — Afficher le nombre de redirections et la date du dernier déploiement
 make clean — Supprimer les fichiers générés

Détails

`make config`

Ouvre vanityURLs.conf dans votre $EDITOR (par défaut vi) :

static.lnk

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

static.lnk contient vos redirections permanentes — profils sociaux, portfolio, pages de projets.

# Profils
/github https://github.com/votrenom 301
/linkedin https://linkedin.com/in/votrenom 301

# Projets
/appli https://appli.example.com 301

# Racine (toujours en dernier)
/ https://votrenom.example.com 301

Ajoutez des liens avec le script lnk :

lnk add /github https://github.com/votrenom