Auto-hébergement
Omnillink est un logiciel libre sous licence MIT. Il vous faut Node.js 22 ou plus récent ; Redis est facultatif.
Avec Node.js
git clone https://github.com/kayzen-lyon/linkforge.git
cd linkforge
npm install
npx playwright-core install chromium
cp .env.example .env
npm run dev
L’API écoute sur http://localhost:3000. npm run build puis npm start lancent la version compilée.
Sur Vercel
Le dépôt contient la configuration d’un déploiement en une seule fonction serverless, qui sert à la fois l’API et ce site. Le dossier racine du projet Vercel est apps/api.
- Sur Vercel, Chromium vient du paquet
@sparticuz/chromium, prévu pour les fonctions serverless. - Sans Redis, le cache vit en mémoire, instance par instance. Ajoutez
REDIS_URLpour le partager. - Le premier rendu d’une instance froide est plus lent : Chromium doit d’abord démarrer.
Variables d’environnement
Toutes sont facultatives. Les valeurs par défaut conviennent à un essai local.
| Variable | Défaut | Rôle |
|---|---|---|
PORT, HOST | Défaut3000, 0.0.0.0 | RôleAdresse d’écoute. |
REDIS_URL | Défautvide | RôleCache partagé. Vide : cache en mémoire. |
API_KEYS | Défautvide | RôleClés acceptées dans x-api-key, séparées par des virgules, de 16 à 256 caractères. |
RATE_LIMIT_MAX | Défaut60 | RôleRequêtes par fenêtre et par adresse IP. |
RATE_LIMIT_KEY_MAX | Défaut600 | RôleRequêtes par fenêtre et par clé. |
RATE_LIMIT_WINDOW_MS | Défaut60000 | RôleDurée de la fenêtre. |
CACHE_*_TTL_SECONDS | Défaut3600 | RôleDurée de cache par point d’accès : META, SCREENSHOT, PDF, EXTRACT, CONTENT. |
HTTP_TIMEOUT_MS | Défaut10000 | RôleDélai de la lecture HTTP. |
BROWSER_NAVIGATION_TIMEOUT_MS | Défaut20000 | RôleDélai de navigation dans Chromium. |
BROWSER_MAX_CONCURRENCY | Défaut4 | RôlePages rendues en parallèle (2 en serverless). |
REQUEST_DEADLINE_MS | Défaut55000 | RôleDélai global d’une requête. |
SSRF_ALLOWED_PORTS | Défaut80,443 | RôlePorts de destination autorisés. |
SSRF_BLOCKED_HOSTS | Défautvide | RôleDestinations refusées en plus, hôte ou hôte:port. Cette liste ne peut que restreindre. |
BROWSER_PAGE_MAX_REQUESTS | Défaut1500 | RôleRequêtes au plus par page rendue. |
BROWSER_PAGE_MAX_BYTES | Défaut60 Mo (30 en serverless) | RôleOctets reçus au plus par page rendue. |
CIRCUIT_BREAKER_THRESHOLD | Défaut5 | RôleÉchecs réseau consécutifs avant de mettre un hôte à l’écart. |
CIRCUIT_BREAKER_COOLDOWN_MS | Défaut30000 | RôleDurée de cette mise à l’écart. |
ANIMATION_MAX_BYTES | Défaut10 Mo (4 en serverless) | RôlePoids maximal d’une capture animée. |
METRICS_TOKEN | Défautvide | RôleJeton qui protège /metrics (format Prometheus). Vide : la route n’existe pas. |
MCP_ENABLED | Défauttrue | RôleActive le point d’accès MCP POST /mcp. |
CORS_ORIGIN | Défaut* | RôleOrigines autorisées à appeler l’API depuis un navigateur. |
SSRF_ALLOW_PRIVATE_NETWORKS=true autorise les adresses locales et privées. Ce réglage sert aux tests : l’API refuse de démarrer avec lui quand NODE_ENV=production.
Vérifier l’installation
curl http://localhost:3000/health
La réponse donne la durée de fonctionnement, le type de cache et l’état du pool de navigateurs. La page État affiche la même chose pour cette instance.