« ENOTFOUND railway.internal » et autres erreurs de réseau privé : causes, correctifs, et une version sans DNS à rater.
Les erreurs de réseau privé viennent de trois endroits : un nom qui ne se résout pas dans la famille d’adresses que demande votre client, un service hors des limites du réseau (autre projet, autre région ou espace de travail, ou forfait gratuit), ou une application qui écoute là où la plateforme ne se connecte pas. Voici chaque message chez Railway, Render, Fly.io et Heroku, et comment Canner les évite.
Faits vérifiés le
Les messages, et ce qui les cause
Les adresses privées ne se résolvent que depuis l’intérieur de la plateforme : ces erreurs apparaissent donc dans les journaux d’exécution de votre application, pas sur votre portable. Chaque ligne est un message ou un symptôme, tel que le fournisseur le documente ou que les utilisateurs le rapportent :
| Fournisseur et message | Cause | Correctif |
|---|---|---|
Railway : getaddrinfo ENOTFOUND redis.railway.internal† † | Le client n’a cherché qu’une adresse IPv4 (c’est le comportement par défaut d’ioredis), alors que les environnements créés avant le 16 octobre 2025 ont un réseau privé en IPv6 seulement. | Faites demander les deux au client : family: 0 dans ioredis, ou ?family=0 dans l’URL. Les nouveaux environnements prennent en charge IPv4 et IPv6. |
Railway : ENOTFOUND ou ECONNREFUSED entre deux services† † | Les services sont dans des projets ou des environnements différents. Le réseau privé est limité à un environnement d’un projet. | Mettez-les dans le même projet et le même environnement, ou appelez l’adresse publique. |
Railway : ECONNREFUSED après la résolution du nom† † | Le nom a été résolu, mais rien ne répond à cette adresse et ce port : une application liée à la mauvaise adresse dans un environnement en IPv6 seulement, un service renommé dont l’ancien nom est périmé, ou le mauvais port. Des utilisateurs rapportent les trois cas. | Liez l’application à :: et au port fourni par la plateforme, recopiez le nom d’hôte depuis les paramètres du service et testez depuis un deuxième service. |
| Render : connexion refusée ou expirée vers l’adresse interne d’un service web† † | Les services web gratuits peuvent envoyer des requêtes privées mais pas en recevoir. Les sites statiques ne sont pas sur le réseau privé, et les services doivent partager une région et un espace de travail. | Utilisez une instance payante ou un service privé, et gardez les deux bouts dans une même région et un même espace de travail. |
Render : la connexion échoue avec un simple hôte:port† † | L’adresse interne peut exiger un schéma et un port, comme http://elastic-qeqj:10000. | Utilisez l’adresse complète de l’onglet Interne du menu Connect. |
Fly.io : <app>.internal ne renvoie aucune adresse† † | Les requêtes AAAA ne renvoient que les machines en marche; les machines arrêtées automatiquement sont omises. 6PN relie les machines directement, sans passer par Fly Proxy : l’arrêt automatique exige donc Flycast. | Gardez la machine en marche, ou utilisez Flycast. Liez le service à fly-local-6pn. |
| Heroku : aucune URL interne pour l’application† † | Le routage interne est une fonctionnalité des Private Spaces. On ne peut l’activer qu’à la création de l’application, pas sur une application existante. | Créez l’application dans un Private Space avec routage interne, ou appelez l’URL publique. |
† Les détails sur les concurrents proviennent des pages publiées par chaque fournisseur aux dates indiquées; les prix et forfaits changent, vérifiez auprès du fournisseur avant de décider. Railway : `getaddrinfo ENOTFOUND redis.railway.internal`† (2026-11-18) · Railway : `ENOTFOUND` ou `ECONNREFUSED` entre deux services† (2026-11-18) · Railway : `ECONNREFUSED` après la résolution du nom† (2026-11-18) · Render : connexion refusée ou expirée vers l’adresse interne d’un service web† (2026-11-18) · Render : la connexion échoue avec un simple `hôte:port`† (2026-11-18) · Fly.io : `<app>.internal` ne renvoie aucune adresse† (2026-11-18) · Heroku : aucune URL interne pour l’application† (2026-11-18)
Pourquoi ça revient
- Il faut d’abord qu’un nom se résolve. Un nom d’hôte privé est un nom DNS. Si le client demande de l’IPv4 et que le réseau est en IPv6 seulement, ou que la machine est arrêtée, il n’y a rien à trouver, et l’erreur le dit :
ENOTFOUND. - Le réseau a une limite, et elle diffère selon le fournisseur. Un environnement, une région et un espace de travail, un forfait payant, un Private Space. Franchissez-la et le nom ou la connexion n’existe tout simplement pas.
- La plateforme doit joindre l’application là où elle écoute. Famille d’adresses, port et schéma sont des suppositions jusqu’à ce que quelque chose réponde, et
ECONNREFUSEDsignifie que rien n’a répondu. - Retomber sur l’URL publique masque l’erreur. Ça fonctionne, mais le trafic sort de la plateforme et revient, plus lentement et compté comme bande passante sortante.
Comment Canner s’y prend
Chaque projet d’une organisation peut appeler les autres sans quitter le serveur. Chaque déploiement reçoit une variable par autre projet, CANNER_PRIVATE_URL_<PROJET>, qui contient une URL complète : http://127.0.0.1:3430. C’est une adresse IPv4 et un port : aucun nom à résoudre, aucune recherche IPv6 à rater (connexions privées).
- Activé pour chaque projet et chaque forfait, y compris les applications existantes : les variables apparaissent à leur prochain déploiement. Désactivez-le pour un projet sous Paramètres → Adresse.
- Toute l’organisation, pas un seul projet ou environnement. Le projet d’une autre organisation est refusé par le serveur. Les aperçus de demande de tirage ne reçoivent pas les variables.
- L’URL est complète, avec schéma, adresse et port : vous ne copiez rien depuis un tableau de bord et ne renommez rien à la main. Un projet ajouté plus tard apparaît au prochain déploiement des autres.
- Elle contourne la porte d’entrée publique. L’application ne voit aucun en-tête
X-Forwarded-*ouX-Canner-*, rien n’est mis en cache et une règle réservée à Cloudflare ne s’applique pas. Vérifiez un secret partagé dans l’application, comme dans le code ci-dessous. - Le projet doit être en marche. Un projet gratuit endormi ne répond pas avant que son adresse publique ne le réveille. Les projets toujours actifs sont toujours là.
- Les bases de données n’ont besoin de rien de tout cela : le
DATABASE_URLd’un projet pointe déjà vers la base sur le même serveur (bases de données).
// In the "web" project, calling the "api" project of the same organization
const base = process.env.CANNER_PRIVATE_URL_API; // http://127.0.0.1:3430
const res = await fetch(`${base}/internal/orders`, {
headers: { authorization: `Bearer ${process.env.INTERNAL_TOKEN}` },
signal: AbortSignal.timeout(5000),
});
// In the "api" project: the call skips the public front door, so check who is asking
app.use("/internal", (req, res, next) =>
req.get("authorization") === `Bearer ${process.env.INTERNAL_TOKEN}` ? next() : res.sendStatus(401));Vérifiez depuis l’application
- Journalisez la variable au démarrage :
console.log(process.env.CANNER_PRIVATE_URL_API). Si elle est vide, l’autre projet est dans une autre organisation, a le réglage désactivé, ou n’a pas été déployé depuis son ajout. - Ajoutez une route `/health` à la cible et appelez-la depuis l’appelant avec un court délai, pour qu’un refus apparaisse comme une erreur dans les journaux en quelques secondes.
- Comparez avec l’URL publique. Si l’adresse publique répond et que la privée est refusée, la cible n’est pas en marche ou a désactivé l’accès privé.
Questions
Pourquoi redis.railway.internal donne-t-il ENOTFOUND?
Souvent, le client n’a cherché qu’une adresse IPv4 alors que le réseau privé de l’environnement est en IPv6 seulement (environnements créés avant le 16 octobre 2025). Faites demander les deux au client, par exemple family: 0 dans ioredis. L’autre cause courante est un service dans un autre projet ou environnement.
Que signifie ECONNREFUSED sur une adresse privée?
Le nom a été résolu, mais rien n’a répondu à cette adresse et ce port. Vérifiez que l’application écoute à l’adresse et au port auxquels la plateforme se connecte, que le nom d’hôte est à jour après un renommage, et que la cible est en marche.
Un service gratuit de Render peut-il recevoir des requêtes privées?
Non. Les services web gratuits de Render peuvent envoyer des requêtes privées mais pas en recevoir, et les sites statiques ne sont pas sur le réseau privé.
Faut-il un forfait payant pour le réseau privé chez Canner?
Non. Les connexions privées entre les projets d’une même organisation sont activées pour tous les forfaits. Désactivez-les par projet sous Paramètres → Adresse.
Un autre client peut-il joindre l’URL privée de mon projet chez Canner?
Non. Seuls les projets de votre propre organisation peuvent se connecter. Le serveur refuse la connexion d’un projet de toute autre organisation, et vous devriez quand même vérifier un secret partagé dans l’application.
Une URL privée déjà dans votre environnement.
Déployez deux projets dans une même organisation et chacun reçoit le CANNER_PRIVATE_URL_<PROJET> de l’autre : une URL complète, sans DNS, sans configuration.