Как защитить API Ollama паролем
В Ollama отсутствует встроенная аутентификация, поэтому любой доступ к порту 11434 позволяет управлять моделями. Узнайте, как закрыть доступ через Nginx или SSH-туннель.
В Ollama API отсутствует пароль
В Ollama API нет аутентификации. Для входящих подключений не проверяются ни пользователь, ни пароль, ни API key. Любой клиент, способный установить TCP-соединение с портом 11434, может просматривать список ваших моделей, запускать их, загружать новые и удалять существующие.
В официальной документации это указано прямо: "Локальный API по адресу http://localhost:11434 не требует аутентификации". Слово локальный определяет всю модель безопасности. По умолчанию Ollama привязывается к 127.0.0.1, поэтому на ноутбуке интерфейс loopback выполняет роль контроля доступа. Если перенести прослушивание на публичный адрес, контроль доступа исчезнет, так как его ничто не заменяет.
Именно поэтому данный вопрос критичен для VPS (виртуального выделенного сервера). Настройки по умолчанию безопасны. Первое изменение, которое вносит большинство пользователей — открытие порта для доступа к модели с другого устройства — одновременно отключает всю защиту.
Что раскрывает открытый порт 11434
Каждая конечная точка. Режима «только для чтения» и отдельного порта администратора не существует. Это реальные запросы, направленные на адрес сервера, а не на localhost:
# List every model on the box
curl http://SERVER_IP:11434/api/tags
# See what is loaded into memory right now
curl http://SERVER_IP:11434/api/ps
# Run a prompt on your hardware
curl http://SERVER_IP:11434/api/generate -d '{"model":"llama3.2","prompt":"Why is the sky blue?"}'
# Write several gigabytes to your disk
curl http://SERVER_IP:11434/api/pull -d '{"model":"llama3.2"}'
# Remove a model
curl -X DELETE http://SERVER_IP:11434/api/delete -d '{"model":"llama3.2"}'С точки зрения оператора, возникают четыре проблемы:
- Ваш CPU или GPU выполняет вычисления для кого-то другого. Если ваш тарифный план ограничен по CPU, постоянная нагрузка означает, что ваш лимит расходует посторонний человек, а контроль расходов на AI-нагрузки на VPS становится гораздо сложнее, когда вы не единственный пользователь.
/api/pullзаписывает данные на ваш диск. Размеры моделей различаются; дажеllama3.2:1bзанимает 1.3 GB. Циклическая загрузка моделей заполняет том, а переполненный диск выводит из строя все остальные службы на сервере, а не только Ollama.- Запросы поступают в ваш процесс и регистрируются в логах. При стандартном уровне логирования Ollama записывает только метаданные: конечную точку, статус, задержку и адрес клиента, но не текст запроса. Тем не менее, это запись о том, кто использовал ваш сервер и для чего, которая сохраняется в вашем журнале, хотя вы не планировали собирать эти данные.
/api/deleteудаляет модели. Чтобы вернуть их, потребуется повторная загрузка, которая расходует ваш трафик.
Для всего этого не требуется эксплойт. Это задокументированный API, работающий в точном соответствии с проектом.
Ключ Ed25519 не является средством контроля доступа
Поиск по запросу "Ollama API key" приводит к двум разным понятиям. Ни одно из них не является паролем для вашего сервера, и их разделение устраняет большую часть путаницы.
Первое — это пара ключей идентификации. Ollama генерирует пару ключей Ed25519 при первом запуске. В Linux скрипт установки создает системного пользователя с именем ollama, чей домашний каталог находится в /usr/share/ollama, поэтому пара ключей хранится здесь:
/usr/share/ollama/.ollama/id_ed25519
/usr/share/ollama/.ollama/id_ed25519.pubЭтот ключ направлен вовне. ollama signin регистрирует открытую часть ключа в вашей учетной записи ollama.com, и именно она авторизует вас для отправки модели в реестр или получения приватной модели. Этот ключ подтверждает ollama.com, что запрос идет с вашей машины. Он никак не ограничивает клиентов, подключающихся к вашему серверу. Удаление, ротация или отсутствие этого ключа никак не влияют на то, кто может обращаться к вашему API.
Второе — это OLLAMA_API_KEY. Эта переменная содержит ключ, который вы создаете на https://ollama.com/settings/keys, и ваш клиент отправляет его в заголовке Authorization: Bearer $OLLAMA_API_KEY при обращении к API по адресу https://ollama.com/api. Это учетные данные для их сервиса, которые используете вы как клиент. Ваш собственный экземпляр ollama serve не использует этот ключ для аутентификации входящих запросов. Установка OLLAMA_API_KEY на вашем VPS не устанавливает пароль на доступ к самому VPS.
Таким образом, не существует настройки, которую можно просто включить. Три описанных ниже метода защиты работают одинаково: ограничьте доступ к порту и установите перед ним прокси, который будет выполнять проверку.
Проверка портов, которые прослушивает сервер в данный момент
sudo ss -tlnp | grep 11434Безопасный результат указывает на адрес loopback:
LISTEN 0 4096 127.0.0.1:11434 0.0.0.0:* users:(("ollama",pid=812,fd=3))Результат с открытым доступом указывает на все сетевые интерфейсы:
LISTEN 0 4096 0.0.0.0:11434 0.0.0.0:* users:(("ollama",pid=812,fd=3))0.0.0.0 означает все IPv4-адреса на сервере, включая публичный. *:11434 и [::]:11434 — это wildcard-адреса, прослушивающие все IPv6-интерфейсы. Принимают ли они также IPv4-трафик, зависит от опции сокета IPV6_V6ONLY, которая в Linux по умолчанию отключена (net.ipv6.bindv6only=0), поэтому любой из этих трех вариантов следует считать открытым доступом.
Теперь подтвердите доступность извне. Выполните эту команду на своем локальном компьютере, а не на сервере:
curl -m 5 http://YOUR_SERVER_IP:11434/api/versioncurl: (28) Connection timed out after 5001 milliseconds — это желаемый ответ, как и curl: (7) Failed to connect ... Connection refused. JSON-объект, содержащий поле version, означает, что API доступен любому желающему. Тестирование через curl на самом сервере не показывает, может ли к нему подключиться другая машина. Если у сервера есть IPv6-адрес, повторите тест для него с помощью curl -6 -m 5 http://[YOUR_SERVER_IPV6]:11434/api/version, так как закрытый порт IPv4 ничего не говорит о состоянии слушателя IPv6.
Открытый доступ обычно появляется одним из двух способов. Первый — это намеренное редактирование конфигурации, когда потребовалось обеспечить доступ к модели с другой машины:
sudo systemctl edit ollama.service[Service]
Environment="OLLAMA_HOST=0.0.0.0:11434"Эта единственная строка и является причиной открытого доступа. Второй способ связан с Docker, и он не требует от вас редактирования каких-либо файлов. Этому посвящен отдельный раздел ниже.
Защита 1: ограничение localhost и использование туннеля
Используйте этот метод в первую очередь. Он не требует установки дополнительного ПО и не создает учетных данных, которые могут быть скомпрометированы. Порт не открывается на публичном интерфейсе, поэтому сканирование не обнаружит сервис.
Явно укажите адрес привязки вместо использования значения по умолчанию:
sudo systemctl edit ollama.service[Service]
Environment="OLLAMA_HOST=127.0.0.1:11434"Эта команда создает файл /etc/systemd/system/ollama.service.d/override.conf. Примените изменения и проверьте результат:
sudo systemctl daemon-reload
sudo systemctl restart ollama
sudo ss -tlnp | grep 11434ss теперь должен отображать 127.0.0.1:11434. Если по-прежнему отображается 0.0.0.0, значит, приоритет имеет другой файл конфигурации (drop-in). Выполните systemctl cat ollama.service, чтобы вывести список юнита и всех связанных с ним файлов конфигурации с указанием путей, после чего удалите устаревший файл.
Чтобы использовать модель с вашего ноутбука, пробросьте порт через SSH:
ssh -N -L 11434:127.0.0.1:11434 you@your-server-L 11434:127.0.0.1:11434 открывает порт 11434 на вашем ноутбуке и перенаправляет весь трафик на 127.0.0.1:11434 с точки зрения сервера. -N указывает SSH не выполнять удаленную команду, поэтому процесс просто поддерживает туннель открытым. Пока он запущен, на вашем ноутбуке будет работать следующая команда:
curl -s http://localhost:11434/api/tagsВы можете столкнуться с двумя ошибками. bind [127.0.0.1]:11434: Address already in use означает, что локальный адрес и порт уже заняты — Ollama, другим SSH-туннелем или иной программой. Выберите другой локальный порт с помощью -L 11500:127.0.0.1:11434 и направьте клиент на 11500. Если запрос через туннель возвращает пустой ответ, проверьте ss на сервере и вывод ошибок SSH, прежде чем определять, какой именно сервис дал сбой.
Для нескольких клиентских машин частная сеть эффективнее, чем отдельный туннель для каждого пользователя. Объедините машины в сеть WireGuard или Tailscale, а затем привяжите Ollama к адресу в этой сети вместо 0.0.0.0:
[Service]
Environment="OLLAMA_HOST=10.8.0.1:11434"В этом случае порт будет существовать только в интерфейсе, для доступа к которому требуется ключ. Это защищает от ошибок в настройках брандмауэра: даже если правило случайно откроет доступ для всех, сервис останется недоступным, так как он не привязан к публичному интерфейсу.
Защита 2: обратный прокси с проверкой bearer-токена
Если к модели необходимо обращаться из публичного интернета, оставьте Ollama на loopback-интерфейсе и установите перед ней прокси. Прокси выполняет TLS termination (завершение TLS) и отклоняет запросы без корректного заголовка. Ollama по-прежнему принимает соединения только с 127.0.0.1, поэтому прокси является единственным доступным путем.
Сначала сгенерируйте настоящий токен. Не придумывайте его вручную:
openssl rand -base64 36Конфигурация сайта nginx для проверки токена:
map $http_authorization $ollama_ok {
default 0;
"Bearer PASTE_YOUR_GENERATED_TOKEN_HERE" 1;
}
server {
listen 443 ssl;
server_name llm.example.com;
ssl_certificate /etc/letsencrypt/live/llm.example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/llm.example.com/privkey.pem;
location = /api/pull { return 403; }
location = /api/delete { return 403; }
location = /api/push { return 403; }
location / {
if ($ollama_ok = 0) { return 401; }
proxy_pass http://127.0.0.1:11434;
proxy_set_header Host 127.0.0.1:11434;
proxy_buffering off;
proxy_read_timeout 600s;
}
}Пять строк здесь выполняют основную работу, и каждая из них предотвращает сбой, с которым вы иначе столкнулись бы.
Использование if внутри блока location в nginx обычно считается плохой практикой, но тело размером ровно return — это одна из двух форм, работающих предсказуемо, поэтому данный вариант безопасен.
location = /api/pull — это точное совпадение, а nginx ставит точные совпадения выше префикса location /, поэтому в доступе к этим трем эндпоинтам будет отказано еще до проверки токена. Валидный токен по-прежнему дает доступ к другим эндпоинтам управления моделями, включая /api/create и /api/blobs/:digest, поэтому эти три блока не предотвращают все операции записи на диск.
proxy_set_header Host 127.0.0.1:11434; важен, так как Ollama проверяет входящие заголовки Host и Origin. Передача публичного имени хоста прокси напрямую может привести к тому, что 403 Forbidden будет исходить от Ollama, а не от nginx, что затрудняет отладку. OLLAMA_ORIGINS — это еще один рычаг, необходимый для браузерного клиента, которому нужно разрешить конкретный origin.
proxy_buffering off; важен, так как Ollama передает ответ потоком, токен за токеном. При включенном буферизации nginx накапливает ответ перед отправкой, что задерживает доставку потоковых токенов.
proxy_read_timeout 600s; важен, так как по умолчанию в nginx установлено значение 60 секунд, и этот таймер отсчитывается между двумя последовательными операциями чтения из Ollama, а не для всего ответа целиком. Потоковый ответ, который постоянно генерирует токены, сбрасывает этот таймер. Запрос, при котором Ollama ничего не отправляет в течение 60 секунд, вызывает срабатывание таймера; например, запрос с "stream": false, который возвращает весь ответ целиком в конце, или длительная пауза перед появлением первого токена. Клиент получает 504 Gateway Time-out, а в /var/log/nginx/error.log записывается upstream timed out (110: Connection timed out) while reading response header from upstream. Запрос при этом продолжал выполняться, но nginx прервал его.
Перезагрузите конфигурацию и протестируйте оба пути:
sudo nginx -t && sudo systemctl reload nginx
curl -s -o /dev/null -w '%{http_code}\n' https://llm.example.com/api/tags
curl -s -H "Authorization: Bearer YOUR_TOKEN" https://llm.example.com/api/tagsПервый должен вывести 401. Второй должен вывести список ваших моделей. Если первый запрос также возвращает список моделей, проверьте, какой сервер и location обработали запрос, и успешно ли прошла перезагрузка. Блок map в неверной области видимости делает конфигурацию невалидной. Он должен находиться на уровне http, поэтому разместите его в файле в директории /etc/nginx/conf.d/ или перед блоком server, но никогда не внутри server.
Caddy выполняет ту же задачу с помощью базовой аутентификации всего в четырех строках, что лучше подходит для браузерного клиента, чем bearer-токен:
llm.example.com {
basic_auth {
apiuser PASTE_BCRYPT_HASH_HERE
}
reverse_proxy 127.0.0.1:11434
}Запустите caddy hash-password, чтобы получить bcrypt-хеш, который ожидает Caddy. Примечание по именованию: директива называлась basicauth до версии Caddy v2.8, а теперь называется basic_auth. Caddy по-прежнему принимает старое написание как устаревший псевдоним, поэтому конфигурация, скопированная из старого руководства, загрузится, но Caddy выдаст предупреждение о том, что basicauth устарело, и предложит использовать basic_auth. Переименуйте директиву, когда увидите это предупреждение.
Какой бы прокси вы ни выбрали, это будет один общий секрет для всех. Каждый клиент, владеющий им, имеет идентичный доступ, а отзыв токена означает редактирование конфигурации и одновременное обновление всех вызывающих сторон.
Защита 3: шлюз, выдающий ключи для каждого клиента
Когда модель используют более одного человека или приложения, общий токен перестает быть подходящим решением. Вы не можете определить, какой клиент создал нагрузку, и не можете отключить одного из них, не отключив всех остальных. Шлюз располагается там же, где находился прокси, использует тот же API, совместимый с OpenAI, выдает отдельный ключ для каждого клиента и фиксирует использование для каждого ключа. Самостоятельно размещаемый шлюз LiteLLM — стандартное решение, которое добавляет бюджеты для каждого ключа и журналы запросов поверх контроля доступа.
Правило из первой защиты остается неизменным. Ollama привязывается к 127.0.0.1, шлюз является единственным процессом, который взаимодействует с ней, и шлюз — единственный сервис с публичным слушающим портом. Шлюз на машине, где порт 11434 все еще открыт для всего мира, является лишь декорацией, поскольку вызывающие стороны могут просто обойти его.
Ловушка межсетевого экрана: опубликованный порт контейнера обходит UFW
Именно поэтому на серверах, владельцы которых правильно настроили межсетевой экран, существуют открытые экземпляры сервисов.
UFW (uncomplicated firewall) записывает свои правила в цепочку INPUT таблицы filter ядра, а INPUT обрабатывает пакеты, адресованные самому хосту. Флаг -p в Docker добавляет правило трансляции сетевых адресов (DNAT) в цепочку PREROUTING таблицы nat, которое ядро проверяет до того, как решит, куда направить пакет. К моменту принятия решения о маршрутизации адрес назначения уже изменен на адрес контейнера, поэтому пакет пересылается, а не доставляется локально, и проходит через FORWARD вместо INPUT. Правила INPUT в UFW не учитываются, поэтому пакет проходит мимо межсетевого экрана, а не через него.
Вот почему эта последовательность оставляет порт 11434 открытым для интернета:
sudo ufw default deny incoming
sudo ufw enable
docker run -d -v ollama:/root/.ollama -p 11434:11434 --name ollama ollama/ollamaи sudo ufw status по-прежнему сообщает, что межсетевой экран активен с политикой запрета по умолчанию. Оба показания верны одновременно, и именно поэтому администраторы доверяют неверному из них. Вы можете увидеть правило, которое это вызвало:
sudo iptables -t nat -L DOCKER -nРешение заключается в указании адреса во флаге публикации:
docker rm -f ollama
docker run -d -v ollama:/root/.ollama -p 127.0.0.1:11434:11434 --name ollama ollama/ollama-p 11434:11434 не указывает адрес хоста, поэтому Docker публикует порт на всех адресах хоста, как IPv4 (0.0.0.0), так и IPv6 ([::]). Указание 127.0.0.1 привязывает хост-часть маппинга к интерфейсу обратной петли (loopback), поэтому ваш SSH-туннель и обратный прокси по-прежнему смогут получить к нему доступ, а интернет — нет. В версиях Docker старше 28.0.0 есть исключение: машины в том же сегменте сети могут получить доступ к портам, опубликованным на localhost, поэтому обновитесь, прежде чем полагаться на эту защиту. Пересоздание контейнера здесь безопасно, так как модели хранятся в именованном томе ollama, а не внутри контейнера.
Убедитесь, что оба представления согласуются:
docker port ollama
sudo ss -tlnp | grep 11434docker port ollama должен вывести 11434/tcp -> 127.0.0.1:11434. Если он выводит 0.0.0.0:11434 или [::]:11434, вы все еще уязвимы. Изучите этот механизм один раз, и он будет применим к любому контейнеру, который вы публикуете: почему опубликованные порты Docker обходят UFW описывает цепочку DOCKER-USER и правила, которые сохраняются после перезапуска Docker. Если вы все еще настраиваете политику самого хоста, правила UFW, необходимые для нового VPS описывают базу, на которой это строится. В Rocky или AlmaLinux нет UFW для настройки, поэтому та же базовая политика, написанная для firewalld — это то, с чего стоит начать.
От имени какого пользователя запущен процесс
Скрипт установки для Linux создает выделенную учетную запись и запускает службу от ее имени:
useradd -r -s /bin/false -U -m -d /usr/share/ollama ollamaЮнит в /etc/systemd/system/ollama.service затем устанавливает User=ollama и Group=ollama. Не меняйте эти параметры. Быстрый ollama serve, запущенный вручную в терминале, выполняется от имени того пользователя, под которым вы вошли в систему. Если это root, то неаутентифицированный API будет записывать файлы с правами root. Проверьте, кто является владельцем процесса:
ps -o user= -C ollamaРезультатом должно быть ollama. Любое другое значение означает, что процесс, запущенный вручную, работает параллельно с юнитом или вместо него. Тот же подход применим к любому демону, который вы добавите позже, и запуск служб от имени пользователей с минимальными привилегиями подробно описывает этот процесс.
Как проверить безопасность API-эндпоинта Ollama
Что бы вы ни выбрали, один тест расставит всё по местам; его нужно запустить с другой машины:
curl -m 5 http://YOUR_SERVER_IP:11434/api/version
curl -m 5 http://YOUR_SERVER_IP:11434/api/tagsОба запроса должны завершиться по таймауту или получить отказ в соединении. Если вы настроили прокси, те же два пути на хостнейме прокси должны возвращать 401 без учетных данных и корректный JSON при их наличии.
Затем изучите журнал доступа на предмет запросов, выполненных в то время, когда порт был открыт:
journalctl -u ollama --since "-30 days" | grep GINOllama записывает по одной строке на каждый запрос и включает в неё адрес клиента:
[GIN] 2026/08/12 - 14:01:10 | 200 | 103.965898ms | 127.0.0.1 | POST "/api/generate"Этот адрес берется из ClientIP() фреймворка Gin, который также проверяет заголовки X-Forwarded-For и X-Real-IP от доверенных прокси. Таким образом, запрос через loopback-прокси может отображать публичный адрес клиента, даже если Ollama корректно привязана к 127.0.0.1. Наличие публичного адреса в этом столбце не доказывает прямой доступ к порту 11434, а отсутствие соответствующих записей в логах не гарантирует, что никто не пытался получить доступ. Сравните временные метки с логами и конфигурацией вашего прокси, а для проверки текущей доступности используйте тест с внешним подключением. Если работа с моделями для вас в новинку, в руководстве запуск Ollama на VPS описаны установка, подбор размера моделей и лимиты памяти, определяющие, что именно будет загружено.
FAQ
Есть ли у Ollama API-ключ или пароль?
Нет. Сервер, который вы запускаете, не имеет никакой аутентификации, и официальная документация подтверждает, что локальный API не требует её наличия. Оба понятия, которые называют «Ollama API key», относятся к другому. Пара Ed25519 в /usr/share/ollama/.ollama/ подтверждает вашу машину для ollama.com, чтобы вы могли загружать модели и скачивать приватные. OLLAMA_API_KEY — это учетные данные, которые ваш клиент отправляет на хостинговый API по адресу https://ollama.com/api. Ваш собственный ollama serve не использует ни то, ни другое для аутентификации входящих клиентов, поэтому контроль доступа должен обеспечиваться на уровне сети или с помощью прокси-сервера перед ним.
Безопасен ли OLLAMA_HOST=0.0.0.0, если у меня есть межсетевой экран?
Только если межсетевой экран корректно блокирует доступ к этому слушающему порту. 0.0.0.0 означает, что слушатель действительно существует на публичном интерфейсе, и вы полагаетесь исключительно на межсетевой экран, чтобы сделать его недоступным. Опубликованный через Docker порт Ollama требует отдельного внимания, так как правило DNAT, которое Docker добавляет в таблицу nat, обрабатывается до того, как пакет попадет в цепочку INPUT, где работает UFW. В результате пакет пересылается, и правила INPUT в UFW его не видят. Привязка к 127.0.0.1 или к адресу частного туннеля убирает слушателя с публичного интерфейса, поэтому ошибка в настройках межсетевого экрана не приведет к раскрытию сервиса.
Как проверить, открыт ли мой порт Ollama для интернета?
Запустите sudo ss -tlnp | grep 11434 на сервере и curl -m 5 http://YOUR_SERVER_IP:11434/api/version с другой машины. ss, показывающий 127.0.0.1:11434, и таймаут удаленного curl — это та пара ответов, которую вы хотите получить. ss, показывающий 0.0.0.0:11434 или *:11434, в то время как удаленный curl возвращает JSON, означает, что API полностью доступен. Тестирование с помощью curl на самом сервере не позволяет установить, может ли другая машина получить к нему доступ.
Могу ли я просто сменить порт с 11434 на какой-нибудь случайный?
Нет, и причина этого заслуживает упоминания. Другой порт не замедляет ничего, кроме сканирования одного конкретного порта. Сканеры проходят весь диапазон, и один запрос к /api/tags идентифицирует сервис независимо от того, на какой порт он пришел. Смена порта также нарушает настройки по умолчанию во всех клиентах и усложняет понимание вашей собственной конфигурации в будущем. Вместо этого привяжите сервис к loopback: это удалит слушателя, а не просто переместит его.
Кто-то получил доступ к моему открытому Ollama. Что мне проверить?
Сначала привяжите его к 127.0.0.1 и перезапустите сервис, чтобы прекратить доступ до начала расследования. Затем запустите journalctl -u ollama --since "-30 days" | grep GIN, чтобы просмотреть адреса клиентов, конечные точки и временные метки. Gin также считывает заголовки с перенаправленным адресом клиента, поэтому сравните эти записи с логами вашего прокси-сервера, прежде чем считать адрес доказательством прямого доступа. Сравните ollama list с моделями, которые вы планировали использовать, так как /api/pull не требует аутентификации, и модель, которую вы не скачивали, является одновременно и расходом дискового пространства, и доказательством вторжения. Проверьте свободное место с помощью df -h. Стандартный лог доступа записывает метаданные запроса, а не имя модели, текст промпта или сгенерированный ответ.