Иногда возникает необходимость управлять Docker не только через локальную команду docker, но и удалённо — с помощью API. В этой статье разберёмся, как включить доступ к Docker API, какие способы подключения существуют, и как обеспечить безопасность соединения.
По умолчанию Docker API доступен только через сокет. После установки Docker управление контейнерами происходит через Unix-сокет /var/run/docker.sock. Это локальный способ, и он не позволяет подключаться по сети. Если вы попробуете отправить HTTP-запрос к localhost:2375, то получите ошибку подключения:
# 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-сервиса. Создайте или измените файл:
Добавьте или отредактируйте содержимое:
"hosts": ["unix:///var/run/docker.sock", "tcp://0.0.0.0:2375"]
}
Так как Docker не предотвращает коллизию конфигураций, то уберем аргументы запуска systemd, приведите к виду, как показано на скриншоте:
Обратите внимание, что порт 2375 используется без шифрования. Используйте его только в тестовой среде или с firewall'ом, так как изначально в Docker API не предусмотрены механизмы аутентификации, которые позволили бы валидировать пользователей. Из-за этой мисконфигурации сейчас могут быть заражены свыше 16 тысяч машин:
Примените изменения и перезапустите Docker:
sudo systemctl daemon-reload
sudo systemctl restart docker
Проверьте доступность API:
Как подключиться к API с другого компьютера
На клиентской машине можно использовать:
docker ps
Если соединение не устанавливается — убедитесь, что:
- Сервер слушает порт 2375 (ss -tuln | grep 2375)
- Порт открыт в firewall (ufw allow 2375/tcp)
- Docker действительно запущен с нужным флагом -H
- Безопасный вариант — TLS
- Генерации SSL-сертификатов
Для защищённого доступа по сети используйте TLS. Укажем пути к сертификатам при запуске Docker:
-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-порт. Проверьте аргументы запуска:
Убедитесь, что есть флаг -H tcp://0.0.0.0:2375.
2. Порт заблокирован. Проверьте firewall:
3. SELinux или AppArmor блокирует соединение
На системах с SELinux или AppArmor могут потребоваться дополнительные разрешения.
Docker API — мощный инструмент для управления контейнерами, но он требует аккуратной настройки. Никогда не открывайте порт 2375 в публичную сеть без защиты. Лучше использовать TLS или проксирование через защищённый reverse-proxy (например, Nginx с HTTPS).