☰
28.10.2025

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

Иногда возникает необходимость управлять 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 может принимать соединения через:

Настройка 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

Скриншот №3 — Docker API

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

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

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

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

Для защищённого доступа по сети используйте 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).