SSD Nodes Learn Hosting plans →
Посібники Matt ConnorВід Matt Connor · Оновлено 2026-10-30

Ollama API без пароля: як захистити порт 11434

Ollama не має вбудованої автентифікації: кожен, хто досягне порту 11434, може запускати, завантажувати й видаляти моделі. Ось 3 способи захисту.

В Ollama API немає пароля

В Ollama API немає автентифікації. Для вхідних клієнтів не потрібні ні користувач, ні пароль, ні перевірка API key. Будь-хто, хто може встановити TCP-з’єднання з портом 11434, може переглядати список ваших моделей, запускати їх, завантажувати нові та видаляти наявні.

В офіційній документації це сформульовано прямо: «Локальний API за адресою http://localhost:11434 не потребує автентифікації». Уся модель безпеки зосереджена в слові локальний. За замовчуванням Ollama прив’язується до 127.0.0.1, тому на ноутбуці loopback-інтерфейс виконує роль контролю доступу. Якщо перенести цей listener на публічну адресу, контроль доступу зникає, оскільки його нічим не замінено.

Саме тому це важливо на VPS (virtual private server). Типова конфігурація безпечна. Перша зміна, яку зазвичай вносять, — відкрити listener, щоб друга машина могла використовувати модель. Саме ця зміна одразу усуває весь захист.

Що відкритий порт 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 виконує inference для іншого користувача. У тарифі з обмеженим CPU за політикою fair use тривале навантаження витрачає ваш ліміт на користь сторонньої особи, а контролювати витрати на AI workload на VPS стає значно складніше, якщо ви вже не єдиний викликач.
  • /api/pull записує дані на ваш диск. Розмір моделей різниться; навіть llama3.2:1b займає 1.3 GB. Цикл завантажень заповнює том, а переповнений диск виводить з ладу всі інші сервіси на сервері, а не лише Ollama.
  • Запити надходять у ваш процес і записуються в журнал. За стандартного рівня журналювання Ollama записує лише метадані: кінцеву точку, статус, затримку та адресу клієнта, але не текст prompt. Однак це все одно запис про те, хто і для чого використовував ваш сервер, у вашому journal, хоча ви не обирали його збирати.
  • /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 під час виклику hosted 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 listeners на кожній IPv6-адресі. Чи приймають вони також IPv4-з’єднання, залежить від параметра сокета IPV6_V6ONLY, який Linux типово вимикає (net.ipv6.bindv6only=0). Тому вважайте відкритими всі три варіанти.

Тепер перевірте доступ із зовнішньої мережі. Виконайте цю команду на своєму ноутбуці, а не на сервері:

curl -m 5 http://YOUR_SERVER_IP:11434/api/version

