Ошибки curl: что значит код в скобках и как исправить
Когда curl не может выполнить запрос, он пишет строку curl: и число в скобках — код ошибки. Найдите код и текст в таблицах ниже и откройте разбор: там написано, что случилось и какие команды ввести.
Содержание 10
Что сделать прямо сейчас
- Найдите строку, которая начинается с
curl:. Число в скобках — код ошибки, после него — текст причины. - Найдите код и похожий текст в таблицах ниже и откройте разбор.
- Если строки нет, а файл не скачался, посмотрите, где искать сообщение.
Как читать сообщение
| Что видите | Что значит |
|---|---|
curl: (6) Could not resolve host: example.com | сообщение curl: в скобках — код ошибки, дальше — причина |
Warning: Failed to open the file file.zip: Permission denied | предупреждение curl над строкой с кодом: здесь причина названа подробнее |
cURL error 28: Operation timed out … в WordPress или другой программе на PHP | тот же код и текст от библиотеки libcurl внутри сообщения программы |
Код ошибки curl возвращает и как код выхода. В скрипте его покажет команда echo $? сразу после curl: 0 — ошибки не было.
Адрес не нашёлся или сервер не отвечает
| Сообщение | Что значит |
|---|---|
| curl: (6) Could not resolve host | curl не узнал IP-адрес по имени: опечатка, нет записи в DNS или сервер не может обратиться к DNS |
| Ошибки DNS: NXDOMAIN, SERVFAIL, REFUSED | что отвечают dig и nslookup, когда имя не находится |
| curl: (7) Failed to connect | по этому адресу и порту никто не принимает подключения |
| curl: (28) Operation timed out, Connection timed out | вышло время ожидания: при поиске адреса, подключении или получении данных |
| cURL error 28 в WordPress | WordPress не дождался ответа — от своего сайта или от другого сервера |
Сертификат
| Сообщение | Что значит |
|---|---|
| curl: (60) unable to get local issuer certificate | curl не может проверить сертификат: на сайте не хватает промежуточного сертификата или на сервере нет корневых |
| curl: (60) certificate has expired | срок сертификата сайта истёк |
| curl: (60) self-signed certificate | сертификат выпущен самим сервером, а не центром сертификации |
| curl: (60) no alternative certificate subject name matches target host name | сертификат выпущен на другое имя |
Ответ сервера и ссылка
| Сообщение | Что значит |
|---|---|
| curl: (22) The requested URL returned error: 404 | сервер ответил кодом ошибки, а в команде есть ключ -f |
| curl: (3) URL rejected: Malformed input to a URL function | в ссылке пробел или другой знак, которого в ней быть не должно |
| curl: (3) bad range in URL position | в ссылке квадратные или фигурные скобки: curl понял их как шаблон |
| curl: (1) Protocol "htps" not supported | опечатка в начале ссылки, до :// |
Запись файла
| Сообщение | Что значит |
|---|---|
| curl: (23) Failure writing output to destination | curl получил данные, но не смог их записать: нет папки или прав, кончилось место или следующая команда перестала читать |
| curl: (23) client returned ERROR on write of … bytes | то же в curl 8.18.0 из Ubuntu 26.04: файл не открылся для записи |
Где искать сообщение
Если в команде есть ключ -s, curl молчит и об ошибках. Чтобы увидеть текст ошибки, добавьте -S: curl -sS ….
curl -sS -O 'https://example.com/file.zip'Если текста мало, добавьте ключ -v: curl покажет каждый шаг — поиск адреса, подключение, проверку сертификата и ответ сервера. Строки, которые начинаются со звёздочки, — сообщения curl о том, что он делает.
curl -v -o /dev/null 'https://example.com/'Откуда тексты
Тексты сверены с исходным кодом curl 8.5.0 — эта версия ставится из пакетов Ubuntu 24.04 — и curl 8.18.0 из пакетов Ubuntu 26.04. Свою версию покажет первая строка вывода команды curl -V.
Источники
- Исходный код 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 года.