Настройка прокси для Docker на личном VPS в 2026 году

Чтобы Docker загружал образы и работал через прокси, нужно указать прокси-сервер в конфигурации Docker и переменных окружения. На личном VPS SANSARA это делается за несколько шагов: подключитесь к своему серверу через кабинет, откройте терминал (если нужен) или используйте Telegram-бота SANSARA для управления, затем задайте настройки прокси в systemd или в ~/.docker/config.json. После этого Docker будет использовать защищённый канал для всех исходящих соединений.

Коротко:

• Docker по умолчанию не использует прокси — его нужно явно настроить.
• Настройки зависят от способа запуска Docker: systemd (чаще на Linux) или Docker Desktop (Windows/macOS).
• На личном VPS SANSARA вы получаете выделенный узел, где можно безопасно менять системные настройки.
• Telegram-бот SANSARA помогает быстро получить доступ к серверу и проверить, что прокси работает.
• После настройки все запросы Docker (образы, реестры) идут через указанный шлюз.

Что это и кому подходит

Настройка прокси для Docker означает, что все сетевые запросы Docker (скачивание образов, обращение к реестрам) будут проходить через промежуточный сервер — прокси или шлюз. Это нужно, если:

• сеть вашего провайдера блокирует или ограничивает доступ к Docker Hub и другим реестрам;
• корпоративная политика требует выхода в интернет только через прокси;
• вы хотите добавить дополнительный уровень контроля и логирования трафика Docker.

Настройка особенно удобна на личном VPS SANSARA: у вас выделенный узел, где можно менять системные конфиги без риска помешать другим пользователям.

Как настроить по шагам (с личным VPS SANSARA)

Ниже — универсальные шаги для Linux-сервера, который вы получаете в SANSARA. Если вы не хотите работать в терминале, используйте Telegram-бота SANSARA для подключения к серверу и передачи команд.

Шаг 1. Подключитесь к своему личному VPS

После регистрации в SANSARA вы получаете данные для доступа к личному VPS в кабинете. Импортируйте их в свой клиент (например, SSH-клиент на ПК или через Telegram-бота SANSARA на телефоне) и подключитесь к серверу.

Шаг 2. Определите, как запущен Docker

Проверьте, используется ли systemd для управления Docker:

`bash sudo systemctl status docker `

Если Docker управляется через systemd (обычно так), настройки прокси задаются через systemd-юнит. Если Docker Desktop (Windows/macOS) — через графический интерфейс или конфиг Docker.

Шаг 3. Настройте прокси для Docker (systemd, Linux)

1. 01Создайте или отредактируйте сервисный файл для Docker:

`bash sudo mkdir -p /etc/systemd/system/docker.service.d sudo nano /etc/systemd/system/docker.service.d/http-proxy.conf `

1. 01Добавьте конфигурацию прокси. Пример для HTTP и HTTPS прокси:

`ini [Service] Environment="HTTP_PROXY=http://proxy.example.com:3128" Environment="HTTPS_PROXY=http://proxy.example.com:3128" Environment="NO_PROXY=localhost,127.0.0.1,::1,.internal" `

Замените proxy.example.com:3128 на адрес вашего прокси-сервера. NO_PROXY задаёт исключения — адреса, которые должны обходиться без прокси.

1. 01Перезагрузите конфигурацию и перезапустите Docker:

`bash sudo systemctl daemon-reload sudo systemctl restart docker `

1. 01Проверьте, что переменные применились:

`bash sudo systemctl show --property=Environment docker `

В выводе должны быть видны HTTP_PROXY и HTTPS_PROXY.

Шаг 4. Альтернатива: настройка через Docker config

Если вы не хотите трогать systemd, можно задать прокси в конфиге Docker:

`bash mkdir -p ~/.docker nano ~/.docker/config.json `

Добавьте или дополните файл:

`json { "proxies": { "default": { "httpProxy": "http://proxy.example.com:3128", "httpsProxy": "http://proxy.example.com:3128", "noProxy": "localhost,127.0.0.1,::1,.internal" } } } `

После этого перезапустите Docker Desktop или демон Docker.

Шаг 5. Проверьте работу прокси

Запустите тестовый образ:

`bash docker pull hello-world docker run hello-world `

Если прокси настроен правильно, образ скачается через указанный шлюз. В логах прокси-сервера вы увидите соответствующие запросы.

Устройства: iPhone, Android, Windows, macOS

Настройка Docker через прокси на самом деле происходит на стороне сервера — вашего личного VPS SANSARA. Клиентские устройства (телефон или компьютер) только подключаются к этому серверу.

• Windows / macOS: используйте Docker Desktop. Прокси для Docker можно задать в настройках (вкладка «Resources» → «Proxies») или через ~/.docker/config.json, как описано выше.
• iPhone / Android: напрямую Docker на мобильных устройствах обычно не запускают. Вы управляете Docker на своём VPS через SSH-клиент или Telegram-бота SANSARA. Сам туннель и прокси работают на сервере, а телефон лишь получает доступ к приложениям, которые работают в контейнерах.

Telegram-бот SANSARA упрощает это: вы можете отправлять команды на сервер прямо из мессенджера, не открывая отдельный терминал.

Частые ошибки и как их избежать

Ошибка 1. Прокси не применяется к Docker

• Причина: Docker может игнорировать глобальные переменные окружения, если не настроен через systemd или конфиг.
• Решение: убедитесь, что вы редактируете systemd-юнит Docker или ~/.docker/config.json, а не только экспортируете переменные в сессии.

Ошибка 2. Docker не может скачать образы через прокси

• Причина: неправильный формат адреса прокси, блокировка порта или неверные исключения в NO_PROXY.
• Решение: проверьте, что прокси доступен с вашего VPS (curl -x http://proxy:port http://ifconfig.me). Убедитесь, что в NO_PROXY не попали нужные внешние адреса.

Ошибка 3. Прокси ломает локальные подключения

• Причина: если NO_PROXY не настроен, Docker может пытаться идти через прокси даже к localhost и внутренним адресам.
• Решение: всегда указывайте localhost,127.0.0.1,::1 и внутренние домены в NO_PROXY.

Ошибка 4. Настройки не применяются после перезапуска

• Причина: забыли выполнить systemctl daemon-reload или перезапустить Docker.
• Решение: после изменения systemd-юнита всегда делайте daemon-reload и restart docker.

FAQ

Итог

• Настройте прокси для Docker через systemd-юнит или ~/.docker/config.json на вашем личном VPS SANSARA.
• Всегда указывайте NO_PROXY для localhost и внутренних адресов, чтобы не сломать локальные подключения.
• Используйте Telegram-бота SANSARA для быстрого доступа к серверу и проверки, что прокси работает.
• После изменения конфигов не забывайте перезагружать демон Docker.
• Проверяйте работу через docker pull и логи прокси-сервера.