Frod

06.10.2026

docker build proxy

Frod — свобода без границ

Как настроить прокси для команды docker build: пошаговая инструкция

В современном мире DevOps и контейнеризации использование Docker — неотъемлемая часть разработки и деплоймента приложений. Но что делать, если ваш сервер или рабочая станция находятся за корпоративным прокси или в сети с ограниченным доступом к внешним ресурсам? В таких случаях помогает настройка docker build proxy — прокси-сервера для процесса сборки Docker-образов.

Почему важен proxy при docker build?

Когда вы запускаете команду docker build, Docker по умолчанию обращается к внешним репозиториям, например, для загрузки базовых образов или зависимостей. В корпоративных сетях, где доступ к внешним ресурсам ограничен или фильтруется, это может привести к ошибкам или задержкам. Настройка прокси помогает обеспечить стабильную и быструю сборку контейнеров.

Как настроить docker build proxy?

Рассмотрим основные способы настройки прокси для Docker:

  1. Настройка переменных окружения

Самый быстрый способ — задать переменные окружения при запуске команды:

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 ...

Это работает для текущей сессии и подходит, если сборки выполняются вручную.

  1. Конфигурация 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
  1. Использование прокси внутри 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 демона для постоянной или временной настройки. Это обеспечит стабильную сборку образов и ускорит рабочий процесс.