06.10.2026
docker build proxy
Как настроить прокси для команды docker build: пошаговая инструкция
В современном мире DevOps и контейнеризации использование Docker — неотъемлемая часть разработки и деплоймента приложений. Но что делать, если ваш сервер или рабочая станция находятся за корпоративным прокси или в сети с ограниченным доступом к внешним ресурсам? В таких случаях помогает настройка docker build proxy — прокси-сервера для процесса сборки Docker-образов.
Почему важен proxy при docker build?
Когда вы запускаете команду docker build, Docker по умолчанию обращается к внешним репозиториям, например, для загрузки базовых образов или зависимостей. В корпоративных сетях, где доступ к внешним ресурсам ограничен или фильтруется, это может привести к ошибкам или задержкам. Настройка прокси помогает обеспечить стабильную и быструю сборку контейнеров.
Как настроить docker build proxy?
Рассмотрим основные способы настройки прокси для Docker:
- Настройка переменных окружения
Самый быстрый способ — задать переменные окружения при запуске команды:
export HTTP_PROXY="http://proxy.example.com:8080"
export HTTPS_PROXY="http://proxy.example.com:8080"
export NO_PROXY="localhost,127.0.0.1,.mycompany.local"
docker build ...
Это работает для текущей сессии и подходит, если сборки выполняются вручную.
- Конфигурация Docker демона
Для постоянной настройки прокси рекомендуется изменить конфигурационный файл Docker:
- На Linux:
/etc/systemd/system/docker.service.d/http-proxy.conf
Создайте или отредактируйте файл:
[Service]
Environment="HTTP_PROXY=http://proxy.example.com:8080"
Environment="HTTPS_PROXY=http://proxy.example.com:8080"
Environment="NO_PROXY=localhost,127.0.0.1,.mycompany.local"
Затем перезапустите Docker:
sudo systemctl daemon-reload
sudo systemctl restart docker
- Использование прокси внутри Dockerfile
Если необходимо, чтобы сборка использовала прокси, можно добавить команды в Dockerfile:
RUN mkdir -p /etc/systemd/system.conf.d/
RUN echo '[Service]\nEnvironment="HTTP_PROXY=http://proxy.example.com:8080"\nEnvironment="HTTPS_PROXY=http://proxy.example.com:8080"' > /etc/systemd/system.conf.d/proxy.conf
Но такой способ менее предпочтителен, так как лучше настроить переменные окружения на уровне Docker демона.
Полезные советы
- Убедитесь, что ваш прокси-сервер позволяет доступ к нужным ресурсам.
- Для корпоративных сетей используйте внутренние репозитории и зеркала Docker.
- Проверяйте работу прокси с помощью простых команд:
docker pull busybox
Если есть проблемы, проверьте настройки прокси и доступность сети.
Итог
Настройка docker build proxy — важный шаг для успешной работы в ограниченных сетях. Используйте переменные окружения или конфигурацию Docker демона для постоянной или временной настройки. Это обеспечит стабильную сборку образов и ускорит рабочий процесс.