Если вы пытаетесь скачать модель через ollama pull
из корпоративной сети, за VPN или через внешний прокси-сервер, вы наверняка уже столкнулись с ошибками вида
dial tcp: lookup registry.ollama.ai или
context deadline exceeded.
Ollama по умолчанию не всегда корректно подхватывает системные настройки прокси, а большие веса моделей (от 2 до 70+ ГБ) усугубляют проблему —
соединение рвётся на середине скачивания. В этой статье разберём, как правильно задать переменные окружения, настроить прокси в Docker и systemd,
а также расшифруем самые частые ошибки pull и способы их устранения.
Как Ollama работает с сетью и прокси
Ollama — это клиент-серверное приложение: локальный сервер (ollama serve)
принимает команды от CLI и выполняет сетевые запросы к реестру моделей registry.ollama.ai и к CDN, где хранятся слои (layers) моделей.
Команда ollama pull llama3 на самом деле выполняет серию HTTPS-запросов,
похожих на Docker pull: сначала запрашивается манифест модели, затем последовательно или параллельно скачиваются бинарные слои (GGUF-файлы весов).
Важный нюанс: сетевые запросы выполняет именно серверный процесс Ollama, а не CLI-команда. Это значит, что переменные окружения
с настройками прокси нужно задавать там, где запущен процесс ollama serve,
а не в терминале, откуда вы вызываете ollama pull.
Если сервис запущен как systemd-юнит или в Docker-контейнере, экспорт переменной в обычном bash-сеансе никак на него не повлияет —
это самая частая причина, почему "прокси вроде настроен, а pull всё равно не работает".
Переменные окружения HTTP_PROXY, HTTPS_PROXY, NO_PROXY
Ollama написан на Go, а стандартная HTTP-библиотека Go читает прокси-настройки из классических переменных окружения:
HTTP_PROXY— прокси для обычных HTTP-запросовHTTPS_PROXY— прокси для HTTPS-запросов (именно он нужен для скачивания моделей, так как реестр работает по TLS)NO_PROXY— список хостов, которые нужно исключить из проксирования (например, локальный API Ollama на 127.0.0.1:11434)
Формат значения: http://user:password@host:port для прокси с авторизацией
или socks5://host:port для SOCKS5. Go поддерживает оба варианта,
но для SOCKS5 важно, чтобы бинарник Ollama был собран с поддержкой этого прокси — в большинстве актуальных сборок это так, но при ошибках стоит сначала
протестировать на HTTP/HTTPS-прокси, чтобы исключить эту переменную.
Важно: указывайте переменные и в нижнем, и в верхнем регистре
(http_proxy и HTTP_PROXY).
Некоторые дистрибутивы Linux читают только нижний регистр, а Go-приложения иногда ожидают верхний — лучше задать оба варианта, чтобы не гадать.
Настройка на Linux и macOS
Если вы запускаете Ollama напрямую из терминала (не как системный сервис), достаточно экспортировать переменные перед запуском сервера:
export HTTP_PROXY="http://user:[email protected]:8000"
export HTTPS_PROXY="http://user:[email protected]:8000"
export http_proxy="http://user:[email protected]:8000"
export https_proxy="http://user:[email protected]:8000"
export NO_PROXY="localhost,127.0.0.1"
ollama serve &
ollama pull llama3
Чтобы настройки сохранялись между сессиями, добавьте эти строки в ~/.bashrc,
~/.zshrc или ~/.profile
в зависимости от используемой оболочки. После редактирования выполните source ~/.bashrc
и перезапустите процесс Ollama — переменные окружения читаются только при старте процесса, горячей перезагрузки не предусмотрено.
На macOS, если Ollama установлена как приложение (а не через Homebrew), переменные окружения из терминала могут не долетать до процесса,
запущенного через GUI. В этом случае надёжнее задать переменные через launchctl setenv:
launchctl setenv HTTPS_PROXY "http://user:[email protected]:8000"
launchctl setenv HTTP_PROXY "http://user:[email protected]:8000"
# После этого перезапустите приложение Ollama полностью (выход из трея, не просто закрытие окна)
Настройка на Windows
В PowerShell переменные задаются для текущей сессии командой:
$env:HTTP_PROXY="http://user:[email protected]:8000"
$env:HTTPS_PROXY="http://user:[email protected]:8000"
$env:NO_PROXY="localhost,127.0.0.1"
ollama pull mistral
Если Ollama запущена как фоновая служба (значок в системном трее), сессионных переменных недостаточно — служба стартует при входе в систему
до того, как вы откроете PowerShell. Нужно задать переменные на уровне пользователя или системы через
"Параметры → Система → О программе → Дополнительные параметры системы → Переменные среды", после чего полностью завершить процесс
ollama.exe через диспетчер задач и перезапустить приложение.
Прокси для Ollama в Docker
Если Ollama запущена в контейнере (частый случай для серверных развёртываний), переменные окружения хоста автоматически внутрь контейнера не попадают —
их нужно пробросить явно через -e или секцию environment
в docker-compose:
docker run -d \
-e HTTP_PROXY="http://user:[email protected]:8000" \
-e HTTPS_PROXY="http://user:[email protected]:8000" \
-e NO_PROXY="localhost,127.0.0.1" \
-v ollama:/root/.ollama \
-p 11434:11434 \
--name ollama ollama/ollama
Аналогично в docker-compose.yml:
version: "3.8"
services:
ollama:
image: ollama/ollama
environment:
- HTTP_PROXY=http://user:[email protected]:8000
- HTTPS_PROXY=http://user:[email protected]:8000
- NO_PROXY=localhost,127.0.0.1
volumes:
- ollama:/root/.ollama
ports:
- "11434:11434"
volumes:
ollama:
После изменения переменных контейнер нужно пересоздать (docker compose up -d --force-recreate),
простого рестарта недостаточно, так как переменные окружения фиксируются при создании контейнера.
Прокси для systemd-сервиса Ollama
На Linux-серверах Ollama часто устанавливается как systemd-сервис через официальный install-скрипт. В этом случае переменные окружения
задаются через override-файл, а не через export в терминале:
sudo systemctl edit ollama.service
В открывшемся редакторе добавьте:
[Service]
Environment="HTTP_PROXY=http://user:[email protected]:8000"
Environment="HTTPS_PROXY=http://user:[email protected]:8000"
Environment="NO_PROXY=localhost,127.0.0.1"
Затем примените изменения:
sudo systemctl daemon-reload
sudo systemctl restart ollama
systemctl show ollama --property Environment
Последняя команда покажет, какие переменные реально видит процесс — удобный способ убедиться, что конфигурация применилась, прежде чем снова пытаться выполнить pull.
Разбор ошибок pull и их решение
Разберём самые частые сообщения об ошибках при скачивании моделей через прокси и что с ними делать.
dial tcp: lookup registry.ollama.ai: no such host
DNS-резолвинг не работает за прокси — обычно это значит, что запрос пытается уйти напрямую, минуя прокси-сервер, либо на машине вообще нет доступа
к DNS (закрытая корпоративная сеть). Решение: убедитесь, что HTTPS_PROXY
действительно подхвачен процессом (см. команду systemctl show выше),
и что прокси-сервер сам способен резолвить внешние домены (SOCKS5-прокси резолвит DNS на своей стороне, HTTP-прокси — тоже, но некоторые локальные прокси этого не делают).
proxyconnect tcp: dial tcp: connection refused
Ollama пытается подключиться к прокси, но получает отказ. Проверьте порт и хост на опечатки, убедитесь, что прокси-сервер действительно слушает указанный порт извне (а не только на localhost), и что файрвол не блокирует исходящее соединение к порту прокси.
407 Proxy Authentication Required
Прокси требует логин и пароль, но они не переданы или переданы неверно. Убедитесь, что в переменной окружения логин и пароль встроены в URL
в формате http://user:password@host:port, а специальные символы в пароле
(например, @ или :)
закодированы через URL-encoding (%40, %3A).
x509: certificate signed by unknown authority
Это признак корпоративного прокси с TLS-инспекцией (MITM), который подменяет SSL-сертификат своим корневым. Go-клиент Ollama не доверяет
этому сертификату. Решение — добавить корпоративный корневой сертификат в системное хранилище доверенных центров сертификации
(на Linux обычно через update-ca-certificates после копирования .crt-файла в
/usr/local/share/ca-certificates/). Отключать проверку сертификатов глобально не рекомендуется — это открывает путь к перехвату трафика.
context deadline exceeded / i/o timeout при скачивании слоя
Соединение обрывается на середине загрузки крупного слоя модели (часто это файлы по 4-40 ГБ). Такая ошибка почти всегда указывает на нестабильность или низкую пропускную способность прокси-сервера, а не на саму Ollama. Бесплатные или перегруженные публичные прокси обрывают долгие TCP-сессии, особенно если скачивание занимает больше нескольких минут. В таких случаях помогает переход на более стабильный канал — например, прокси дата-центров, которые обеспечивают высокую скорость и устойчивое соединение для скачивания больших файлов без разрывов.
Какой тип прокси выбрать для Ollama
Выбор типа прокси зависит от причины, по которой вам вообще нужен прокси для Ollama. Если задача — просто обойти ограничения корпоративного файрвола внутри своей же сети, подойдёт практически любой стабильный HTTP(S)-прокси. Но если цель — обойти гео-блокировку реестра моделей или скрыть, что запрос идёт из дата-центра (некоторые CDN ограничивают скорость для известных диапазонов IP облачных провайдеров), выбор типа прокси становится критичным.
| Тип прокси | Скорость | Когда использовать для Ollama |
|---|---|---|
| Дата-центр | Высокая | Скачивание крупных слоёв моделей (4-40+ ГБ) без разрывов, тестирование из разных ЦОД-локаций |
| Резидентные | Средняя | Обход гео-ограничений реестра, когда IP дата-центра попадает под региональный rate-limit |
| Мобильные | Переменная | Крайний случай при полной блокировке по диапазонам IP провайдеров, менее эффективен для больших загрузок из-за колебаний скорости |
Для большинства сценариев с Ollama — когда нужно просто стабильно докачать модель весом в десятки гигабайт — оптимальным выбором остаются прокси дата-центров: они дают максимальную пропускную способность и минимальные задержки, что критично при скачивании больших бинарных слоёв. Резидентные IP стоит подключать только если дата-центровые адреса действительно попадают под ограничения на стороне реестра моделей.
Диагностика подключения
Прежде чем тратить время на отладку самой Ollama, проверьте прокси напрямую через curl — это исключит путаницу между проблемой в приложении и проблемой в самом прокси-сервере:
# Проверка доступности реестра через прокси
curl -v -x http://user:[email protected]:8000 https://registry.ollama.ai/v2/
# Замер скорости скачивания через прокси
curl -x http://user:[email protected]:8000 -o /dev/null -w "%{speed_download}\n" https://registry.ollama.ai/v2/
# Запуск ollama serve с подробным логом
OLLAMA_DEBUG=1 ollama serve
Если curl успешно получает ответ, а ollama pull всё равно падает —
проблема почти наверняка в том, что переменные окружения не долетели до процесса сервера (сервис запущен с другим пользователем, из другого shell
или как systemd-юнит без override). Вернитесь к разделу про systemd и проверьте вывод systemctl show ollama --property Environment.
Если же curl тоже обрывается на скачивании крупного файла или показывает нестабильную скорость — причина на стороне прокси-сервера, и стоит задуматься о смене провайдера прокси на более стабильный вариант, ориентированный на передачу больших объёмов данных.
Заключение
Настройка Ollama за прокси сводится к трём ключевым моментам: переменные окружения должны быть заданы именно для процесса
ollama serve, а не для терминала, где вы вызываете pull;
формат URL прокси должен включать корректно закодированные логин и пароль; а при ошибках сертификатов нужно добавлять корпоративный
корневой сертификат в доверенное хранилище, а не отключать проверку TLS. Большинство ошибок pull — это не баги самой Ollama,
а следствие того, что сетевые настройки не применились к нужному процессу или прокси-сервер не выдерживает длительную передачу крупных файлов.
Если ваша основная задача — стабильно и быстро скачивать модели весом в десятки гигабайт без обрывов соединения, рекомендуем попробовать прокси дата-центров — они обеспечивают высокую пропускную способность, необходимую для загрузки крупных слоёв моделей. А если причина использования прокси — обход гео-ограничений реестра моделей, обратите внимание на резидентные прокси, которые реже попадают под региональные лимиты, применяемые к диапазонам IP облачных провайдеров.