curl: (7) Failed to connect — сервер не принял подключение
curl нашёл IP-адрес, но на этом адресе и порту никто не принял подключение: программа на сервере не запущена, слушает другой порт или подключение отклонил фаервол.
Содержание 8
Как выглядит ошибка
curl: (7) Failed to connect to example.com port 443 after 12 ms: Couldn't connect to serverТак пишет curl 8.5.0 из Ubuntu 24.04. В curl 8.18.0 из Ubuntu 26.04 в конце стоит Could not connect to server. В Ubuntu 22.04 с curl 7.81.0 на этом месте причина от системы, например Connection refused. Номер в скобках — код выхода curl. В скрипте его покажет команда echo $? сразу после curl.
Число перед ms — сколько миллисекунд curl пытался подключиться. Десятки миллисекунд значат, что сервер сразу ответил отказом. Если ожидание шло больше минуты и код в скобках не 7, а 28, ответа не было вовсе — это разобрано в статье curl: (28) timed out.
Шаг 1. Проверьте порт в ссылке
Порт curl берёт из ссылки: https:// — 443, http:// — 80, а если после имени стоит двоеточие и число, как в http://example.com:8080/, — это число. Порт из ошибки должен совпадать с тем, на котором работает сайт или программа.
Шаг 2. Проверьте, запущена ли программа на сервере
Команды на этой странице вводятся на сервере: подключитесь к нему по SSH (как подключиться) и набирайте их в том же окне. Если сайт работает через nginx:
sudo systemctl status nginxsudo может спросить пароль вашего пользователя на сервере: символы при вводе не видны, наберите пароль и нажмите Enter. В строке Active должно быть active (running). Если там inactive или failed, запустите nginx и посмотрите журнал:
sudo systemctl start nginx
sudo journalctl -u nginx -n 30 --no-pagerДля Apache служба называется apache2, для своего приложения — так, как вы её назвали.
Шаг 3. Посмотрите, какой адрес и порт слушает программа
sudo ss -ltnpВ столбце Local Address:Port — адрес и порт, в последнем столбце — имя программы.
| Что в столбце | Кто может подключиться |
|---|---|
0.0.0.0:443, [::]:443 или *:443 | подключения извне на этот порт принимаются |
127.0.0.1:3000 или [::1]:3000 | только программы на самом сервере |
| нужного порта в списке нет | никто: программа не запущена или слушает другой порт |
Если приложение слушает 127.0.0.1, а вы подключаетесь к внешнему IP-адресу сервера, получите эту ошибку. Сайт на таком приложении открывают через nginx — как настроить nginx перед приложением.
Шаг 4. Если программа слушает порт, а подключиться нельзя
Тогда подключение отклоняет фаервол. Посмотрите правила на сервере:
sudo ufw statusЕсли ufw включён (Status: active), в списке должен быть нужный порт с ALLOW. Открыть порт для сайта:
sudo ufw allow 443/tcpПодробнее о правилах — в справке Команда ufw. Если на сервере всё открыто, проверьте фаервол в панели хостинга: у части провайдеров он есть отдельно от сервера.
Программа в контейнере Docker доступна снаружи, только если порт опубликован ключом -p, например -p 8080:80. Без него на сервере порт никто не слушает.
Как проверить
curl -sS -o /dev/null -w '%{http_code}\n' https://example.com/Команда выведет код ответа, например 200 или 301: подключение прошло. Если в команде есть ключ -s, curl молчит и об ошибках. Чтобы увидеть текст ошибки, добавьте -S: curl -sS ….
Источники
- Исходный код curl 8.5.0: lib/connect.c — строка Failed to connect и замена кода 7 на 28, когда система сообщает об истечении времени.
- Исходный код curl 8.18.0: lib/cf-ip-happy.c — та же строка в новой версии.
- Исходный код curl 7.81.0: lib/connect.c — в этой версии в конце строки стоит причина от системы.
- Исходный код curl 8.5.0: lib/strerror.c и curl 8.18.0 — названия кодов выхода.
- Пакет curl в Ubuntu 24.04 и в Ubuntu 26.04 — версии 8.5.0 и 8.18.0.
Сверено 23 октября 2026 года.
Что почитать дальше
- curl: (28) timed outкогда ответа нет вовсе.
- Порты 80 и 443какие порты нужны сайту.
- Команда ufw.
- Все ошибки curlтаблица по коду и тексту.