Ollama connection refused на Linux: как проверить сервер
На странице · 3 разделов
Connection refused означает, что подключение к указанному адресу и порту отклонено; это ещё не ошибка модели. На Linux проверьте ответ локального API Ollama, затем службу systemd либо ручной запуск. Не меняйте адрес прослушивания на общедоступный ради диагностики.
На домашнем Linux приложение сообщает connection refused, хотя модель уже скачана? Сначала проверьте, отвечает ли локальный сервер Ollama: ошибка подключения возникает до проверки конкретной модели. В Linux такой отказ означает, что по указанному адресу соединение не принимается; это не доказывает, что файлы модели повреждены. s1
Проверено по документации 30 октября 2026 года. Редакция не запускала Ollama и модель; команды ниже — инструкция по официальным источникам, не наш воспроизведённый результат. Для первого шага нужен Linux с установленной Ollama и доступом к терминалу. Если программа ещё не установлена, начните с установки. s4
Отвечает ли Ollama на вашем компьютере?
Откройте терминал и введите curl -fsS http://127.0.0.1:11434/api/tags. Адрес 127.0.0.1 указывает на этот же компьютер; официальный локальный адрес API — localhost:11434. Если сервер отвечает, вы увидите JSON — текст с полем models и списком доступных ему моделей, даже если список пуст. Это проверяет ответ API, а не качество ответа модели. Если команда снова сообщает Connection refused, переходите к состоянию службы. Если вы подключаете приложение к другому компьютеру, проверка 127.0.0.1 на ноутбуке не проверяет тот сервер. s2 s3
Как проверить и запустить службу?
Если Ollama установлена как служба Linux, введите systemctl status ollama. Показатель active (running) означает, что служба запущена, но ещё не гарантирует доступности API; повторите предыдущий запрос. Если служба остановлена, введите sudo systemctl start ollama, затем снова systemctl status ollama и curl -fsS http://127.0.0.1:11434/api/tags. Служба может попросить пароль администратора. Официальная Linux-инструкция использует именно этот способ запуска и проверки. Не запускайте второй ollama serve поверх работающей службы. s4 s3
Если systemctl сообщает, что службы ollama нет, не создавайте её наугад. При ручной установке официальная инструкция предлагает ollama serve: запустите эту команду в отдельном терминале, оставьте его открытым и повторите запрос curl из первого терминала. Если не находится и команда ollama, вернитесь к инструкции установки. Не скачивайте повторно модель, пока сервер недоступен: запрос ещё не дошёл до её выбора. s4 s3
Что делать, если служба работает, а отказ остался?
Сверьте адрес в приложении, где возникла ошибка, с адресом проверенного API. Настройка OLLAMA_HOST может менять адрес прослушивания Ollama; для службы Linux официальная FAQ описывает её через конфигурацию systemd. Не устанавливайте 0.0.0.0 как «исправление»: это изменяет доступность сервера по сети и не нужно для проверки с того же компьютера. Если запуск не удался, посмотрите последние сообщения службы через journalctl -e -u ollama или руководство по логам. При ручном ollama serve сообщения видны в его терминале. Не публикуйте логи с личными данными и токенами. s6 s4 s5
Проверка результата: запрос к /api/tags возвращает ответ сервера, а прежнее приложение больше не показывает ошибку подключения после сверки адреса. Пустой models — уже другая задача: проверьте точное имя и наличие модели. Если работает API, но не отвечает конкретная модель, нельзя считать её запуск проверенным одной командой curl. s3
Источники
- Linux man-pages: connect(2), ECONNREFUSED — Снимок HTML и SHA-256 сохранены в research/raw. Получено 30.10.2026.
- Ollama Docs: API introduction — Снимок HTML сохранён; документация изменяема. Получено 30.10.2026.
- Ollama Docs: List models /api/tags — Снимок HTML сохранён; документация изменяема. Получено 30.10.2026.
- Ollama Docs: Linux installation and service — Снимок HTML сохранён; документация изменяема. Получено 30.10.2026.
- Ollama Docs: Troubleshooting logs — Снимок HTML сохранён; документация изменяема. Получено 30.10.2026.
- Ollama Docs: FAQ, OLLAMA_HOST on Linux — Снимок HTML сохранён; документация изменяема. Получено 30.10.2026.