---
title: "Could not connect to the server (NSURLErrorDomain -1004) sur Mac · Guides Kilobat"
url: "https://kilobat.app/fr/guides/nsurl-error-1004-could-not-connect-to-the-server"
description: "Une app affiche Could not connect to the server, erreur NSURLErrorDomain -1004. Cherchez si le serveur, un coupe-feu ou un proxy vous refuse."
---

# « Could not connect to the server » (NSURLErrorDomain -1004) sur Mac

L’app a trouvé l’adresse du serveur, mais la connexion ne s’est pas ouverte. Le serveur l’a refusée, ou quelque chose sur le trajet l’a bloquée.

**Réglez-le avec votre agent**Copie un prompt pour Claude Code, Codex ou tout agent capable d’utiliser Terminal.

Mon Mac a ce problème : « Could not connect to the server » (NSURLErrorDomain -1004) sur Mac. Lis https://kilobat.app/fr/guides/nsurl-error-1004-could-not-connect-to-the-server.md et résous-le avec moi. Installe la CLI Kilobat si elle manque : brew install seifip/kilobat/kilobat. Lance toi-même les vérifications Terminal et kilobat du guide et dis-moi ce que tu trouves. Liste les étapes que moi seul peux faire. Demande-moi avant de modifier un réglage.

S’applique à : macOS 13 Ventura et versions ultérieures. Le texte a été vérifié dans CFNetwork sur macOS 27.2. · Vérifié le 29 octobre 2026

## Symptômes

- Une app affiche « Could not connect to the server. » avec l’erreur -1004.
- La Console ou un journal affiche NSURLErrorDomain Code=-1004.
- Safari affiche le message voisin « can’t connect to the server ».

## Causes probables

- **Le serveur est en panne ou n’écoute pas.** Rien n’accepte les connexions sur ce port.
- **Un serveur local ne tourne pas.** Pour `localhost`, votre propre serveur doit tourner. Voir [Port déjà utilisé sur Mac](https://kilobat.app/fr/guides/port-already-in-use).
- **Un coupe-feu, un filtre, un VPN ou un proxy.** Quelque chose bloque le port ou l’hôte.
- **Une adresse ou un port incorrect.** L’app utilise une ancienne URL.

## Comment vérifier

1. Testez le port avec un délai de 5 secondes.

   ```
   nc -vz -G 5 example.com 443
   ```
2. Demandez la page et affichez chaque étape de la connexion.

   ```
   curl -v -o /dev/null https://example.com
   ```
3. Pour une adresse locale, regardez ce qui écoute sur le port.

   ```
   lsof -nP -iTCP:3000 -sTCP:LISTEN
   ```

## Comment corriger

1. Ouvrez la même adresse sur un autre appareil. Si cela échoue aussi, la cause est le serveur ou le réseau.
2. Démarrez le serveur local et utilisez le port qu’il indique.
3. Désactivez un VPN, un proxy ou un filtre pour un test, puis réactivez-le.
4. Vérifiez dans l’app que l’URL contient le bon hôte et le bon port.
5. Réessayez plus tard. Un serveur occupé peut se rétablir.

## Avec Kilobat

1. Vérifiez en une seule étape le Wi-Fi, le routeur, Internet, le DNS et les pages de connexion.

   ```
   kilobat diagnose
   ```
2. Si un seul site ou service échoue, trouvez la couche qui le bloque.

   ```
   kilobat why example.com
   ```
3. La CLI est gratuite. Dans l’app, les conseils issus de ces vérifications font partie de Kilobat Pro. Voir [Trouver pourquoi un site ou une API ne se connecte pas](https://kilobat.app/fr/guides/recipes/why-cant-it-connect).

## Questions

**En quoi -1004 diffère-t-il de -1001 ?**

-1004 est une connexion refusée ou bloquée. -1001 est un dépassement de délai. Voir [« The request timed out. » sur Mac](https://kilobat.app/fr/guides/request-timed-out).

**Pourquoi localhost donne-t-il -1004 ?**

Rien n’écoute sur le port, ou le serveur écoute sur une autre adresse.

## Sources

- Texte d’erreur dans CFNetwork.framework, macOS 27.2 (Localizable.loctable)
- curl(1) et nc(1), page de manuel installée avec macOS 27.2

Vérifié le 29 octobre 2026.

## Guides associés

- [« Safari ne parvient pas à se connecter au serveur » sur Mac](https://kilobat.app/fr/guides/safari-cant-connect-to-server): Safari a trouvé l’adresse du site, mais la connexion au serveur n’a pas pu s’établir.
- [Port déjà utilisé sur un Mac](https://kilobat.app/fr/guides/port-already-in-use): Un seul processus peut écouter sur un même port TCP et une même adresse.
- [« La requête a expiré. » sur Mac](https://kilobat.app/fr/guides/request-timed-out): C’est le texte de macOS pour l’erreur -1001.
- [Des réglages de proxy empêchent les apps de se connecter sur un Mac](https://kilobat.app/fr/guides/proxy-settings-breaking-apps): Un réglage de proxy fait passer le trafic par un autre serveur.
- [Problèmes IPv6 sur un Mac](https://kilobat.app/fr/guides/ipv6-problems-mac): La plupart des réseaux attribuent au Mac une adresse IPv4 et une adresse IPv6.