curl: (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 listener.

Відкритий доступ зазвичай з’являється одним із двох способів. Перший — навмисна зміна конфігурації, коли іншій машині потрібно було підключатися до моделі:

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 11434

Тепер ss має показувати 127.0.0.1:11434. Якщо воно й далі показує 0.0.0.0, використовується інший drop-in-файл із вищим пріоритетом. Виконайте systemctl cat ollama.service, щоб вивести unit і всі drop-in-файли разом із їхніми шляхами, а потім видаліть застарілий файл.

Щоб використовувати модель із ноутбука, перенаправте порт через 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"

Тоді порт існує лише на інтерфейсі, для підключення до якого потрібен ключ. Це також захищає від помилки у firewall, оскільки правило, яке випадково дозволяє доступ з усього світу, все одно не зможе відкрити listener, якого немає на публічному інтерфейсі.

Захист 2: reverse proxy, який перевіряє bearer token

Коли до моделі має звертатися щось із публічного інтернету, залиште Ollama доступною лише через loopback і розмістіть перед нею proxy. Proxy завершує TLS (transport layer security) і відхиляє запити без правильного заголовка. Ollama і далі приймає підключення лише з 127.0.0.1, тому proxy є єдиним шляхом доступу.

Спочатку згенеруйте справжній token. Не вигадуйте його вручну:

openssl rand -base64 36

Конфігурація сайту nginx, яка перевіряє token:

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 /, тому ці три endpoint-и відхиляються ще до перевірки token. Правильний token і далі надає доступ до інших endpoint-ів керування моделлю, зокрема /api/create і /api/blobs/:digest, тому ці три блоки не запобігають усім записам на диск.

proxy_set_header Host 127.0.0.1:11434; важливий, оскільки Ollama перевіряє вхідні заголовки Host і Origin. Якщо без змін передати публічне ім’я вузла proxy, можна отримати 403 Forbidden, сформований Ollama, а не nginx, що ускладнює діагностику. OLLAMA_ORIGINS — інший механізм для browser-клієнта, якому потрібно дозволити конкретний origin.

proxy_buffering off; важливий, оскільки Ollama передає відповідь потоково, token за token-ом. Якщо buffering увімкнено, nginx буферизує відповідь перед передаванням далі, через що потокові token-и надходять із затримкою.

proxy_read_timeout 600s; важливий, оскільки nginx за замовчуванням використовує 60 секунд. Цей timer відлічує час між двома послідовними читаннями з Ollama, а не весь час відповіді. Потокова відповідь, яка продовжує передавати token-и, щоразу скидає timer. Якщо Ollama не надсилає нічого протягом 60 секунд, timer спрацьовує. Наприклад, це може статися для запиту з "stream": false, який повертає всю відповідь одним фрагментом наприкінці, або через тривалу паузу перед появою першого token-а. Клієнт отримує 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. Друга має вивести список моделей. Якщо перша команда також повертає список моделей, перевірте, який server і location обробили запит, а також чи успішно завершилося перезавантаження. Блок map у неправильній області робить конфігурацію недійсною. Він має бути на рівні http, тому розмістіть його у файлі під /etc/nginx/conf.d/ або вище блоку server, але ніколи не всередині server.

Caddy виконує те саме завдання з basic authentication у чотири рядки. Для browser-клієнта це зручніше, ніж bearer token:

llm.example.com {
	basic_auth {
		apiuser PASTE_BCRYPT_HASH_HERE
	}
	reverse_proxy 127.0.0.1:11434
}

Виконайте caddy hash-password, щоб створити bcrypt hash, який очікує Caddy. Важливе зауваження щодо назви: до Caddy v2.8 директива називалася basicauth, а тепер називається basic_auth. Caddy і далі приймає старий варіант як deprecated alias, тому конфігурація зі старого посібника завантажиться, але Caddy попередить, що basicauth deprecated, і запропонує використовувати basic_auth. Перейменуйте директиву, коли побачите це попередження.

Незалежно від вибраного proxy, це один спільний secret для всіх. Кожен клієнт, який його має, отримує однаковий доступ. Щоб відкликати цей доступ, потрібно змінити конфігурацію та одночасно оновити її в усіх клієнтів.

Захист 3: шлюз, який видає ключі для кожного клієнта

Коли модель викликає більше ніж одна людина або застосунок, спільний токен стає непридатним. Ви не можете визначити, який клієнт створив навантаження, і не можете заблокувати одного клієнта, не заблокувавши всіх. Шлюз розміщується там, де раніше працював проксі, використовує той самий OpenAI-compatible API, видає окремий ключ для кожного клієнта та записує використання кожного ключа. Self-hosted шлюз LiteLLM є типовим рішенням. Додатково до контролю доступу він надає бюджети для окремих ключів і журнали запитів.

Правило із захисту 1 не змінюється. Ollama прив’язаний до 127.0.0.1, лише шлюз взаємодіє з ним, а шлюз є єдиним сервісом із публічним listener. Шлюз на сервері, де порт 11434 досі відкритий для всього світу, є лише формальністю, оскільки клієнти можуть просто обійти його.

Пастка firewall: опублікований порт контейнера обходить UFW

Саме тому на серверах із правильно налаштованим firewall з’являються доступні ззовні екземпляри.

UFW (uncomplicated firewall) записує свої правила в ланцюжок INPUT таблиці ядра filter, а INPUT обробляє пакети, адресовані безпосередньо хосту. Прапорець -p у Docker записує правило destination NAT (network address translation) у ланцюжок PREROUTING таблиці nat, яку ядро перевіряє до визначення подальшого маршруту пакета. Коли відбувається вибір маршруту, адресу призначення вже змінено на адресу контейнера, тому пакет пересилається, а не доставляється локально, і проходить через FORWARD, а не через INPUT. Правила UFW для INPUT взагалі не перевіряються, тому пакет обходить firewall, а не проходить через нього.

Саме тому ця послідовність залишає порт 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 і далі показує, що firewall активний і має політику default deny. Обидва результати одночасно правильні. Саме тому часто довіряють неправильному результату. Перевірити правило, яке це спричинило, можна так:

sudo iptables -t nat -L DOCKER -n

Виправлення полягає в зазначенні однієї адреси у прапорці publish:

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 tunnel і reverse proxy все ще можуть підключатися до порту, а інтернет — ні. У Docker старіших за 28.0.0 є виняток: машини в тому самому мережевому сегменті можуть підключатися до портів, опублікованих на localhost. Тому перед використанням цього захисту оновіть Docker. Пересоздання контейнера тут безпечне, оскільки моделі зберігаються в іменованому томі ollama, а не всередині контейнера.

Переконайтеся, що обидва способи перевірки дають однаковий результат:

docker port ollama
sudo ss -tlnp | grep 11434

docker 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

Unit у /etc/systemd/system/ollama.service задає User=ollama і Group=ollama. Не змінюйте ці параметри. Швидкий запуск ollama serve вручну в терміналі виконується від імені користувача, під яким ви ввійшли в систему. Якщо це root, неавтентифікований API записує файли від імені root. Перевірте, який саме варіант використовується:

ps -o user= -C ollama

Результат має бути ollama. Будь-який інший результат означає, що процес, запущений вручну, працює паралельно з unit або замість нього. Такий самий підхід застосовується до кожного daemon, який ви додасте пізніше, а рекомендація запускати служби від імені користувачів із мінімальними привілеями допомагає правильно це налаштувати.

Як перевірити безпеку endpoint API Ollama

Який би варіант ви не обрали, остаточну перевірку потрібно виконати з іншої машини:

curl -m 5 http://YOUR_SERVER_IP:11434/api/version
curl -m 5 http://YOUR_SERVER_IP:11434/api/tags

В обох випадках з’єднання має завершитися тайм-аутом або бути відхилене. Якщо ви налаштували проксі, ті самі два шляхи на імені хоста проксі мають повертати 401 без облікових даних і коректний JSON з ними.

Потім один раз перегляньте access log для запитів, виконаних у період, коли порт був відкритий:

journalctl -u ollama --since "-30 days" | grep GIN

Ollama записує один рядок для кожного запиту та вказує адресу клієнта:

[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 reverse proxy може містити публічну адресу клієнта, хоча Ollama коректно прослуховує лише 127.0.0.1. Публічна адреса в цьому стовпці не доводить прямого доступу до порту 11434, а відсутність відповідних рядків у журналі не доводить, що ніхто не підключався до нього. Порівняйте часові позначки з журналами та конфігурацією проксі й перевірте поточну доступність ззовні за допомогою тесту підключення. Якщо робота з моделями для вас нова, у матеріалі запуск Ollama на VPS описано встановлення, вибір розміру моделі та обмеження пам’яті, які визначають, що саме буде завантажено.

FAQ

Чи має Ollama API key або пароль?

Ні. Сервер, який ви запускаєте, не має жодної автентифікації, а в офіційній документації зазначено, що локальний API не потребує автентифікації. Обидва об’єкти, які називають "Ollama API key", призначені для іншого. Пара Ed25519 у /usr/share/ollama/.ollama/ підтверджує ваш комп’ютер для ollama.com, щоб ви могли надсилати моделі та отримувати приватні моделі. OLLAMA_API_KEY — це облікові дані, які ваш клієнт надсилає до hosted API за адресою https://ollama.com/api. Ваш власний ollama serve не використовує жоден із них для автентифікації вхідних клієнтів, тому контроль доступу має забезпечуватися мережею або проксі перед ним.

Чи безпечний OLLAMA_HOST=0.0.0.0, якщо налаштовано firewall?

Лише якщо firewall правильно блокує доступ до цього listener. 0.0.0.0 означає, що listener справді існує на публічному інтерфейсі, і ви покладаєтеся лише на firewall, який має не допускати до нього підключень. Опублікований Docker порт Ollama потребує окремої уваги, оскільки правило DNAT, яке Docker додає до таблиці nat, обробляється до того, як пакет досягне ланцюжка INPUT, де працює UFW. Тому пакет пересилається, а правила INPUT UFW його не бачать. Прив’язка до 127.0.0.1 або до адреси приватного тунелю прибирає listener із публічного інтерфейсу, тому помилка у firewall більше нічого не зможе відкрити.

Як перевірити, чи відкритий мій 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. Це прибирає listener, а не просто переносить його.

Хтось отримав доступ до мого відкритого Ollama. Що перевірити?

Спочатку прив’яжіть його до 127.0.0.1 і перезапустіть сервіс, щоб припинити доступ до нього ще до початку розслідування. Потім виконайте journalctl -u ollama --since "-30 days" | grep GIN, щоб переглянути адреси клієнтів, кінцеві точки та часові мітки. Gin також читає заголовки forwarded client address, тому порівняйте ці записи з журналами проксі, перш ніж вважати адресу доказом прямого доступу. Порівняйте ollama list зі списком моделей, які ви планували мати, оскільки /api/pull не потребує автентифікації, а модель, яку ви не завантажували, одночасно займає місце на диску і є доказом доступу. Перевірте вільне місце за допомогою df -h. Журнал доступу за замовчуванням записує метадані запитів, але не назву моделі, текст prompt або згенеровану відповідь.

Чи була ця стаття корисною?