Новости
Обновление услуги LLM: управление API-ключами, моделями и расходами
KA
июня 9, 2025
Обновлено октября 28, 2025

Как настроить доступ к Docker API?

Docker Linux

Иногда возникает необходимость управлять Docker не только через локальную команду docker, но и удалённо — с помощью API. В этой статье разберёмся, как включить доступ к Docker API, какие способы подключения существуют, и как обеспечить безопасность соединения.

Запустите проект за минуты с VPS в России — предустановленное ПО, высокая производительность и надёжная инфраструктура Serverspace - Арендовать VPS

По умолчанию Docker API доступен только через сокет. После установки Docker управление контейнерами происходит через Unix-сокет /var/run/docker.sock. Это локальный способ, и он не позволяет подключаться по сети. Если вы попробуете отправить HTTP-запрос к localhost:2375, то получите ошибку подключения:

curl http://localhost:2375/version
# curl: (7) Failed to connect to localhost port 2375: Connection refused

Чтобы использовать API удалённо, нужно изменить конфигурацию Docker.

Способы доступа к Docker API

Docker может принимать соединения через:

  • Unix-сокет (/var/run/docker.sock) — по умолчанию.
  • TCP-сокет без TLS (например, tcp://0.0.0.0:2375) — открытый доступ, НЕ рекомендуется.
  • TCP-сокет с TLS (например, tcp://0.0.0.0:2376) — безопасный способ.

Настройка Docker API через конфигурационные файлы. Для начала нужно изменить параметры запуска Docker-сервиса. Создайте или измените файл:

nano /etc/docker/daemon.json

Добавьте или отредактируйте содержимое:

{
"hosts": ["unix:///var/run/docker.sock", "tcp://0.0.0.0:2375"]
}

Так как Docker не предотвращает коллизию конфигураций, то уберем аргументы запуска systemd, приведите к виду, как показано на скриншоте:

nano /lib/systemd/system/docker.service
Настройка сервиса
Скриншот №1 — Настройка сервиса

Обратите внимание, что порт 2375 используется без шифрования. Используйте его только в тестовой среде или с firewall'ом, так как изначально в Docker API не предусмотрены механизмы аутентификации, которые позволили бы валидировать пользователей. Из-за этой мисконфигурации сейчас могут быть заражены свыше 16 тысяч машин:

Уязвимые машины
Скриншот №2 — Уязвимые машины

Примените изменения и перезапустите Docker:

sudo systemctl daemon-reexec
sudo systemctl daemon-reload
sudo systemctl restart docker

Проверьте доступность API:

curl http://localhost:2375/version
docker API
Скриншот №3 — Docker API

Как подключиться к API с другого компьютера

На клиентской машине можно использовать:

export DOCKER_HOST=tcp://IP_СЕРВЕРА:2375
docker ps

Если соединение не устанавливается — убедитесь, что:

  • Сервер слушает порт 2375 (ss -tuln | grep 2375)
  • Порт открыт в firewall (ufw allow 2375/tcp)
  • Docker действительно запущен с нужным флагом -H
  • Безопасный вариант — TLS
  • Генерации SSL-сертификатов

Для защищённого доступа по сети используйте TLS. Укажем пути к сертификатам при запуске Docker:

dockerd \
-H=unix:///var/run/docker.sock \
-H=0.0.0.0:2376 \
--tlsverify \
--tlscacert=/etc/docker/ssl/ca.pem \
--tlscert=/etc/docker/ssl/server-cert.pem \
--tlskey=/etc/docker/ssl/server-key.pem

Что делать, если API не работает

1. Docker не слушает TCP-порт. Проверьте аргументы запуска:

ps aux | grep dockerd

Убедитесь, что есть флаг -H tcp://0.0.0.0:2375.

2. Порт заблокирован. Проверьте firewall:

sudo ufw allow 2375/tcp

3. SELinux или AppArmor блокирует соединение
На системах с SELinux или AppArmor могут потребоваться дополнительные разрешения.

Docker API — мощный инструмент для управления контейнерами, но он требует аккуратной настройки. Никогда не открывайте порт 2375 в публичную сеть без защиты. Лучше использовать TLS или проксирование через защищённый reverse-proxy (например, Nginx с HTTPS).

Оценка:
5 из 5
Аverage rating : 5
Оценок: 2
191028 Санкт-Петербург Литейный пр., д. 26, Лит. А
+7 (812) 403-06-99
700 300
ООО «ИТГЛОБАЛКОМ ЛАБС»
700 300